From 705f7ad7d2b77b1f3051d44d38b8041cb360cbc5 Mon Sep 17 00:00:00 2001 From: Vincent Demeester Date: Tue, 7 Feb 2017 15:14:38 +0100 Subject: [PATCH] Update docker stack experimental notes Update command usage and help. Signed-off-by: Vincent Demeester --- experimental/docker-stacks-and-bundles.md | 25 +++++++++++++---------- 1 file changed, 14 insertions(+), 11 deletions(-) diff --git a/experimental/docker-stacks-and-bundles.md b/experimental/docker-stacks-and-bundles.md index 573c1bc5..8abfd763 100644 --- a/experimental/docker-stacks-and-bundles.md +++ b/experimental/docker-stacks-and-bundles.md @@ -37,22 +37,26 @@ Wrote bundle to vossibility-stack.dab A stack is created using the `docker deploy` command: ```bash -# docker deploy --help - +$ docker deploy --help Usage: docker deploy [OPTIONS] STACK -Create and update a stack from a Distributed Application Bundle (DAB) +Deploy a new stack or update an existing stack + +Aliases: + deploy, up Options: - --file string Path to a Distributed Application Bundle file (Default: STACK.dab) - --help Print usage - --with-registry-auth Send registry authentication details to Swarm agents + --bundle-file string Path to a Distributed Application Bundle file + -c, --compose-file string Path to a Compose file + --help Print usage + --with-registry-auth Send registry authentication details to Swarm agents + ``` Let's deploy the stack created before: ```bash -# docker deploy vossibility-stack +$ docker deploy --bundle-file vossibility-stack.dab vossibility-stack Loading bundle from vossibility-stack.dab Creating service vossibility-stack_elasticsearch Creating service vossibility-stack_kibana @@ -90,12 +94,11 @@ Options: --help Print usage Commands: - config Print the stack configuration - deploy Create and update a stack + deploy Deploy a new stack or update an existing stack ls List stacks + ps List the tasks in the stack rm Remove the stack services List the services in the stack - tasks List the tasks in the stack Run 'docker stack COMMAND --help' for more information on a command. ``` @@ -107,7 +110,7 @@ are persisted as files, the file extension is `.dab` (Docker 1.12RC2 tools use `.dsb` for the file extension—this will be updated in the next release client). A bundle has two top-level fields: `version` and `services`. The version used -by Docker 1.12 tools is `0.1`. +by Docker 1.12 and later tools is `0.1`. `services` in the bundle are the services that comprise the app. They correspond to the new `Service` object introduced in the 1.12 Docker Engine API.