docker/README-containers.md

   1 # Using Docker Containers With TripleO
   2
   3 ## Configuring TripleO with to use a container based compute node.
   4
   5 Steps include:
   6 - Adding a base OS image to glance
   7 - Deploy an overcloud configured to use the docker compute heat templates
   8
   9 ## Getting base OS image working.
  10
  11 Download the fedora atomic image into glance:
  12
  13 ```
  14 wget https://download.fedoraproject.org/pub/fedora/linux/releases/22/Cloud/x86_64/Images/Fedora-Cloud-Atomic-22-20150521.x86_64.qcow2
  15 glance image-create --name atomic-image --file Fedora-Cloud-Atomic-22-20150521.x86_64.qcow2 --disk-format qcow2 --container-format bare
  16 ```
  17
  18 ## Configuring TripleO
  19
  20 You can use the tripleo.sh script up until the point of running the Overcloud.
  21 https://github.com/openstack/tripleo-common/blob/master/scripts/tripleo.sh
  22
  23 You will want to set up the runtime puppet script delivery system described here:
  24 http://hardysteven.blogspot.ca/2016/08/tripleo-deploy-artifacts-and-puppet.html
  25
  26 Create the Overcloud:
  27 ```
  28 $ openstack overcloud deploy --templates=tripleo-heat-templates -e tripleo-heat-templates/environments/docker.yaml -e tripleo-heat-templates/environments/docker-network.yaml --libvirt-type=qemu
  29 ```
  30
  31 Using Network Isolation in the Overcloud:
  32 ```
  33 $ openstack overcloud deploy --templates=tripleo-heat-templates -e tripleo-heat-templates/environments/docker.yaml -e tripleo-heat-templates/environments/docker-network-isolation.yaml --libvirt-type=qemu
  34 ```
  35
  36 Source the overcloudrc and then you can use the overcloud.
  37
  38 ## Debugging
  39
  40 You can ssh into the controller/compute nodes by using the heat key, eg:
  41 ```
  42 nova list
  43 ssh heat-admin@<compute_node_ip>
  44 ```
  45
  46 You can check to see what docker containers are running:
  47 ```
  48 sudo docker ps -a
  49 ```
  50
  51 To enter a container that doesn't seem to be working right:
  52 ```
  53 sudo docker exec -ti <container name> /bin/bash
  54 ```
  55
  56 Then you can check logs etc.
  57
  58 You can also just do a 'docker logs' on a given container.