From 726d75b8bdf1b66b0db50fe845703df3b39ae3cd Mon Sep 17 00:00:00 2001 From: "Tullis, Michael L" Date: Tue, 6 Sep 2016 09:59:36 -0700 Subject: [PATCH] Language and formatting corrections to merge request 95. --- source/ciao-deploy.rst | 42 +++++++++++++++++++++--------------------- 1 file changed, 21 insertions(+), 21 deletions(-) diff --git a/source/ciao-deploy.rst b/source/ciao-deploy.rst index cea176de..fc8113fd 100644 --- a/source/ciao-deploy.rst +++ b/source/ciao-deploy.rst @@ -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