Contents

The `ufo ships` command allows you to deploy the *same* Docker image and task definition to multiple ECS services.  It is a common pattern to have the same code base running on different roles.  For example, say you have an application with 3 roles:

1. web - serves web requests.
2. worker - processes background jobs.
3. clock - schedules background jobs.

Instead of using the [ufo ship]({% link _reference/ufo-ship.md %}) and build and deploying the code 3 times you can instead use `ufo ships`.  This will result in the *same* Docker image and *same* task definition being deployed to all 3 services.  Example usage:

    ufo ships demo-web demo-worker demo-clock

## Shell expansion

Since the ECS service names are provided as a list you can shorten the command by using bash shell expansion 😁

    ufo ships hi-{web,worker,clock}

If you're new to shell expansion, run this to understand why above works just as well:

    $ echo hi-{web,worker,clock}
    demo-web demo-worker demo-clock

## Overriding convention

As explained in detail in [Conventions]({% link _docs/conventions.md %}) the task definition and service name are the same by convention.  This convention also applies for each of the services being shipped in the list. The task definition and service names match for each of the services in the list.  If you would like to override the convention as part of the ships command then you use a special syntax. In the special syntax the service and task definition is separated by a colon.  Examples:

    ufo ships demo-web-1:demo-web demo-clock-1 demo-worker-1
    ufo ships demo-web-1:my-task demo-clock-1:another-task demo-worker-1:third-task

## ufo ships Options

The `ufo ships`, `ufo ship`, `ufo deploy` command support the same options. The options are presented here again for convenience:

{% include ufo-ship-options.md %}

Note: The `--task` option is not used with the `ufo ships` command.

Version data entries

45 entries across 45 versions & 1 rubygems

Version	Path
ufo-4.1.0	lib/ufo/help/ships.md
ufo-4.0.3	lib/ufo/help/ships.md
ufo-4.0.2	lib/ufo/help/ships.md
ufo-4.0.1	lib/ufo/help/ships.md
ufo-4.0.0	lib/ufo/help/ships.md