porthole/README.md
Rahul Khiyani 55703d7563 Adjust code to project conventions
1. Cleaning up old Makefiles and scripts which are not used anymore

2. Renaming files to contain .md extension so that they render correctly

3. Moving README* files so that they are stored in same location

4. Adding installation scripts for all the utilities

Change-Id: Id8475cc7323f6905a0ea6df330197c61688a2a90
2019-11-19 14:56:22 +00:00

146 lines
3.9 KiB
Markdown

# Utility Containers
Utility containers provide a component level, consolidated view of
running containers within Network Cloud infrastructure to members
of the Operation team. This allows Operation team members access to
check the state of various services running within the component
pods of Network Cloud.
## Prerequisites
Deploy OSH-AIO
## System Requirements
The recommended minimum system requirements for a full deployment are:
* 16GB of RAM
* 8 Cores
* 48GB HDD
## Installation
1. Add the below to /etc/sudoers
root ALL=(ALL) NOPASSWD: ALL
ubuntu ALL=(ALL) NOPASSWD: ALL
2. Install the latest versions of Git, CA Certs & 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 Repos
git clone https://git.openstack.org/openstack/openstack-helm-infra.git
git clone https://git.openstack.org/openstack/openstack-helm.git
4. Proxy Configuration
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 & Helm
cd openstack-helm
./tools/deployment/developer/common/010-deploy-k8s.sh
Please remove DNS nameserver (nameserver 10.96.0.10) from /etc/resolv.conf,
Since python set-up client would fail without it.
6. Setup Clients on the host and assemble the charts
./tools/deployment/developer/common/020-setup-client.sh
Re-add DNS nameservers back in /etc/resolv.conf so that keystone URL's DNS would 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 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
18. Clone the Porthole repo to openstack-helm project
git clone https://opendev.org/airship/porthole.git
## To deploy utility pods
1. cd porthole
2. helm repo add <chartname> http://localhost:8879/charts
3. make all
4. Deploy Ceph-utility
./tools/deployment/utilities/010-ceph-utility.sh
5. Deploy Compute-utility
./tools/deployment/utilities/020-compute-utility.sh
6. Deploy Etcdctl-utility
./tools/deployment/utilities/030-etcdctl-utility.sh
7. Deploy Mysqlclient-utility.sh
./tools/deployment/utilities/040-Mysqlclient-utility.sh
8. Deploy Openstack-utility.sh
./tools/deployment/utilities/050-openstack-utility.sh
## NOTE
For postgresql-utility please refer to below URL as per validation
postgresql-utility is deployed in AIAB
https://opendev.org/airship/porthole/src/branch/master/images/postgresql-utility/README.md