clearlinux/clear-linux-documentation
2
0
Fork 0
mirror of https://github.com/clearlinux/clear-linux-documentation.git synced 2026-08-25 01:06:37 +00:00
Code Issues Packages Projects Releases Wiki Activity

Merge branch 'mesiment-ciao-cluster-setup' into 'master'

Browse Source 
update ciao deploy with new location of ansible playbooks

This PR changes the documentation to reflect the adoption of the ansible playbooks into the [ciao repo](https://github.com/01org/ciao/)

See merge request !120
This commit is contained in:
Rodrigo Caballero
2016-11-14 10:15:41 -08:00
parent 35bd6c2fe2 bad08e4592
commit f3bc348adf
1 changed files with 35 additions and 23 deletions
Download Patch File Download Diff File Expand all files Collapse all files
source/ciao-deploy.rst
+35 -23
View File
@@ -22,8 +22,10 @@ For this example, we'll use a total of five nodes:
- Two `compute nodes`_, which will spawn the VMs and containers.
- A `network node`_ which will handle the networking for the workloads.
Note: The deployment machine is not a necessary part of the cluster; it could be
the sysadmin's computer or a CI/CD server.
.. note::
The deployment machine is not a necessary part of the cluster; it could be
the sysadmin's computer or a CI/CD server.
.. _prerequisites:
@@ -45,14 +47,14 @@ You will need to download the ciao example deployment as follows:
.. code-block:: console
$ git clone https://github.com/clearlinux/clear-config-management.git
$ git clone https://github.com/01org/ciao.git
Once you're cloned the repo, continue working in the
`clear-config-management/examples/ciao/` directory
`ciao/_DeploymentAndDistroPackaging/ansible/` directory
.. code-block:: console
# cd $(pwd)/clear-config-management/examples/ciao/
# cd $(pwd)/ciao/_DeploymentAndDistroPackaging/ansible/
Next, edit the configuration files for the cluster:
@@ -69,7 +71,7 @@ Next, edit the configuration files for the cluster:
A full list of available variables can be found in the
:file:`defaults/main.yml` file of each role at
https://github.com/clearlinux/clear-config-management/tree/master/roles.
https://github.com/01org/ciao/tree/master/_DeploymentAndDistroPackaging/ansible/roles.
To start your cluster setup, we provide a ready-to-use Docker container.
Simply download it and run your setup:
@@ -83,40 +85,49 @@ You can later launch the container with:
.. code-block:: console
$ docker run --privileged -v /path/to/your/.ssh/key:/root/.ssh/id_rsa \
-v $(pwd)/clear-config-management/examples/ciao:/root/ciao \
$ docker run --privileged -v /dev/:/dev/
-v /path/to/your/.ssh/key:/root/.ssh/id_rsa \
-v $(pwd)/ciao:/root/ciao \
-it clearlinux/ciao-deploy
Note: Container is called in `privileged` mode in order to install your
certificates in the CNCI image. to learn more about the Docker options used,
please refer to the `Docker* documentation`_.
.. note::
The cotainer needs `--privileged -v /dev/:/dev/` in order to
install your certificates in the `CNCI image`_.
To learn more about the Docker options used, please refer to the
`Docker* documentation`_.
Run the playbook
================
Once the variables and hosts file are configured, start deployment
with the following command:
Once the variables and hosts file are configured, continue in the
`/root/ciao/_DeploymentAndDistroPackaging/ansible` directory and
start the deployment:
.. code-block:: console
# cd /root/ciao/_DeploymentAndDistroPackaging/ansible
# ansible-playbook -i hosts ciao.yml \
--private-key=~/.ssh/id_rsa \
--user=<REMOTE_USER>
Note: The playbook will create the following files in the current folder of
the machine running the playbooks.
.. note::
* ``./certificates``: This directory contains the certificates
that where created and copied to the cluster nodes.
Note: The playbook will create the following files in the current folder of
the machine running the playbooks.
* ``./images``: This directory contains the images used by the
ciao cluster (fedora, clearlinux, cnci, ovmf.fd).
* ``./certificates``: This directory contains the certificates
that where created and copied to the cluster nodes.
* ``./ciaorc``: This file contains environment variables needed
by ciao cli to authenticate to the ciao cluster.
* ``./images``: This directory contains the images used by the
ciao cluster (fedora, clearlinux, cnci, ovmf.fd).
* ``./openrc``: This file contains environment variables needed by
openstack cli to authenticate with the ciao cluster.
* ``./ciaorc``: This file contains environment variables needed
by ciao cli to authenticate to the ciao cluster.
* ``./openrc``: This file contains environment variables needed by
openstack cli to authenticate with the ciao cluster.
Verify
======
@@ -163,4 +174,5 @@ Then you could verify with the following command:
.. _hosts: https://github.com/clearlinux/clear-config-management/blob/master/examples/ciao/hosts
.. _groups_vars/all: https://github.com/clearlinux/clear-config-management/blob/master/examples/ciao/group_vars/all
.. _github: https://github.com/clearlinux/clear-config-management/tree/master/examples/ciao
.. _CNCI image: https://github.com/01org/ciao/tree/master/networking/ciao-cnci-agent#cnci-agent
.. _Docker* documentation: https://docs.docker.com/engine/reference/commandline/run/