Language and formatting corrections to merge request 95.

This commit is contained in:
Tullis, Michael L
2016-09-06 09:59:36 -07:00
parent 03a5d5d0c0
commit 726d75b8bd
+21 -21
View File
@@ -7,7 +7,7 @@ Deploying ciao via automation
Cloud Integrated Advanced Orchestrator (``ciao``) is a new workload
scheduler designed to address limitations of current cloud OS projects.
CIAO provides a lightweight, fully TLS-based minimal config, is
Ciao provides a lightweight, fully TLS-based minimal config, is
workload-agnostic, easy to update, offers an optimized-for-speed
scheduler, and is currently optimized for OpenStack*.
@@ -22,15 +22,15 @@ 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 necessary part of the cluster, it could be
the sysadmin's computer or an 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:
Prerequisites
=============
Ansible* uses :command:`ssh` to run commands on the remote nodes. In order to do
that, the nodes must be configured to allow passwordless ssh connections
that, the nodes must be configured to allow passwordless SSH connections
from the deployment machine to the cluster nodes. The user should also have
sudo privileges on the cluster nodes.
@@ -38,7 +38,7 @@ sudo privileges on the cluster nodes.
Install the software
====================
In ClearLinux install the ``sysadmin-hostmgmt`` bundle on the deployment node. This
In Clear Linux, install the ``sysadmin-hostmgmt`` bundle on the deployment node. This
bundle contains the Ansible software required to run the playbooks.
.. code-block:: console
@@ -46,20 +46,20 @@ bundle contains the Ansible software required to run the playbooks.
# swupd bundle-add sysadmin-hostmgmt
Install ``go-basic``, ``os-core-dev``, ``kvm-host`` and ``os-common`` bundles
on the development node. This bundles contains requirements needed by the playbooks
on the development node. These bundles contain requirements needed by the playbooks.
.. code-block:: console
# swupd bundle-add go-basic os-core-dev kvm-host os-common
go-basic
provides golang which is needed to compile ciao
provides golang, which is needed to compile ciao
os-core-dev
provides gcc which is needed to compile some ciao dependencies
provides gcc, which is needed to compile some ciao dependencies
kvm-host
provides qemu which is needed to build the CNCI image
provides qemu, which is needed to build the CNCI image
os-common
provides python-keystoneclient which is a dependency of the keystone role
provides python-keystone client, which is a dependency of the keystone role
For Ubuntu and Fedora, follow the instructions from `github`_
@@ -76,21 +76,21 @@ of the sample playbook into your home folder
Note: These files are also hosted in `github`_
The relevant files in the playbook are the following::
The relevant files in the playbook are the following:
The `ciao.yml`_ file is the master playbook file and includes a playbook
for each component of the cluster.
* The `ciao.yml`_ file is the master playbook file and includes a playbook
for each component of the cluster.
The `hosts`_ file is the hosts inventory file and contains the IP
addresses/FQDN of your nodes, grouped under the roles they will serve
* The `hosts`_ file is the hosts inventory file and contains the IP
addresses/FQDN of your nodes, grouped under the roles they will serve
The `groups_vars/all`_ file contains variables that will be applied
to your ciao setup. The mandatory variables are already there; be
sure to change the values accordingly to fit your environment
* The `groups_vars/all`_ file contains variables that will be applied
to your ciao setup. The mandatory variables are already there; be
sure to change the values accordingly to fit your environment
The ``ciao_guest_key`` value in :file:`groups_var/all` is the key to be used to connect to the VMs created by
ciao; you can use the ``ssh-keygen`` command to create one as explained in the
:ref:`prerequisites` section.
* The ``ciao_guest_key`` value in :file:`groups_var/all` is the key to be used to connect to the VMs created by
ciao; you can use the ``ssh-keygen`` command to create one as explained in the
:ref:`prerequisites` section.
A full list of available variables can be found in the ciao-* roles at
https://github.com/clearlinux/clear-config-management/tree/master/roles