A python REST orchestrator to translate a YAML host topology to a provisioned set of hosts and provide a set of post-provisioning instructions.
See full documentation at https://airship-drydock.readthedocs.io/.
This service is intended to be built as a Docker container, not as a standalone Python package. That being said, instructions are included below for building as a package and as an image.
To build and install Drydock locally in a virtualenv first generate configuration and policy file templates to be customized
$ tox -e genconfig $ tox -e genpolicy $ virtualenv -p python3.5 /var/tmp/drydock $ . /var/tmp/drydock/bin/activate $ pip install -r requirements-lock.txt $ pip install . $ cp -r etc/drydock /etc/drydock
$ docker build . -t drydock
The preferred deployment pattern of Drydock is via a Helm chart to deploy Drydock into a Kubernetes cluster. Additionally use of the rest of the Airship services provides additional functionality for deploying (Armada) and using (Promenade, Deckhand) Drydock.
You can see an example of a full Airship deployment in the Airship in a Bottle repository.
Use the Airship Promenade tool for starting a self-hosted Kubernetes cluster with Kubernetes Helm deployed.
There are Helm charts for deploying all the dependencies of Dryodck. Use them for preparing your Kuberentes cluster to host Drydock.
Ideally you will use the Airship Armada
tool for deploying the Drydock chart with proper overrides, but if not you can
helm CLI tool. The below are overrides needed during deployment