Armada uses a Kubernetes watch to implement its chart wait logic. This can be a fairly long-lived connection to the Kubernetes API server, and is vulnerable to disruption (if, for example, the kubernetes apiserver chart is being upgraded). This change allows Armada to retry the wait for some specific errors, including the establishment of a new watch, until the overall chart timeout is reached. https://github.com/kubernetes-client/python/issues/972 urllib3.exceptions.ProtocolError: ('Connection broken: IncompleteRead(0 bytes read)', IncompleteRead(0 bytes read)) Change-Id: I3e68a54becadd5b2a2343960a120bdc3de8e8515
|1 month ago|
|.github||2 months ago|
|armada||1 month ago|
|charts||1 month ago|
|doc||2 months ago|
|etc/armada||1 year ago|
|examples||9 months ago|
|hapi||5 months ago|
|images/armada||9 months ago|
|manifests||2 months ago|
|releasenotes||2 years ago|
|swagger||8 months ago|
|tools||2 months ago|
|.coveragerc||2 years ago|
|.dockerignore||1 year ago|
|.editorconfig||2 years ago|
|.gitignore||1 year ago|
|.gitreview||1 year ago|
|.readthedocs.yaml||9 months ago|
|.stestr.conf||2 years ago|
|.style.yapf||10 months ago|
|.zuul.yaml||2 months ago|
|CONTRIBUTING.rst||2 years ago|
|LICENSE||3 years ago|
|Makefile||9 months ago|
|README.rst||9 months ago|
|controller.sh||1 year ago|
|entrypoint.sh||7 months ago|
|plugin.yaml||2 years ago|
|requirements.txt||1 month ago|
|setup.cfg||1 year ago|
|setup.py||1 year ago|
|test-requirements.txt||10 months ago|
|tox.ini||10 months ago|
Armada is a tool for managing multiple Helm charts with dependencies by centralizing all configurations in a single Armada YAML and providing life-cycle hooks for all Helm releases.
Find more documentation for Armada on Read The Docs.
The Armada Python library and command line tool provide a way to synchronize a Helm (Tiller) target with an operator's intended state, consisting of several charts, dependencies, and overrides using a single file or directory with a collection of files. This allows operators to define many charts, potentially with different namespaces for those releases, and their overrides in a central place. With a single command, deploy and/or upgrade them where applicable.
Armada also supports fetching Helm chart source and then building charts from source from various local and remote locations, such as Git endpoints, tarballs or local directories.
It will also give the operator some indication of what is about to change by assisting with diffs for both values, values overrides, and actual template changes.
Its functionality extends beyond Helm, assisting in interacting with Kubernetes directly to perform basic pre- and post-steps, such as removing completed or failed jobs, running backup jobs, blocking on chart readiness, or deleting resources that do not support upgrades. However, primarily, it is an interface to support orchestrating Helm.
Armada consists of two separate but complementary components:
Armada can be most easily installed as a container, which requires Docker to be executed. To install Docker, please reference the following install guide.
Afterward, you can launch the Armada container by executing:
For a comprehensive manual installation guide, please see Manual Install Guide.
To run Armada, simply supply it with your YAML-based intention for any number of charts:
$ armada apply examples/openstack-helm.yaml [ --debug ]
Which should output something like this:
$ armada apply examples/openstack-helm.yaml 2017-02-10 09:42:36,753 armada INFO Cloning git: ...
For more information on how to install and use Armada, please reference: Armada Quickstart.
Armada CLI component has the following integration points:
In addition, Armada's API component has the following integration points:
- Keystone (OpenStack's identity service) provides authentication and support for role-based authorization.