Sha256: 56a7fe58df8990d0a9a5236d3fdd3a4e64a541bca8ee77cda2d18813229c8d0c

Contents?: true

Size: 1.6 KB

Versions: 10

Compression:

Stored size: 1.6 KB

Contents

---
title: ufo task
reference: true
---

## Usage

    ufo task TASK_DEFINITION

## Description

Run a one-time task.

## Examples

You can use the `--command` or `-c` option to override the Docker container command.

    ufo task hi-migrate # default command
    ufo task demo-web --command bin/migrate
    ufo task demo-web --command bin/with_env bundle exec rake db:migrate:redo VERSION=xxx
    ufo task demo-web -c uptime
    ufo task demo-web -c pwd

## Skipping Docker and Task Registration

The `--task-only` option is useful. By default, the `ufo task` command will build the docker image and then register a new task definition.  The docker build process usually is the part that takes the most time. You can skip the docker build process after building it at least once.  This is a faster way to run a bunch of commands with the same Docker image. Example:

    ufo task demo-web -c uptime # build at least once
    ufo task demo-web --task-only -c ls # skip docker for speed
    ufo task demo-web --task-only -c pwd # skip docker for speed


## Options

```
    [--task-only], [--no-task-only]  # Skip docker and task register steps. Only run the task.
w, [--wait], [--no-wait]             # Wait for task to finish.
t, [--timeout=N]                     # How long to wait for task to finish.
                                     # Default: 600
c, [--command=one two three]         # Override the command used for the container
    [--verbose], [--no-verbose]      
    [--mute], [--no-mute]            
    [--noop], [--no-noop]            
    [--cluster=CLUSTER]              # Cluster.  Overrides .ufo/settings.yml.
```

Version data entries

10 entries across 10 versions & 1 rubygems

Version Path
ufo-4.4.3 docs/_reference/ufo-task.md
ufo-4.4.2 docs/_reference/ufo-task.md
ufo-4.4.1 docs/_reference/ufo-task.md
ufo-4.4.0 docs/_reference/ufo-task.md
ufo-4.3.1 docs/_reference/ufo-task.md
ufo-4.3.0 docs/_reference/ufo-task.md
ufo-4.2.0 docs/_reference/ufo-task.md
ufo-4.1.10 docs/_reference/ufo-task.md
ufo-4.1.9 docs/_reference/ufo-task.md
ufo-4.1.8 docs/_reference/ufo-task.md