37 lines
1.8 KiB
Markdown
37 lines
1.8 KiB
Markdown
This project will discover and provide inventory intelligence to Sora, Shadowfeed, Geth, and Sharingan. It is named after the fictional Star Wars Imperial Intelligence organization that oversaw the various divisions of Intelligence and orchestrated their operations.
|
|
|
|
*Note*: This project is in progress -- former Makefiles from [ConfigPackages](/AniNIX/ConfigPackages) are being upgraded into Ansible playbooks here.
|
|
|
|
# How to use
|
|
|
|
This project expects that you use an Ansible vault for credentials. Create one and add this to your `.bashrc`.
|
|
```
|
|
export ANSIBLE_VAULT_PASSWORD_FILE=$HOME/password-store/${organization}.vault.password
|
|
export ANSIBLE_VAULT_FILE=$HOME/password-store/${organization}.vault
|
|
```
|
|
|
|
Take a look at `examples/msn0.yml` as an example inventory -- make sure you populate one of your own.
|
|
|
|
Once you have your vault and inventory, use [AniNIX/ShadowArch](/AniNIX/ShadowArch) with your hypervisor to provision the base image for your machines, or [Raspbian](https://www.raspberrypi.org/).
|
|
|
|
Then, use the SSHkey playbook to copy your key and the deploy playbook to set things up.
|
|
```
|
|
ansible-playbook -i your-inventory.yml playbooks/sshkey.yml
|
|
ansible-playbook -i your-inventory.yml playbooks/deploy.yml
|
|
```
|
|
|
|
For convenience, we recommend adding the following alias to your .bashrc or .bashrc.local.
|
|
```
|
|
alias deploy="cd ~/src/Ubiqtorate; ansible-playbook -i examples/msn0.yml playbooks/deploy.yml; cd -"
|
|
```
|
|
|
|
Happy hacking!
|
|
|
|
# Exceptions
|
|
|
|
Some services, such as AniNIX/Sharingan and AniNIX/Geth, store their configuration in internal datastructures and databases such that we cannot easily export our build for others to use. We will document what we have done for each of these as best we can in the README.md files for others to replicate. Backups of these services into AniNIX/Aether are therefore dumps of these databases and not available to share.
|
|
|
|
|
|
|
|
|