64b2e6ef28
Fix the typo of "you cluster" to "your cluster". Change-Id: I100ca40bcb0d8fcb3c45637ee7aecf6560287a42
286 lines
16 KiB
ReStructuredText
286 lines
16 KiB
ReStructuredText
.. _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.
|
|
|
|
Create an external network (Optional)
|
|
-------------------------------------
|
|
|
|
To create a magnum cluster, you need an external network. If there are no
|
|
external networks, create one.
|
|
|
|
#. Create an external network with an appropriate provider based on your
|
|
cloud provider support for your case:
|
|
|
|
.. code-block:: console
|
|
|
|
$ openstack network create public --provider-network-type vxlan \
|
|
--external \
|
|
--project service
|
|
+---------------------------+--------------------------------------+
|
|
| Field | Value |
|
|
+---------------------------+--------------------------------------+
|
|
| admin_state_up | UP |
|
|
| availability_zone_hints | |
|
|
| availability_zones | |
|
|
| created_at | 2017-03-27T10:09:04Z |
|
|
| description | |
|
|
| dns_domain | None |
|
|
| id | 372170ca-7d2e-48a2-8449-670e4ab66c23 |
|
|
| ipv4_address_scope | None |
|
|
| ipv6_address_scope | None |
|
|
| is_default | False |
|
|
| mtu | 1450 |
|
|
| name | public |
|
|
| port_security_enabled | True |
|
|
| project_id | 224c32c0dd2e49cbaadfd1cda069f149 |
|
|
| provider:network_type | vxlan |
|
|
| provider:physical_network | None |
|
|
| provider:segmentation_id | 3 |
|
|
| qos_policy_id | None |
|
|
| revision_number | 4 |
|
|
| router:external | External |
|
|
| segments | None |
|
|
| shared | False |
|
|
| status | ACTIVE |
|
|
| subnets | |
|
|
| updated_at | 2017-03-27T10:09:04Z |
|
|
+---------------------------+--------------------------------------+
|
|
$ openstack subnet create public-subnet --network public \
|
|
--subnet-range 192.168.1.0/24 \
|
|
--gateway 192.168.1.1 \
|
|
--ip-version 4
|
|
+-------------------+--------------------------------------+
|
|
| Field | Value |
|
|
+-------------------+--------------------------------------+
|
|
| allocation_pools | 192.168.1.2-192.168.1.254 |
|
|
| cidr | 192.168.1.0/24 |
|
|
| created_at | 2017-03-27T10:46:15Z |
|
|
| description | |
|
|
| dns_nameservers | |
|
|
| enable_dhcp | True |
|
|
| gateway_ip | 192.168.1.1 |
|
|
| host_routes | |
|
|
| id | 04185f6c-ea31-4109-b20b-fd7f935b3828 |
|
|
| ip_version | 4 |
|
|
| ipv6_address_mode | None |
|
|
| ipv6_ra_mode | None |
|
|
| name | public-subnet |
|
|
| network_id | 372170ca-7d2e-48a2-8449-670e4ab66c23 |
|
|
| project_id | d9e40a0aff30441083d9f279a0ff50de |
|
|
| revision_number | 2 |
|
|
| segment_id | None |
|
|
| service_types | |
|
|
| subnetpool_id | None |
|
|
| updated_at | 2017-03-27T10:46:15Z |
|
|
+-------------------+--------------------------------------+
|
|
|
|
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 swarm-cluster-template \
|
|
--image fedora-atomic-latest \
|
|
--keypair mykey \
|
|
--external-network public \
|
|
--dns-nameserver 8.8.8.8 \
|
|
--master-flavor m1.small \
|
|
--flavor 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 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 your 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.2.5 |
|
|
| 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.
|