data.coop
/
ansible
8
3
Fork 7
Code Issues 44 Pull Requests 7 Projects 1 Releases Wiki Activity

Add README.md #127

Merged
benjaoming merged 13 commits from readme into main 2022-11-29 13:58:39 +00:00
Conversation 2 Commits 13 Files Changed 1 +20 -7
1 changed files with 20 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files
Showing only changes of commit 4611d890f7 - Show all commits

27
README.md
View File

@ -13,17 +13,17 @@ The script has options to deploy only one of the roles, which are namely
services themselves using Docker containers. Select services only can
also be specified. By default, the script deploys everything.
Here is a summary of the options that can be used:
Here is a summary of the options that can be used with the script:
```console
$ ./deploy.sh # deploy everything
$ ./deploy.sh base # deploy the ubuntu_base role only
$ ./deploy.sh services # deploy the docker role only
$ ./deploy.sh services SERVICE # deploy SERVICE only
$ ./deploy.sh # deploy everything
$ ./deploy.sh base # deploy the ubuntu_base role only
$ ./deploy.sh services # deploy the docker role only
$ ./deploy.sh services SINGLE_SERVICE # deploy SINGLE_SERVICE Docker service only
```
`SERVICE` should match one of the filenames in
`roles/docker/tasks/services/`, but without the `.yml` extension
`SINGLE_SERVICE` should match one of the filenames in
`roles/docker/tasks/services/`, but without the `.yml` extension.
## Testing
@ -49,3 +49,16 @@ $ vagrant halt # Power down the VM
$ vagrant destroy # Power down and delete the VM
```
The `vagrant` command-line tool does not support supplying extra
variables to Ansible on runtime, so to be able to deploy only parts of
the Ansible playbook to Vagrant, the `deploy.sh` script can be used with
the `--vagrant` flag. Here are some examples:
```console
$ ./deploy.sh --vagrant base # deploy the ubuntu_base role only in the Vagrant VM
$ ./deploy.sh --vagrant services SINGLE_SERVICE # deploy SINGLE_SERVICE Docker service only in the Vagrant VM
```
Note that the `--vagrant` flag should be the first argument when using
the script.