第 7 章 自定义容器镜像

流程

1. 编辑 containers-prepare-parameter.yaml 文件并添加 ceph_images: false 参数。

   以下是该文件的示例，参数粗体显示：

   parameter_defaults:
     ContainerImagePrepare:
     - tag_from_label: {version}-{release}
       set:
         name_prefix: rhosp17-openstack-
         name_suffix: ''
         tag: 17.1_20231214.1
         rhel_containers: false
         neutron_driver: ovn
         ceph_images: false
       push_destination: true

2. 保存 containers-prepare-parameter.yaml 文件。

3. 创建新的容器镜像文件，以用于 overcloud 部署：

   sudo openstack tripleo container image prepare -e containers-prepare-parameter.yaml --output-env-file <new_container_images_file>

   • 将 <new_container_images_file > 替换为包含新参数的输出文件。
4. 将新容器镜像文件添加到 overcloud 部署环境文件列表中。

流程

1. 下载 RPM 软件包以安装到容器镜像上。

2. 编辑 containers-prepare-parameter.yaml 文件，以更新容器镜像上的所有软件包：

   ContainerImagePrepare:
   - push_destination: true
     ...
     modify_role: tripleo-modify-image
     modify_append_tag: "-updated"
     modify_vars:
       tasks_from: yum_update.yml
       compare_host_packages: true
       yum_repos_dir_path: /etc/yum.repos.d
     ...

3. 保存 containers-prepare-parameter.yaml 文件。
4. 运行 openstack overcloud deploy 命令时，包含 containers-prepare-parameter.yaml 文件。

步骤

1. 以下示例在 nova-compute 镜像上运行自定义 Dockerfile：

   ContainerImagePrepare:
   - push_destination: true
     ...
     includes:
     - nova-compute
     modify_role: tripleo-modify-image
     modify_append_tag: "-hotfix"
     modify_vars:
       tasks_from: modify_image.yml
       modify_dir_path: /home/stack/nova-custom
     ...

2. 以下示例显示了 /home/stack/nova-custom/Dockerfile 文件。运行任何 USER 根指令后，必须切换回原始镜像默认用户：

   FROM registry.redhat.io/rhosp-rhel9/openstack-nova-compute:latest
   
   USER "root"
   
   COPY customize.sh /tmp/
   RUN /tmp/customize.sh
   
   USER "nova"

步骤

1. 创建所有容器镜像的列表：

   $ sudo podman search --limit 1000 "registry.redhat.io/rhosp-rhel9" --format="{{ .Name }}" | sort > satellite_images
   $ sudo podman search --limit 1000 "registry.redhat.io/rhceph" | grep <ceph_dashboard_image_file>
   $ sudo podman search --limit 1000 "registry.redhat.io/rhceph" | grep <ceph_image_file>
   $ sudo podman search --limit 1000 "registry.redhat.io/openshift4" | grep ose-prometheus

   • 将 <ceph_dashboard_image_file > 替换为部署使用的 Red Hat Ceph Storage 版本的镜像文件的名称：

     • Red Hat Ceph Storage 5: rhceph-5-dashboard-rhel8
     • Red Hat Ceph Storage 6: rhceph-6-dashboard-rhel9

   • 将 <ceph_image_file > 替换为部署使用的 Red Hat Ceph Storage 版本的镜像文件的名称：

     • Red Hat Ceph Storage 5: rhceph-5-rhel8

     • Red Hat Ceph Storage 6: rhceph-6-rhel9

       注意

       openstack-ovn-bgp-agent 镜像位于 registry.redhat.io/rhosp-rhel9/openstack-ovn-bgp-agent-rhel9:17.1。

   • 如果您计划安装 Ceph 并启用 Ceph 仪表板，则需要以下 ose-prometheus 容器：

     registry.redhat.io/openshift4/ose-prometheus-node-exporter:v4.12
     registry.redhat.io/openshift4/ose-prometheus:v4.12
     registry.redhat.io/openshift4/ose-prometheus-alertmanager:v4.12

2. 将 satellite_images 文件复制到包含 Satellite 6 hammer 工具的系统中。或者，根据 Hammer CLI 指南中的说明将 hammer 工具安装到 undercloud 中。

3. 运行以下 hammer 命令以在 Satellite 机构中创建新产品(OSP 容器)：

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

   该定制产品将会包含您的镜像。

4. 添加 satellite_images 文件中的 overcloud 容器镜像：

   $ while read IMAGE; do \
     IMAGE_NAME=$(echo $IMAGE | cut -d"/" -f3 | sed "s/openstack-//g") ; \
     IMAGE_NOURL=$(echo $IMAGE | sed "s/registry.redhat.io\///g") ; \
     hammer repository create \
     --organization "ACME" \
     --product "OSP Containers" \
     --content-type docker \
     --url https://registry.redhat.io \
     --docker-upstream-name $IMAGE_NOURL \
     --upstream-username USERNAME \
     --upstream-password PASSWORD \
     --name $IMAGE_NAME ; done < satellite_images

