commit b3caf5c91324ce44fa288c8d1a702d8fed25b098 Author: Maxime Guyot Date: Thu Dec 13 12:30:37 2018 +0100 Add doc for Docker Alpine deployment host A Docker based deployment host allows for integration with CI systems for people who want to do infrastructure as code with their OSA deploy Change-Id: I7a28a595806fe9c346e6654eb07c6c44fdf60510 diff --git a/deploy-guide/source/deploymenthost.rst b/deploy-guide/source/deploymenthost.rst index 2019db5..1c9dc1c 100644 --- a/deploy-guide/source/deploymenthost.rst +++ b/deploy-guide/source/deploymenthost.rst @@ -168,3 +168,34 @@ Install the source and dependencies for the deployment host. # scripts/bootstrap-ansible.sh + +Configure Docker with Alpine +============================ + +It is an alternative realization of deploy host configuration which includes usage of the Docker +container as the deploy host. + +This is also neither supported nor tested in CI, so you should use it at your own risk. + +Before you begin, we recommend upgrading your Docker host system packages and kernel. + +#. Prepare your OpenStack Ansible Dockerfile + + .. code-block:: dockerfile + + FROM alpine + RUN apk add --no-cache bash build-base git python3-dev openssh-client openssh-keygen sudo py3-virtualenv iptables libffi-dev openssl-dev linux-headers coreutils curl + RUN git clone -b |latest_tag| \https://git.openstack.org/openstack/openstack-ansible /opt/openstack-ansible + WORKDIR /opt/openstack-ansible + RUN /opt/openstack-ansible/scripts/bootstrap-ansible.sh + ENTRYPOINT ["bash"] + +#. Build and run your deploy host container + + .. code-block:: shell-session + + # docker build . -t openstack-ansible:|latest_tag| + # docker run -dit --name osa-deploy openstack-ansible:|latest_tag| + # docker exec -it osa-deploy bash + +#. Configure NTP to synchronize with a suitable time source on the Docker host. \ No newline at end of file