Add README.md #127
51
README.md
51
README.md
|
@ -19,11 +19,18 @@ only can also be specified. By default, the script deploys everything.
|
|||
|
||||
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 SINGLE_SERVICE # deploy SINGLE_SERVICE Docker service only
|
||||
```sh
|
||||
# deploy everything
|
||||
samsapti marked this conversation as resolved
Outdated
|
||||
./deploy.sh
|
||||
|
||||
# deploy the ubuntu_base role only
|
||||
./deploy.sh base
|
||||
|
||||
# deploy the docker role only
|
||||
./deploy.sh services
|
||||
|
||||
# deploy SINGLE_SERVICE Docker service only
|
||||
./deploy.sh services SINGLE_SERVICE
|
||||
```
|
||||
|
||||
`SINGLE_SERVICE` should match one of the service names in the `services`
|
||||
|
@ -46,12 +53,21 @@ this to work properly.
|
|||
Here is a summary of the commands that are available with the `vagrant`
|
||||
command-line tool:
|
||||
|
||||
```console
|
||||
$ vagrant up # Create and provision the VM
|
||||
$ vagrant provision # Re-provision the VM
|
||||
$ vagrant ssh # SSH into the VM
|
||||
$ vagrant halt # Power down the VM
|
||||
$ vagrant destroy # Power down and delete the VM
|
||||
```sh
|
||||
# Create and provision the VM
|
||||
vagrant up
|
||||
|
||||
# Re-provision the VM
|
||||
vagrant provision
|
||||
|
||||
# SSH into the VM
|
||||
vagrant ssh
|
||||
|
||||
# Power down the VM
|
||||
vagrant halt
|
||||
|
||||
# Power down and delete the VM
|
||||
vagrant destroy
|
||||
```
|
||||
|
||||
The `vagrant` command-line tool does not support supplying extra
|
||||
|
@ -59,9 +75,12 @@ 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
|
||||
```sh
|
||||
# deploy the ubuntu_base role only in the Vagrant VM
|
||||
./deploy.sh --vagrant base
|
||||
|
||||
# deploy SINGLE_SERVICE Docker service only in the Vagrant VM
|
||||
./deploy.sh --vagrant services SINGLE_SERVICE
|
||||
```
|
||||
|
||||
Note that the `--vagrant` flag should be the first argument when using
|
||||
|
@ -75,8 +94,8 @@ every commit, so please use that. To initialize pre-commit, you need to
|
|||
have Python and GNU make installed. Then, just run the following shell
|
||||
command:
|
||||
|
||||
```console
|
||||
$ make init
|
||||
```sh
|
||||
make init
|
||||
```
|
||||
|
||||
## Nice tools
|
||||
|
|
Loading…
Reference in a new issue
Just for better rendering: can we put comments on the preceding line and have a newline between each comman e?
Done 👍