README.MD

nctu-hw playbook

A short description of the project

How to use

Creating venv (optional but highly recommended)

The easiest way to ensure you have the right ansible and properly libs installed is to use pipx. You only have to set it up once:

    python3 -m pip install pipx
    pipx install ansible

Running playbook locally

1. Run ansible-galaxy install -r roles/requirements.yml -p roles in this directory to get the required Ansible roles.
2. Run ansible-playbook -c local -i inventory/inventory.ini nctu-hw-playbook.yml

Running playbook on remote target server from local machine

1. Run ansible-galaxy install -r roles/requirements.yml -p roles in this directory to get the required Ansible roles.
2. Run ansible-playbook -i inventory/<inventory_file> --key-file "~/.ssh/<private_key>" -u <user-remote> nctu-hw-playbook.yml

Running playbook in dry mode (check)

1. Run ansible-galaxy install -r roles/requirements.yml -p roles in this directory to get the required Ansible roles.
2. Run ansible-playbook -i inventory/<inventory_file> --key-file "~/.ssh/<private_key>" -u <user-remote> nctu-hw-playbook.yml --diff --check

Provisioning with Vagrant

1. Download and install VirtualBox.
2. Download and install Vagrant.
3. Create Virtual environment
4. Run ansible-galaxy install -r roles/requirements.yml -p roles in this directory to get the required Ansible roles.
5. Run vagrant up from provisioner folder to build the VM .
6. Run vagrant destroy from provisioner folder to delete the VM .

License

MIT license

Author

ChihChia_Wang

Version

Release date: 2021-07-05 Version: 0.1.0