openstack-helm/doc/source/install/developer/cleaning-deployment.rst
Gabe Maurer 9eff96fec8 Added uninstall information
This patch set adds additional instruction to clean and reset a
development environment.

Change-Id: Ifd45b1caebe54c991885773fa23e7a5249fb5465
2018-01-31 08:35:31 -06:00

63 lines
2.0 KiB
ReStructuredText

=======================
Cleaning the Deployment
=======================
Removing Helm Charts
====================
To delete an installed helm chart, use the following command:
.. code-block:: shell
helm delete ${RELEASE_NAME} --purge
This will delete all Kubernetes resources generated when the chart was
instantiated. However for OpenStack charts, by default, this will not delete
the database and database users that were created when the chart was installed.
All OpenStack projects can be configured such that upon deletion, their database
will also be removed. To delete the database when the chart is deleted the
database drop job must be enabled before installing the chart. There are two
ways to enable the job, set the job_db_drop value to true in the chart's
values.yaml file, or override the value using the helm install command as
follows:
.. code-block:: shell
helm install ${RELEASE_NAME} --set manifests.job_db_drop=true
Environment tear-down
=====================
To tear-down, the development environment charts should be removed first from
the 'openstack' namespace and then the 'ceph' namespace using the commands from
the `Removing Helm Charts` section. You can run the following commands to
loop through and delete the charts, then stop the kubelet systemd unit and
remove all the containers before removing the ``/var/lib/openstack-helm``
and ``/var/lib/nova`` directory from the host.
.. code-block:: shell
for NS in openstack ceph; do
helm ls --namespace $NS --short | xargs -L1 -P16 helm delete --purge
done
kubectl delete namespace openstack
kubectl delete namespace ceph
sudo systemctl disable kubelet --now
sudo systemctl stop kubelet
sudo docker ps -aq | xargs -L1 -P16 sudo docker rm -f
sudo rm -rf /var/lib/openstack-helm
sudo rm -rf /var/lib/nova
These commands will restore the environment back to a clean Kubernetes
deployment, that can either be manually removed or over-written by
restarting the deployment process.