Transitioning to Containerized Services

Procedure

1. Log in to your undercloud host as the stack user.

2. Generate the default container image preparation file:

   $ openstack tripleo container image prepare default \
     --local-push-destination \
     --output-env-file containers-prepare-parameter.yaml

   Copy to Clipboard Toggle word wrap

   This command includes the following additional options:

   • --local-push-destination sets the registry on the undercloud as the location for container images. This means the director pulls the necessary images from the Red Hat Container Catalog and pushes them to the registry on the undercloud. The director uses this registry as the container image source. To pull directly from the Red Hat Container Catalog, omit this option.

   • --output-env-file is an environment file name. The contents of this file include the parameters for preparing your container images. In this case, the name of the file is containers-prepare-parameter.yaml.

     Note

     You can also use the same containers-prepare-parameter.yaml file to define a container image source for both the undercloud and the overcloud.

3. Edit the containers-prepare-parameter.yaml and make the modifications to suit your requirements.

Procedure

1. Create a list of all container images, including the Ceph images:

   $ sudo docker search "registry.access.redhat.com/rhosp14" | awk '{ print $2 }' | grep -v beta | sed "s/registry.access.redhat.com\///g" | tail -n+2 > satellite_images
   $ echo "rhceph/rhceph-3-rhel7" >> satellite_images_names

   Copy to Clipboard Toggle word wrap
2. Copy the satellite_images_names file to a system that contains the Satellite 6 hammer tool. Alternatively, use the instructions in the Hammer CLI Guide to install the hammer tool to the undercloud.

3. Run the following hammer command to create a new product (OSP14 Containers) in your Satellite organization:

   $ hammer product create \
     --organization "ACME" \
     --name "OSP14 Containers"

   Copy to Clipboard Toggle word wrap

   This custom product will contain our images.

4. Add the base container image to the product:

   $ hammer repository create \
     --organization "ACME" \
     --product "OSP14 Containers" \
     --content-type docker \
     --url https://registry.access.redhat.com \
     --docker-upstream-name rhosp14/openstack-base \
     --name base

   Copy to Clipboard Toggle word wrap

5. Add the overcloud container images from the satellite_images file.

   $ while read IMAGE; do \
     IMAGENAME=$(echo $IMAGE | cut -d"/" -f2 | sed "s/openstack-//g" | sed "s/:.*//g") ; \
     hammer repository create \
     --organization "ACME" \
     --product "OSP14 Containers" \
     --content-type docker \
     --url https://registry.access.redhat.com \
     --docker-upstream-name $IMAGE \
     --name $IMAGENAME ; done < satellite_images_names

   Copy to Clipboard Toggle word wrap

6. Synchronize the container images:

   $ hammer product synchronize \
     --organization "ACME" \
     --name "OSP14 Containers"

   Copy to Clipboard Toggle word wrap

   Wait for the Satellite server to complete synchronization.

   Note

   Depending on your configuration, hammer might ask for your Satellite server username and password. You can configure hammer to automatically login using a configuration file. For more information, see the "Authentication" section in the Hammer CLI Guide.

7. If your Satellite 6 server uses content views, create a new content view version to incorporate the images and promote it along environments in your application life cycle. This largely depends on how you structure your application lifecycle. For example, if you have an environment called production in your lifecycle and you want the container images available in that environment, create a content view that includes the container images and promote that content view to the production environment. For more information, see "Managing Container Images with Content Views".

8. Check the available tags for the base image:

   $ hammer docker tag list --repository "base" \
     --organization "ACME" \
     --environment "production" \
     --content-view "myosp14" \
     --product "OSP14 Containers"

   Copy to Clipboard Toggle word wrap

   This command displays tags for the OpenStack Platform container images within a content view for an particular environment.

9. Return to the undercloud and generate a default environment file for preparing images using your Satellite server as a source. Run the following example command to generate the environment file:

   (undercloud) $ openstack tripleo container image prepare default \
     --output-env-file containers-prepare-parameter.yaml

   Copy to Clipboard Toggle word wrap
   • --output-env-file is an environment file name. The contents of this file will include the parameters for preparing your container images for the undercloud. In this case, the name of the file is containers-prepare-parameter.yaml.

10. Edit the containers-prepare-parameter.yaml file and modify the following parameters:

    • namespace - The URL and port of the registry on the Satellite server. The default registry port on Red Hat Satellite is 5000.

    • name_prefix - The prefix is based on a Satellite 6 convention. This differs depending on whether you use content views:

      • If you use content views, the structure is [org]-[environment]-[content view]-[product]-. For example: acme-production-myosp14-osp14_containers-.
      • If you do not use content views, the structure is [org]-[product]-. For example: acme-osp14_containers-.
    • ceph_namespace, ceph_image, ceph_tag - If using Ceph Storage, include the additional parameters to define the Ceph Storage container image location. Note that ceph_image now includes a Satellite-specific prefix. This prefix is the same value as the name_prefix option.

Procedure

1. Copy the default template to the stack user’s home directory:

   [stack@director ~]$ cp \
     /usr/share/python-tripleoclient/undercloud.conf.sample \
     ~/undercloud.conf

   Copy to Clipboard Toggle word wrap
2. Edit the undercloud.conf file. This file contains settings to configure your undercloud. If you omit or comment out a parameter, the undercloud installation uses the default value.

Procedure

1. Run the following command to install the director on the undercloud:

   [stack@director ~]$ openstack undercloud install

   Copy to Clipboard Toggle word wrap

   This launches the director’s configuration script. The director installs additional packages and configures its services according to the configuration in the undercloud.conf. This script takes several minutes to complete.

   The script generates two files when complete:

   • undercloud-passwords.conf - A list of all passwords for the director’s services.
   • stackrc - A set of initialization variables to help you access the director’s command line tools.

2. The script also starts all OpenStack Platform service containers automatically. Check the enabled containers using the following command:

   [stack@director ~]$ sudo docker ps

   Copy to Clipboard Toggle word wrap

3. The script adds the stack user to the docker group to give the stack user access to container management commands. Refresh the stack user’s permissions with the following command:

   [stack@director ~]$ exec su -l stack

   Copy to Clipboard Toggle word wrap

   The command prompts you to log in again. Enter the stack user’s password.

4. To initialize the stack user to use the command line tools, run the following command:

   [stack@director ~]$ source ~/stackrc

   Copy to Clipboard Toggle word wrap

   The prompt now indicates OpenStack commands authenticate and execute against the undercloud;

   (undercloud) [stack@director ~]$

   Copy to Clipboard Toggle word wrap

Procedure

1. Log into the director as the stack user.

2. Run yum to upgrade the director’s main packages:

   $ sudo yum update -y python-tripleoclient* openstack-tripleo-common openstack-tripleo-heat-templates

   Copy to Clipboard Toggle word wrap

3. The director uses the openstack undercloud upgrade command to update the undercloud environment. Run the command:

   $ openstack undercloud upgrade

   Copy to Clipboard Toggle word wrap
4. Wait until the undercloud upgrade process completes.

5. Reboot the undercloud to update the operating system’s kernel and other system packages:

   $ sudo reboot

   Copy to Clipboard Toggle word wrap
6. Wait until the node boots.

Procedure

1. Source the stackrc file:

   $ source ~/stackrc

   Copy to Clipboard Toggle word wrap

2. Run the deploy command and include the file containing your overcloud image locations (usually overcloud_images.yaml):

   (undercloud) $ openstack overcloud deploy --templates \
     -e /home/stack/templates/overcloud_images.yaml \
     --ntp-server pool.ntp.org

   Copy to Clipboard Toggle word wrap
3. Wait until the overcloud completes deployment.