openstack-helm/doc/source/install/developer/kubernetes-and-common-setup.rst
Tin Lam fdfca4b0fb Fix handful of trivial items in docs
This fixes up typographical errors, capitalization issues and minor
stylistic formatting in the documentations.

Change-Id: I1951a90d48cc22e7f8c0516fc53f4018ef0a9a5d
Signed-off-by: Tin Lam <tin@irrational.io>
2018-05-25 19:26:03 -05:00

3.1 KiB

Kubernetes and Common Setup

Packages

Install the latest versions of Git, CA Certs & Make if necessary

../../../../tools/deployment/developer/common/000-install-packages.sh

Clone the OpenStack-Helm Repos

Once the host has been configured the repos containing the OpenStack-Helm charts should be cloned:

#!/bin/bash
set -xe

git clone https://git.openstack.org/openstack/openstack-helm-infra.git
git clone https://git.openstack.org/openstack/openstack-helm.git

Note

This installation, by default will use Google DNS servers, 8.8.8.8 or 8.8.4.4 and updates resolv.conf. These DNS nameserver entries can be changed by updating file /opt/openstack-helm-infra/tools/images/kubeadm-aio/assets/opt/playbooks/vars.yaml under section external_dns_nameservers.

Deploy Kubernetes & Helm

You may now deploy kubernetes, and helm onto your machine, first move into the openstack-helm directory and then run the following:

../../../../tools/deployment/developer/common/010-deploy-k8s.sh

Alternatively, this step can be performed by running the script directly:

./tools/deployment/developer/common/010-deploy-k8s.sh

This command will deploy a single node KubeADM administered cluster. This will use the parameters in ${OSH_INFRA_PATH}/tools/gate/playbooks/vars.yaml to control the deployment, which can be over-ridden by adding entries to ${OSH_INFRA_PATH}/tools/gate/devel/local-vars.yaml.

Helm Chart Installation

Using the Helm packages previously pushed to the local Helm repository, run the following commands to instruct tiller to create an instance of the given chart. During installation, the helm client will print useful information about resources created, the state of the Helm releases, and whether any additional configuration steps are necessary.

Install OpenStack-Helm

Note

The following commands all assume that they are run from the openstack-helm directory and the repos have been cloned as above.

Setup Clients on the host and assemble the charts

The OpenStack clients and Kubernetes RBAC rules, along with assembly of the charts can be performed by running the following commands:

../../../../tools/deployment/developer/common/020-setup-client.sh

Alternatively, this step can be performed by running the script directly:

./tools/deployment/developer/common/020-setup-client.sh

Deploy the ingress controller

../../../../tools/deployment/developer/common/030-ingress.sh

Alternatively, this step can be performed by running the script directly:

./tools/deployment/developer/common/030-ingress.sh