Update README.md

This commit is contained in:
Sam A. 2022-11-26 16:32:06 +01:00
parent 5945d6847f
commit 4611d890f7
Signed by untrusted user: samsapti
GPG key ID: CBBBE7371E81C4EA

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.