|
|
@@ -1,6 +1,6 @@
|
|
|
---
|
|
|
layout: default
|
|
|
-title: Fig CLI reference
|
|
|
+title: Compose CLI reference
|
|
|
---
|
|
|
|
|
|
CLI reference
|
|
|
@@ -8,7 +8,7 @@ CLI reference
|
|
|
|
|
|
Most commands are run against one or more services. If the service is omitted, it will apply to all services.
|
|
|
|
|
|
-Run `fig [COMMAND] --help` for full usage.
|
|
|
+Run `docker-compose [COMMAND] --help` for full usage.
|
|
|
|
|
|
## Options
|
|
|
|
|
|
@@ -22,7 +22,7 @@ Run `fig [COMMAND] --help` for full usage.
|
|
|
|
|
|
### -f, --file FILE
|
|
|
|
|
|
- Specify an alternate fig file (default: fig.yml)
|
|
|
+ Specify an alternate docker-compose file (default: docker-compose.yml)
|
|
|
|
|
|
### -p, --project-name NAME
|
|
|
|
|
|
@@ -34,7 +34,7 @@ Run `fig [COMMAND] --help` for full usage.
|
|
|
|
|
|
Build or rebuild services.
|
|
|
|
|
|
-Services are built once and then tagged as `project_service`, e.g. `figtest_db`. If you change a service's `Dockerfile` or the contents of its build directory, you can run `fig build` to rebuild it.
|
|
|
+Services are built once and then tagged as `project_service`, e.g. `docker-composetest_db`. If you change a service's `Dockerfile` or the contents of its build directory, you can run `docker-compose build` to rebuild it.
|
|
|
|
|
|
### help
|
|
|
|
|
|
@@ -44,7 +44,7 @@ Get help on a command.
|
|
|
|
|
|
Force stop running containers by sending a `SIGKILL` signal. Optionally the signal can be passed, for example:
|
|
|
|
|
|
- $ fig kill -s SIGINT
|
|
|
+ $ docker-compose kill -s SIGINT
|
|
|
|
|
|
### logs
|
|
|
|
|
|
@@ -73,22 +73,22 @@ Run a one-off command on a service.
|
|
|
|
|
|
For example:
|
|
|
|
|
|
- $ fig run web python manage.py shell
|
|
|
+ $ docker-compose run web python manage.py shell
|
|
|
|
|
|
By default, linked services will be started, unless they are already running.
|
|
|
|
|
|
-One-off commands are started in new containers with the same config as a normal container for that service, so volumes, links, etc will all be created as expected. The only thing different to a normal container is the command will be overridden with the one specified and by default no ports will be created in case they collide.
|
|
|
+One-off commands are started in new containers with the same condocker-compose as a normal container for that service, so volumes, links, etc will all be created as expected. The only thing different to a normal container is the command will be overridden with the one specified and by default no ports will be created in case they collide.
|
|
|
|
|
|
Links are also created between one-off commands and the other containers for that service so you can do stuff like this:
|
|
|
|
|
|
- $ fig run db psql -h db -U docker
|
|
|
+ $ docker-compose run db psql -h db -U docker
|
|
|
|
|
|
If you do not want linked containers to be started when running the one-off command, specify the `--no-deps` flag:
|
|
|
|
|
|
- $ fig run --no-deps web python manage.py shell
|
|
|
+ $ docker-compose run --no-deps web python manage.py shell
|
|
|
|
|
|
If you want the service's ports to be created and mapped to the host, specify the `--service-ports` flag:
|
|
|
- $ fig run --service-ports web python manage.py shell
|
|
|
+ $ docker-compose run --service-ports web python manage.py shell
|
|
|
|
|
|
### scale
|
|
|
|
|
|
@@ -97,7 +97,7 @@ Set number of containers to run for a service.
|
|
|
Numbers are specified in the form `service=num` as arguments.
|
|
|
For example:
|
|
|
|
|
|
- $ fig scale web=2 worker=3
|
|
|
+ $ docker-compose scale web=2 worker=3
|
|
|
|
|
|
### start
|
|
|
|
|
|
@@ -105,7 +105,7 @@ Start existing containers for a service.
|
|
|
|
|
|
### stop
|
|
|
|
|
|
-Stop running containers without removing them. They can be started again with `fig start`.
|
|
|
+Stop running containers without removing them. They can be started again with `docker-compose start`.
|
|
|
|
|
|
### up
|
|
|
|
|
|
@@ -113,26 +113,26 @@ Build, (re)create, start and attach to containers for a service.
|
|
|
|
|
|
Linked services will be started, unless they are already running.
|
|
|
|
|
|
-By default, `fig up` will aggregate the output of each container, and when it exits, all containers will be stopped. If you run `fig up -d`, it'll start the containers in the background and leave them running.
|
|
|
+By default, `docker-compose up` will aggregate the output of each container, and when it exits, all containers will be stopped. If you run `docker-compose up -d`, it'll start the containers in the background and leave them running.
|
|
|
|
|
|
-By default if there are existing containers for a service, `fig up` will stop and recreate them (preserving mounted volumes with [volumes-from]), so that changes in `fig.yml` are picked up. If you do no want containers to be stopped and recreated, use `fig up --no-recreate`. This will still start any stopped containers, if needed.
|
|
|
+By default if there are existing containers for a service, `docker-compose up` will stop and recreate them (preserving mounted volumes with [volumes-from]), so that changes in `docker-compose.yml` are picked up. If you do no want containers to be stopped and recreated, use `docker-compose up --no-recreate`. This will still start any stopped containers, if needed.
|
|
|
|
|
|
[volumes-from]: http://docs.docker.io/en/latest/use/working_with_volumes/
|
|
|
|
|
|
|
|
|
## Environment Variables
|
|
|
|
|
|
-Several environment variables can be used to configure Fig's behaviour.
|
|
|
+Several environment variables can be used to condocker-composeure Compose's behaviour.
|
|
|
|
|
|
-Variables starting with `DOCKER_` are the same as those used to configure the Docker command-line client. If you're using boot2docker, `$(boot2docker shellinit)` will set them to their correct values.
|
|
|
+Variables starting with `DOCKER_` are the same as those used to condocker-composeure the Docker command-line client. If you're using boot2docker, `$(boot2docker shellinit)` will set them to their correct values.
|
|
|
|
|
|
### FIG\_PROJECT\_NAME
|
|
|
|
|
|
-Set the project name, which is prepended to the name of every container started by Fig. Defaults to the `basename` of the current working directory.
|
|
|
+Set the project name, which is prepended to the name of every container started by Compose. Defaults to the `basename` of the current working directory.
|
|
|
|
|
|
### FIG\_FILE
|
|
|
|
|
|
-Set the path to the `fig.yml` to use. Defaults to `fig.yml` in the current working directory.
|
|
|
+Set the path to the `docker-compose.yml` to use. Defaults to `docker-compose.yml` in the current working directory.
|
|
|
|
|
|
### DOCKER\_HOST
|
|
|
|
|
|
@@ -144,4 +144,4 @@ When set to anything other than an empty string, enables TLS communication with
|
|
|
|
|
|
### DOCKER\_CERT\_PATH
|
|
|
|
|
|
-Configure the path to the `ca.pem`, `cert.pem` and `key.pem` files used for TLS verification. Defaults to `~/.docker`.
|
|
|
+Condocker-composeure the path to the `ca.pem`, `cert.pem` and `key.pem` files used for TLS verification. Defaults to `~/.docker`.
|