[install] Add launch an instance section
Add documentation to create a basic Docker Swarm cluster and create a container. Change-Id: I43c7701fbd55153e0e36a915efed802dd1fe5ea4 Partially-Implements: blueprint magnum-installation-guide
This commit is contained in:
Spyros Trigazis
Hongbin Lu
parent
d9306042c9
commit
6322a6d827
|
|
@ -8,6 +8,7 @@ Container Infrastructure Management service
|
|||
get_started.rst
|
||||
install.rst
|
||||
verify.rst
|
||||
launch-instance.rst
|
||||
next-steps.rst
|
||||
|
||||
The Container Infrastructure Management service codenamed (magnum) is an
|
||||
|
|
|
|||
|
|
@ -0,0 +1,213 @@
|
|||
.. _launch-instance:
|
||||
|
||||
Launch an instance
|
||||
~~~~~~~~~~~~~~~~~~
|
||||
|
||||
In environments that include the Container Infrastructure Management
|
||||
service, you can provision container clusters made up of virtual machines
|
||||
or baremetal servers. Then, you can use the appropriate COE client or
|
||||
endpoint to create containers.
|
||||
|
||||
Provision a cluster and create a container
|
||||
------------------------------------------
|
||||
|
||||
The Container Infrastructure Management service uses `Cluster Templates
|
||||
<http://docs.openstack.org/developer/magnum/userguide.html
|
||||
#clustertemplate>`__ to describe how a `Cluster <http://docs.openstack.org/
|
||||
developer/magnum/userguide.html#cluster>`__ is constructed. Following this
|
||||
example, you will provision a Docker Swarm cluster with one master
|
||||
and one node. Then, using docker's native API you will create a container.
|
||||
|
||||
#. Download the latest Fedora Atomic image built by magnum team, which is
|
||||
required to provision the cluster:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
$ wget https://fedorapeople.org/groups/magnum/fedora-atomic-latest.qcow2
|
||||
|
||||
#. Source the ``demo`` credentials to perform
|
||||
the following steps as a non-administrative project:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
$ . demo-openrc
|
||||
|
||||
#. Register the image to the Image service setting the ``os_distro`` property
|
||||
to ``fedora-atomic``:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
$ openstack image create \
|
||||
--disk-format=qcow2 \
|
||||
--container-format=bare \
|
||||
--file=fedora-atomic-latest.qcow2 \
|
||||
--property os_distro='fedora-atomic' \
|
||||
fedora-atomic-latest
|
||||
+------------------+------------------------------------------------------+
|
||||
| Field | Value |
|
||||
+------------------+------------------------------------------------------+
|
||||
| checksum | a987b691e23dce54c03d7a57c104b195 |
|
||||
| container_format | bare |
|
||||
| created_at | 2016-09-14T12:58:01Z |
|
||||
| disk_format | qcow2 |
|
||||
| file | /v2/images/81b25935-3400-441a-9f2e-f984a46c89dd/file |
|
||||
| id | 81b25935-3400-441a-9f2e-f984a46c89dd |
|
||||
| min_disk | 0 |
|
||||
| min_ram | 0 |
|
||||
| name | fedora-atomic-latest |
|
||||
| owner | c4b42942156741dfbc4775dbcb032841 |
|
||||
| properties | os_distro='fedora-atomic' |
|
||||
| protected | False |
|
||||
| schema | /v2/schemas/image |
|
||||
| size | 507928064 |
|
||||
| status | active |
|
||||
| tags | |
|
||||
| updated_at | 2016-09-14T12:58:03Z |
|
||||
| virtual_size | None |
|
||||
| visibility | private |
|
||||
+------------------+------------------------------------------------------+
|
||||
|
||||
#. Create a keypair on the Compute service:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
$ openstack keypair create --public-key ~/.ssh/id_rsa.pub mykey
|
||||
+-------------+-------------------------------------------------+
|
||||
| Field | Value |
|
||||
+-------------+-------------------------------------------------+
|
||||
| fingerprint | 05:be:32:07:58:a7:e8:0b:05:9b:81:6d:80:9a:4e:b1 |
|
||||
| name | mykey |
|
||||
| user_id | 2d4398dbd5274707bf100a9dbbe85819 |
|
||||
+-------------+-------------------------------------------------+
|
||||
|
||||
#. Create a cluster template for a Docker Swarm cluster using the above image,
|
||||
``m1.small`` as flavor for the master and the node, ``mykey`` as keypair,
|
||||
``public`` as external network and ``8.8.8.8`` for DNS nameserver, with the
|
||||
following command:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
$ magnum cluster-template-create --name swarm-cluster-template \
|
||||
--image-id fedora-atomic-latest \
|
||||
--keypair-id mykey \
|
||||
--external-network-id public \
|
||||
--dns-nameserver 8.8.8.8 \
|
||||
--master-flavor-id m1.small \
|
||||
--flavor-id m1.small \
|
||||
--coe swarm
|
||||
+-----------------------+--------------------------------------+
|
||||
| Property | Value |
|
||||
+-----------------------+--------------------------------------+
|
||||
| insecure_registry | - |
|
||||
| labels | {} |
|
||||
| updated_at | - |
|
||||
| floating_ip_enabled | True |
|
||||
| fixed_subnet | - |
|
||||
| master_flavor_id | m1.small |
|
||||
| uuid | 47c6ce77-50ae-43bd-8e2a-06980392693d |
|
||||
| no_proxy | - |
|
||||
| https_proxy | - |
|
||||
| tls_disabled | False |
|
||||
| keypair_id | mykey |
|
||||
| public | False |
|
||||
| http_proxy | - |
|
||||
| docker_volume_size | - |
|
||||
| server_type | vm |
|
||||
| external_network_id | public |
|
||||
| cluster_distro | fedora-atomic |
|
||||
| image_id | fedora-atomic-latest |
|
||||
| volume_driver | - |
|
||||
| registry_enabled | False |
|
||||
| docker_storage_driver | devicemapper |
|
||||
| apiserver_port | - |
|
||||
| name | swarm-cluster-template |
|
||||
| created_at | 2016-09-14T13:05:11+00:00 |
|
||||
| network_driver | docker |
|
||||
| fixed_network | - |
|
||||
| coe | swarm |
|
||||
| flavor_id | m1.small |
|
||||
| master_lb_enabled | False |
|
||||
| dns_nameserver | 8.8.8.8 |
|
||||
+-----------------------+--------------------------------------+
|
||||
|
||||
#. Create a cluster with one node and one master with the following command:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
$ magnum cluster-create --name swarm-cluster \
|
||||
--cluster-template swarm-cluster-template \
|
||||
--master-count 1 \
|
||||
--node-count 1
|
||||
Request to create cluster 2582f192-480e-4329-ac05-32a8e5b1166b has been accepted.
|
||||
|
||||
Your cluster is now being created. Creation time depends on your
|
||||
infrastructure's performance. You can check the status of you cluster
|
||||
using the commands: ``magnum cluster-list`` or
|
||||
``magnum cluster-show swarm-cluster``.
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
$ magnum cluster-list
|
||||
+--------------------------------------+---------------+------------+--------------+-----------------+
|
||||
| uuid | name | node_count | master_count | status |
|
||||
+--------------------------------------+---------------+------------+--------------+-----------------+
|
||||
| 2582f192-480e-4329-ac05-32a8e5b1166b | swarm-cluster | 1 | 1 | CREATE_COMPLETE |
|
||||
+--------------------------------------+---------------+------------+--------------+-----------------+
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
$ magnum cluster-show swarm-cluster
|
||||
+---------------------+------------------------------------------------------------+
|
||||
| Property | Value |
|
||||
+---------------------+------------------------------------------------------------+
|
||||
| status | CREATE_COMPLETE |
|
||||
| cluster_template_id | 47c6ce77-50ae-43bd-8e2a-06980392693d |
|
||||
| uuid | 2582f192-480e-4329-ac05-32a8e5b1166b |
|
||||
| stack_id | 3d7bbf1c-49bd-4930-84e0-ab71ba200687 |
|
||||
| status_reason | Stack CREATE completed successfully |
|
||||
| created_at | 2016-09-14T13:36:54+00:00 |
|
||||
| name | swarm-cluster |
|
||||
| updated_at | 2016-09-14T13:38:08+00:00 |
|
||||
| discovery_url | https://discovery.etcd.io/a5ece414689287eca62e35555512bfd5 |
|
||||
| api_address | tcp://172.24.4.10:2376 |
|
||||
| coe_version | 1.0.0 |
|
||||
| master_addresses | ['172.24.4.10'] |
|
||||
| create_timeout | 60 |
|
||||
| node_addresses | ['172.24.4.8'] |
|
||||
| master_count | 1 |
|
||||
| container_version | 1.9.1 |
|
||||
| node_count | 1 |
|
||||
+---------------------+------------------------------------------------------------+
|
||||
|
||||
#. Add the credentials of the above cluster to your environment:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
$ mkdir myclusterconfig
|
||||
$ $(magnum cluster-config swarm-cluster --dir myclusterconfig)
|
||||
|
||||
|
||||
The above command will save the authentication artifacts in the
|
||||
`myclusterconfig` directory and it will export the environmental
|
||||
variables: DOCKER_HOST, DOCKER_CERT_PATH and DOCKER_TLS_VERIFY.
|
||||
Sample output:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
export DOCKER_HOST=tcp://172.24.4.10:2376
|
||||
export DOCKER_CERT_PATH=myclusterconfig
|
||||
export DOCKER_TLS_VERIFY=True
|
||||
|
||||
#. Create a container:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
$ docker run busybox echo "Hello from Docker!"
|
||||
Hello from Docker!
|
||||
|
||||
#. Delete the cluster:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
$ magnum cluster-delete swarm-cluster
|
||||
Request to delete cluster swarm-cluster has been accepted.
|
||||
Loading…
Reference in New Issue