airship/armada
Code Issues Proposed changes
8306c770c1
armada/docs/source/commands/apply.rst
Felipe Monteiro 950c6012ab Fix chartbuilder get_files raising UnicodeDecodeError 
This adds better exception handling ang logging to
_append_file_to_result helper in get_files. When reading
arbitrary file data and attempting to encode to utf-8
this can cause UnicodeDecodeError to be raised.

However, Armada will not skip over such files; it will
raise an exception with appropriate details instead.

Closes #195
Closes #196

Change-Id: Id7c32c17e351d1ffe042e3755c116c36b6380223
2018-03-22 17:13:58 -05:00

3.1 KiB
Raw Blame History

Armada - Apply

Commands

Usage: armada apply [OPTIONS] FILENAME

  This command installs and updates charts defined in armada manifest

  The apply argument must be relative path to Armada Manifest. Executing
  apply command once will install all charts defined in manifest. Re-
  executing apply command will execute upgrade.

  To see how to create an Armada manifest:
  http://armada-helm.readthedocs.io/en/latest/operations/

  To install or upgrade charts, run:

      $ armada apply examples/simple.yaml

  To override a specific value in a Manifest, run:

      $ armada apply examples/simple.yaml --set manifest:simple-armada:release_name="wordpress"

  Or to override several values in a Manifest, reference a values.yaml-
  formatted file:

      $ armada apply examples/simple.yaml --values examples/simple-ovr-values.yaml

Options:
  --api                         Contacts service endpoint.
  --disable-update-post         Disable post-update Tiller operations.
  --disable-update-pre          Disable pre-update Tiller operations.
  --dry-run                     Run charts without installing them.
  --enable-chart-cleanup        Clean up unmanaged charts.
  --set TEXT                    Use to override Armada Manifest values.
                                Accepts overrides that adhere to the format
                                <path>:<to>:<property>=<value> to specify a
                                primitive or
                                <path>:<to>:<property>=<value1>,...,<valueN>
                                to specify a list of values.
  --tiller-host TEXT            Tiller host IP.
  --tiller-port INTEGER         Tiller host port.
  -tn, --tiller-namespace TEXT  Tiller namespace.
  --timeout INTEGER             Specifies time to wait for charts to deploy.
  -f, --values TEXT             Use to override multiple Armada Manifest
                                values by reading overrides from a
                                values.yaml-type file.
  --wait                        Wait until all charts deployed.
  --target-manifest TEXT        The target manifest to run. Required for
                                specifying which manifest to run when multiple
                                are available.
  --debug                       Enable debug logging.
  --help                        Show this message and exit.

Synopsis

The apply command will consume an armada manifest which contains group of charts that it will deploy into the tiller service in your Kubernetes cluster. Executing the armada apply again on existing armada deployment will start an update of the armada deployed charts.

armada apply armada-manifest.yaml [--debug]

If you remove armada/Charts/v1 from the armada/ChartGroups/v1 in the armada manifest and execute an armada apply with the --enable-chart-cleanup flag. Armada will remove undefined releases with the armada manifest's release_prefix keyword.