Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/att-comdev/armada

This project has moved to OpenStack.
https://github.com/att-comdev/armada

helm kubernetes python

Last synced: 27 days ago
JSON representation

This project has moved to OpenStack.

Host: GitHub
URL: https://github.com/att-comdev/armada
Owner: att-comdev
License: apache-2.0
Archived: true
Created: 2017-02-08T00:14:49.000Z (almost 8 years ago)
Default Branch: master
Last Pushed: 2018-07-06T04:16:08.000Z (over 6 years ago)
Last Synced: 2024-08-04T04:06:07.996Z (4 months ago)
Topics: helm, kubernetes, python
Language: Python
Homepage: https://www.airshipit.org/
Size: 1.61 MB
Stars: 78
Watchers: 36
Forks: 35
Open Issues: 32
Metadata Files:
- Readme: README.rst
- Contributing: CONTRIBUTING.rst
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.rst

Awesome Lists containing this project

awesome-cloud-native - armada - A python orchestrator for a installing, upgrading, and managing a collection of helm charts, dependencies, and values overrides. (Application Delivery)

README

Armada
======

|Docker Repository on Quay| |Doc Status|

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 `_.

Overview
--------

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.

Components
----------

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:

.. code-block:: bash

$ 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 `Manual Install Guide`_.

Usage
^^^^^

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`_.

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.