Replace OSH-AIO instructions and add links

Currently the docs here have the instructions from the Openstack-Helm
All-in-One environment docs instead of just linking to the docs
themselves. This change removes the redundant instructions and replaces
them with a link to the source of the instructions. This also adds a
link to the Airship in a Bottle instructions to the postgresql-utility
docs.

This is beneficial both to reduce the documentation here, as well as
avoiding changes to the original documents not making their way here.

Change-Id: I54af601112f93d9b50653afb56b93d0cd253658e
This commit is contained in:
Michael Beaver 2019-12-02 10:15:40 -06:00 committed by diwakar thyagaraj
parent 4a2d6deefa
commit a8ac95ca66
2 changed files with 14 additions and 105 deletions

116
README.md
View File

@ -8,128 +8,34 @@ the same time restricting access to the actual containers.
## Prerequisites ## Prerequisites
Deploy OSH-AIO. =======
## System Requirements Deploy OSH-AIO.
=======
Deploy the Openstack-Helm All-in-One environment starting from
[here](https://docs.openstack.org/openstack-helm/latest/install/common-requirements.html)
up through the section `Deploy Compute Kit`
The recommended minimum system requirements for a full deployment are: The recommended minimum system requirements for a full deployment are:
* 16 GB RAM * 16 GB RAM
* 8 Cores * 8 Cores
* 48 GB HDD * 48 GB HDD
## Installation =======
1. To run further commands from the CLI manually, execute the following
1. Add the below to `/etc/sudoers`. to set up authentication credentials
root ALL=(ALL) NOPASSWD: ALL
ubuntu ALL=(ALL) NOPASSWD: ALL
2. Install the latest versions of Git, CA Certs, and Make if necessary.
sudo apt-get update
sudo apt-get dist-upgrade -y
sudo apt-get install --no-install-recommends -y \
ca-certificates \
git \
make \
jq \
nmap \
curl \
uuid-runtime \
bc
3. Clone the OpenStack-Helm repositories.
git clone https://git.openstack.org/openstack/openstack-helm-infra.git
git clone https://git.openstack.org/openstack/openstack-helm.git
4. Configure proxies.
In order to deploy OpenStack-Helm behind corporate proxy servers,
add the following entries to `openstack-helm-infra/tools/gate/devel/local-vars.yaml`.
proxy:
http: http://username:password@host:port
https: https://username:password@host:port
noproxy: 127.0.0.1,localhost,172.17.0.1,.svc.cluster.local
Add the address of the Kubernetes API, `172.17.0.1`, and `.svc.cluster.local` to
your `no_proxy` and `NO_PROXY` environment variables.
export no_proxy=${no_proxy},172.17.0.1,.svc.cluster.local
export NO_PROXY=${NO_PROXY},172.17.0.1,.svc.cluster.local
5. Deploy Kubernetes and Helm.
cd openstack-helm
./tools/deployment/developer/common/010-deploy-k8s.sh
Edit `/etc/resolv.conf` and remove the DNS nameserver entry (`nameserver 10.96.0.10`).
The Python setup client fails if this nameserver entry is present.
6. Setup clients on the host, and assemble the charts.
./tools/deployment/developer/common/020-setup-client.sh
Re-add DNS nameservers back to `/etc/resolv.conf` so that the Keystone URLs DNS will resolve.
7. Deploy the ingress controller.
./tools/deployment/developer/common/030-ingress.sh
8. Deploy Ceph.
./tools/deployment/developer/ceph/040-ceph.sh
9. Activate the namespace to be able to use Ceph.
./tools/deployment/developer/ceph/045-ceph-ns-activate.sh
10. Deploy Keystone.
./tools/deployment/developer/ceph/080-keystone.sh
11. Deploy Heat.
./tools/deployment/developer/ceph/090-heat.sh
12. Deploy Horizon.
./tools/deployment/developer/ceph/100-horizon.sh
13. Deploy Glance.
./tools/deployment/developer/ceph/120-glance.sh
14. Deploy Cinder.
./tools/deployment/developer/ceph/130-cinder.sh
15. Deploy LibVirt.
./tools/deployment/developer/ceph/150-libvirt.sh
16. Deploy the compute kit (Nova and Neutron).
./tools/deployment/developer/ceph/160-compute-kit.sh
17. To run further commands from the CLI manually, execute the following
to set up authentication credentials.
export OS_CLOUD=openstack_helm export OS_CLOUD=openstack_helm
18. Clone the Porthole repository to the openstack-helm project. 2. Clone the Porthole repo to openstack-helm project
git clone https://opendev.org/airship/porthole.git git clone https://opendev.org/airship/porthole.git
## To deploy utility pods ## To deploy utility pods
1. Add and make the chart: 1. To Deploy Utility containers, Please run required scripts
cd porthole cd porthole
helm repo add <chartname> http://localhost:8879/charts
make all
2. Deploy `Ceph-utility`. 2. Deploy `Ceph-utility`.

View File

@ -2,6 +2,9 @@
## Prerequisites: Deploy Airship in a Bottle (AIAB) ## Prerequisites: Deploy Airship in a Bottle (AIAB)
Deploy the [Airship in a Bottle environment](https://opendev.org/airship/treasuremap/src/branch/master/tools/deployment/aiab)
## Installation ## Installation
1. Add the below to `/etc/sudoers`. 1. Add the below to `/etc/sudoers`.