5. 添加 Ceph Storage 容器镜像：

   $ hammer repository create \
     --organization "ACME" \
     --product "OSP Containers" \
     --content-type docker \
     --url https://registry.redhat.io \
     --docker-upstream-name rhceph/<ceph_image_name> \
     --upstream-username USERNAME \
     --upstream-password PASSWORD \
     --name <ceph_image_name>

   • 将 <ceph_image_file > 替换为部署使用的 Red Hat Ceph Storage 版本的镜像文件的名称：

     • Red Hat Ceph Storage 5: rhceph-5-rhel8

     • Red Hat Ceph Storage 6: rhceph-6-rhel9

       注意

       如果要安装 Ceph 仪表板，请在 hammer repository create 命令中包含 --name <ceph_dashboard_image_name > ：

       $ hammer repository create \
         --organization "ACME" \
         --product "OSP Containers" \
         --content-type docker \
         --url https://registry.redhat.io \
         --docker-upstream-name rhceph/<ceph_dashboard_image_name> \
         --upstream-username USERNAME \
         --upstream-password PASSWORD \
         --name <ceph_dashboard_image_name>

       • 将 <ceph_dashboard_image_file > 替换为部署使用的 Red Hat Ceph Storage 版本的镜像文件的名称：

         • Red Hat Ceph Storage 5: rhceph-5-dashboard-rhel8
         • Red Hat Ceph Storage 6: rhceph-6-dashboard-rhel9

6. 同步容器镜像：

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

   等待 Satellite 服务器完成同步。

   注意

   根据具体配置情况，hammer 可能会询问您的 Satellite 服务器用户名和密码。您可以使用配置文件将 hammer 配置为自动登录。有关更多信息，请参阅 Hammer CLI 指南中的身份验证章节。

7. 如果您的 Satellite 6 服务器使用内容视图，请创建一个用于纳入镜像的新内容视图版本，并在应用生命周期的不同环境之间推进这个视图。这在很大程度上取决于您如何构建应用程序的生命周期。例如，如果您的生命周期中有一个称为 production 的环境，并且希望容器镜像在该环境中可用，则创建一个包含容器镜像的内容视图，并将该内容视图推进到 production 环境中。有关更多信息，请参阅管理内容视图。

8. 检查 base 镜像的可用标签：

   $ hammer docker tag list --repository "base" \
     --organization "ACME" \
     --lifecycle-environment "production" \
     --product "OSP Containers"

   此命令显示内容视图中特定环境的 OpenStack Platform 容器镜像的标签。

9. 返回到 undercloud，并生成默认的环境文件，它将您的 Satellite 服务器用作源来准备镜像。运行以下示例命令以生成环境文件：

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

   • --output-env-file 是环境文件名称。此文件的内容包括用于为 undercloud 准备容器镜像的参数。在本例中，文件的名称是 containers-prepare-parameter.yaml。

10. 编辑 containers-prepare-parameter.yaml 文件并修改以下参数：

    • push_destination - 根据您选择的容器镜像管理策略，将此参数设置为 true 或 false。如果将此参数设置为 false，则 overcloud 节点直接从 Satellite 拉取镜像。如果将此参数设置为 true，则 director 将镜像从 Satellite 拉取到 undercloud registry，overcloud 从 undercloud registry 拉取镜像。
    • namespace - Satellite 服务器上 registry 的 URL。

    • name_prefix - 该前缀基于 Satellite 6 规范。它的值根据您是否使用了内容视图而不同：

      • 如果您使用了内容视图，则前缀的结构为 [组织]-[环境]-[内容视图]-[产品]-。例如： acme-production-myosp17-osp_containers-。
      • 如果不使用内容视图，则前缀的结构为 [组织]-[产品]-。例如： acme-osp_containers-。
    • ceph_namespace、ceph_image、ceph_tag - 如果使用 Ceph Storage，请额外纳入这些参数以定义 Ceph Storage 容器镜像的位置。请注意，ceph_image 现包含特定于 Satellite 的前缀。这个前缀与 name_prefix 选项的值相同。

流程

1. 为您的 overcloud 创建新的容器镜像文件：

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

2. 编辑 containers-prepare-parameter-dellemc.yaml 文件。

3. 在主 Red Hat OpenStack Platform 容器镜像的策略中添加一个 exclude 参数。使用此参数排除厂商容器镜像将替换的容器镜像。在示例中，容器镜像是 cinder-volume 镜像：

   parameter_defaults:
     ContainerImagePrepare:
       - push_destination: true
         excludes:
     	   - cinder-volume
         set:
           namespace: registry.redhat.io/rhosp-rhel9
           name_prefix: openstack-
           name_suffix: ''
           tag: 17.1
           ...
         tag_from_label: "{version}-{release}"

4. 在 ContainerImagePrepare 参数中添加新策略，其中包含厂商插件的替代容器镜像：

   parameter_defaults:
     ContainerImagePrepare:
       ...
       - push_destination: true
         includes:
           - cinder-volume
         set:
           namespace: registry.connect.redhat.com/dellemc
           name_prefix: openstack-
           name_suffix: -dellemc-rhosp16
           tag: 16.2-2
           ...

5. 将 registry.connect.redhat.com registry 的身份验证详情添加到 ContainerImageRegistryCredentials 参数中：

   parameter_defaults:
     ContainerImageRegistryCredentials:
       registry.redhat.io:
         [service account username]: [service account password]
       registry.connect.redhat.com:
         [service account username]: [service account password]

6. 保存 containers-prepare-parameter-dellemc.yaml 文件。

7. 包含 containers-prepare-parameter-dellemc.yaml 文件以及任何部署命令，如 openstack overcloud deploy:

   $ openstack overcloud deploy --templates
       ...
       -e containers-prepare-parameter-dellemc.yaml
       ...

   当 director 部署 overcloud 时，overcloud 将使用厂商容器镜像，而不是标准容器镜像。

   重要

   containers-prepare-parameter-dellemc.yaml 文件取代了 overcloud 部署中的标准 containers-prepare-parameter.yaml 文件。不要在 overcloud 部署中包含标准 containers-prepare-parameter.yaml 文件。为您的 undercloud 安装和更新保留标准 containers-prepare-parameter.yaml 文件。