3.2 KiB

Raw Blame History

Armada

Armada is a tool for managing multiple Helm charts with dependencies by centralizing all configurations in a single Armada YAML and providing lifecycle hooks for all Helm releases.

Armada consists of two separate but complementary components:

CLI component (mandatory) which interfaces directly with Tiller.
API component (optional) which services user requests through a wsgi server (which in turn communicates with the Tiller server) and provides the following additional functionality:
- Role-Based Access Control.
- Limiting projects to specific Tiller functionality by leveraging project-scoping provided by Keystone.

Roadmap

Detailed roadmap can be viewed here.

Issues can be reported on GitHub.

Installation

Quick Start (via Container)

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:

$ sudo docker run -d --net host -p 8000:8000 --name armada \
    -v ~/.kube/config:/armada/.kube/config \
    -v $(pwd)/examples/:/examples quay.io/attcomdev/armada:latest

Manual Installation

For a comprehensive manual installation guide, please see dev-getting-started.

Usage

To run Armada, simply supply it with your YAML-based intention for any number of charts:

$ armada apply examples/openstack-helm.yaml [--debug-loggging ]

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: guide-use-armada.

Integration Points

Armada CLI component has the following integration points:

Tiller manages Armada chart installations.

Deckhand supplies storage and management of site designs and secrets.

In addition, Armada's API component has the following integration points:

Keystone (OpenStack's identity service) provides authentication and support for role-based authorization.

3.2 KiB Raw Blame History