shipyard/doc/source/deployment-guide.rst
Bryan Strassner 6b75c7119a Move airflow scheduler to worker statefulset
Moves the airflow sceduler to a container in the airflow-worker
statefulset so that its version lifecycle matches that of the worker.
Leaves the stand-alone scheduler in place to support upgradability from
prior installations that included a standalone scheduler. New
installations are advised to turn off the scheduler template from
rendering using the values.yaml flag.

This is an attempt to make disruptive upgrades to airflow less impactful
to a "update_site" action from Shipyard.

Additionally this removes the template for airflow-flower, which is not in use.

Change-Id: I0608793ee6aba1eb3ce0f5e9567655287014a0ca
2019-01-29 09:41:16 -06:00

78 lines
3.7 KiB
ReStructuredText

..
Copyright 2017 AT&T Intellectual Property.
All Rights Reserved.
Licensed under the Apache License, Version 2.0 (the "License"); you may
not use this file except in compliance with the License. You may obtain
a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
License for the specific language governing permissions and limitations
under the License.
.. _shipyard_deployment_guide:
Deployment Guide
================
.. note::
Shipyard is still under active development and this guide will evolve along
the way
Deployment
----------
The current deployment makes use of the `airship-in-a-bottle`_ project to
set up the underlaying Kubernetes infrastructure, container networking
(Calico), disk provisioner (Ceph or NFS), and Airship components that are used
by Shipyard.
The `dev_minimal`_ manifest is the recommended manifest. Please see the
README.txt that exists in that manifest's directory.
This approach sets up an 'All-In-One' Airship environment that allows
developers to bring up Shipyard and the rest of the Airship components on a
single Ubuntu Virtual Machine.
The deployment is fully automated and can take a while to complete. It can take
30 minutes to an hour or more for a full deployment to complete.
Post Deployment
---------------
#. The environment should include the following after executing the required
steps::
# sudo kubectl get pods -n ucp | grep -v Completed
NAME READY STATUS RESTARTS AGE
airflow-scheduler-79754bfdd5-2wpxn 1/1 Running 0 4m
airflow-web-7679866685-g99qm 1/1 Running 0 4m
airflow-worker-0 3/3 Running 0 4m
airship-ucp-keystone-memcached-mem... 1/1 Running 0 31m
airship-ucp-rabbitmq-rabbitmq-0 1/1 Running 0 35m
armada-api-5488cbdb99-zjb8n 1/1 Running 0 12m
barbican-api-5fc8f7d6f-s7h7j 1/1 Running 0 11m
deckhand-api-7b476d6c46-qlvtm 1/1 Running 0 8m
drydock-api-5f9fdc858d-lnxvj 1/1 Running 0 1m
ingress-6cd5b89d5d-hzfzj 1/1 Running 0 35m
ingress-error-pages-5c97bb46bb-zqqbx 1/1 Running 0 35m
keystone-api-7657986b8c-6bf92 1/1 Running 0 31m
maas-ingress-66447d7445-mgklj 2/2 Running 0 27m
maas-ingress-errors-8686d56d98-vrjzg 1/1 Running 0 27m
maas-rack-0 1/1 Running 0 27m
maas-region-0 2/2 Running 0 27m
mariadb-ingress-6c4f9c76f-lk9ff 1/1 Running 0 35m
mariadb-ingress-6c4f9c76f-ns5kj 1/1 Running 0 35m
mariadb-ingress-error-pages-5dd6fb... 1/1 Running 0 35m
mariadb-server-0 1/1 Running 0 35m
postgresql-0 1/1 Running 0 32m
promenade-api-764b765d77-ffhv4 1/1 Running 0 7m
shipyard-api-69888d9f68-8ljfk 1/1 Running 0 4m
.. _airship-in-a-bottle: https://git.airshipit.org/cgit/airship-in-a-bottle
.. _dev_minimal: https://git.airshipit.org/cgit/airship-in-a-bottle/tree/manifests/dev_minimal