A declarative host provisioning system.
選択できるのは25トピックまでです。 トピックは、先頭が英数字で、英数字とダッシュ('-')を使用した35文字以内のものにしてください。
Prateek Dodda 67716a7841 Add Docker default AppArmor profile to drydock 3週間前
alembic (format): yapf reformat 1年前
charts/drydock Add Docker default AppArmor profile to drydock 1週間前
doc Fix: Drydock Exceptions docs rendering on RTD 6ヶ月前
etc/drydock Add Redfish as OOB driver 1年前
go/src/baclient Bootaction client initial implementation 1年前
images/drydock Add support for ubuntu bionic base image 1ヶ月前
python Merge "Improve error logging during validation" 4ヶ月前
tools Add Docker default AppArmor profile to drydock 1週間前
.dockerignore Refactor build to include Go 1年前
.gitignore Refactor build to include Go 1年前
.gitreview OpenDev Migration Patch 10ヶ月前
.readthedocs.yaml Change RTD config to use Python requirements 5ヶ月前
.style.yapf Fix issues failing CI pipeline 2年前
.zuul.yaml Add Docker default AppArmor profile to drydock 1週間前
LICENSE Initial commit 3年前
Makefile Add support for ubuntu bionic base image 1ヶ月前
README.md Fix: various documentation and URL fixes 1年前
alembic.ini DRYD47 - Task persistance and refactor 2年前
entrypoint.sh uWSGI http-timeout option 2年前
hostdeps.sh Update image build script to run in a docker 1ヶ月前
requirements-host-test.txt (zuul) Improve image building 1年前
requirements-host.txt (fix) Use endpoint for MAAS URL 1年前
tox.ini Fix: Drydock Exceptions docs rendering on RTD 6ヶ月前

README.md

drydock_provisioner

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/.

Required

  • Python 3.5+
  • A running instance of Postgres v9.5+
  • A running instance of Openstack Keystone w/ the v3 API enabled
  • A running instance of Canonical MaaS v2.3+
  • A running Kubernetes cluster with Helm initialized
  • Familiarity with the Airship platform suite of services

Building

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.

Virtualenv

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 image

$ docker build . -t drydock

Running

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.

Stand up Kubernetes

Use the Airship Promenade tool for starting a self-hosted Kubernetes cluster with Kubernetes Helm deployed.

Deploy Drydock Dependencies

There are Helm charts for deploying all the dependencies of Dryodck. Use them for preparing your Kuberentes cluster to host Drydock.

Deploy Drydock

Ideally you will use the Airship Armada tool for deploying the Drydock chart with proper overrides, but if not you can use the helm CLI tool. The below are overrides needed during deployment

  • values.labels.node_selector_key: This is the kubernetes label assigned to the node you expect to host Drydock
  • values.conf.dryodck.maasdriver: This is URL Drydock will use to access the MAAS API (including the URL path)
  • values.images.drydock: The Drydock docker image to use
  • values.images.drydock_db_sync: The Drydock docker image to use