From 5eb38b5b4fc0d4187091b14bd740baee72a6002f Mon Sep 17 00:00:00 2001 From: Kumar Damani Date: Sat, 26 Mar 2022 15:06:27 -0400 Subject: simplified install process --- README.md | 39 +++++++++++++++++++-------------------- 1 file changed, 19 insertions(+), 20 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index 9bf9aff..7ef856b 100644 --- a/README.md +++ b/README.md @@ -45,38 +45,37 @@ You can get this dashboard [here](https://grafana.com/grafana/dashboards/15980). 3. Change directory to this repo `cd vps`. 4. Setup repo by running all of the following: ``` -python3 -m venv ~/venv/vps -source $HOME/venv/vps/bin/activate -pip install --upgrade pip -pip install 'ansible<2.10' 'jmespath' -ansible-galaxy install -r requirements.yml -ansible-galaxy collection install -r requirements.yml +make install +# copy all the example files cp -a vaultid.example vaultid cp -a hosts.example hosts cp -a group_vars/all/vault.example group_vars/all/vault ``` ## Develop -1. Modify the [playbooks](./playbooks/) per your needs. -2. Modify the vault per your needs: `ansible-vault edit group_vars/all/vault --vault-id vaultid`. -3. Modify the [hosts](./hosts/) file per your needs. -4. Modify the [vars](./group_vars/all/vars.yaml/) file per your needs. +1. Set your vaultid value to your password. Default: `test`. +2. Modify the [playbooks](./playbooks/) per your needs. +3. Modify the vault per your needs: `make vault-edit group=all`. +4. Modify the [hosts](./hosts/) file per your needs. +5. Modify the [vars](./group_vars/all/vars.yaml/) file per your needs. + +Encrypt your hosts file, and secret vars before uploading to git: +``` +ansible-vault encrypt --vault-id vaultid --output hosts.vault hosts +ansible-vault encrypt --vault-id vaultid --output group_vars/all/vault group_vars/all/vault +``` ## Deploy ``` -# activate venv -source $HOME/venv/vps/bin/activate # run main playbook with "base" tag -ansible-playbook -i hosts playbooks/deploy.yaml --vault-id vaultid --tags base +make file=playbooks/deploy.yaml tags="base" # run main playbook with your apps -ansible-playbook -i hosts playbooks/deploy.yaml --vault-id vaultid [--tags []] +make file=playbooks/deploy.yaml tags="[csv list]" # (and if applicable secondary playbook) -ansible-playbook -i hosts playbooks/vps.yaml --vault-id vaultid +make file=playbooks/vps.yaml ``` ## Future Plans -1. Install a Job executor (Awx, or Rundeck) that will auto-deploy hosted websites upon new commits using the `--tags website` arg. -2. Simplify install. -3. Documentation for each role. -4. Backups. -5. Redundancy. +1. Documentation for each role. +2. Backups. +3. Redundancy. -- cgit v1.2.3