第 5 章 配置容器镜像源

步骤

1. 要在 overcloud 部署中直接从 registry.access.redhat.com 提取镜像，则需使用环境文件来指定镜像参数。以下命令可自动创建此类环境文件：

   (undercloud) $ openstack overcloud container image prepare \
     --namespace=registry.access.redhat.com/rhosp13 \
     --prefix=openstack- \
     --tag-from-label {version}-{release} \
     --output-env-file=/home/stack/templates/overcloud_images.yaml

   • 使用 -e 选项可为可选服务纳入任意环境文件。
   • 如果正在使用 Ceph Storage，请额外纳入以下参数，以定义 Ceph Storage 容器镜像的位置：--set ceph_namespace、--set ceph_image、--set ceph_tag。
2. 这将创建 overcloud_images.yaml 环境文件，其中包含 undercloud 上的镜像位置。需要将该文件包括在部署中。

步骤

1. 查找本地 undercloud registry 的地址。该地址的模式如下所示：

   <REGISTRY IP ADDRESS>:8787

   请使用您先前在 undercloud.conf 文件中通过 local_ip 参数所设置的 undercloud IP 地址。以下命令假设该地址为 192.168.24.1:8787。

2. 创建模板以将镜像上传到本地 registry，并创建环境文件以引用这些镜像：

   (undercloud) $ openstack overcloud container image prepare \
     --namespace=registry.access.redhat.com/rhosp13 \
     --push-destination=192.168.24.1:8787 \
     --prefix=openstack- \
     --tag-from-label {version}-{release} \
     --output-env-file=/home/stack/templates/overcloud_images.yaml \
     --output-images-file /home/stack/local_registry_images.yaml

   • 使用 -e 选项可为可选服务纳入任意环境文件。
   • 如果正在使用 Ceph Storage，请额外纳入以下参数，以定义 Ceph Storage 容器镜像的位置：--set ceph_namespace、--set ceph_image、--set ceph_tag。

3. 这样会创建两个文件：

   • local_registry_images.yaml，包含来自远程来源的容器镜像信息。请使用这个文件将 Red Hat Container Registry (registry.access.redhat.com) 中的镜像提取到 undercloud。

   • overcloud_images.yaml，包含镜像文件在 undercloud 上所处的最终位置。需将该文件纳入到您的部署中。

     请检查这两个文件是否都存在。

4. 将 registry.access.redhat.com 中的容器镜像提取到 undercloud。

   (undercloud) $ sudo openstack overcloud container image upload \
     --config-file  /home/stack/local_registry_images.yaml \
     --verbose

   提取所需镜像需要花费一定时间，具体取决于网络速度及 undercloud 磁盘情况。

   注意

   容器镜像大约占用 10 GB 磁盘空间。

步骤

1. 创建模板以便将镜像提取到本地注册表：

   $ source ~/stackrc
   (undercloud) $ openstack overcloud container image prepare \
     --namespace=rhosp13 \
     --prefix=openstack- \
     --output-images-file /home/stack/satellite_images \

   • 使用 -e 选项可为可选服务纳入任意环境文件。
   • 如果正在使用 Ceph Storage，请额外纳入以下参数，以定义 Ceph Storage 容器镜像的位置：--set ceph_namespace、--set ceph_image、--set ceph_tag。
   注意

   此版本的 openstack overcloud container image prepare 命令针对 registry.access.redhat.com 上的 registry 来生成镜像列表。命令中使用的值不同于后面步骤中的 openstack overcloud container image prepare 命令。

2. 这将创建名为 satellite_images 的文件，其中包含容器镜像信息。您将使用此文件将容器镜像同步至 Satellite 6 服务器。

3. 从 satellite_images 文件中移除特定于 YAML 的信息，然后将其转换为仅包含镜像列表的平面文件。以下 sed 命令可以实现上述操作：

   (undercloud) $ awk -F ':' '{if (NR!=1) {gsub("[[:space:]]", ""); print $2}}' ~/satellite_images > ~/satellite_images_names

   这样就得到了要提取到 Satellite 服务器中的镜像列表。

4. 将 satellite_images_names 文件复制到包含 Satellite 6 hammer 工具的系统中。或者按照 Hammer CLI Guide 中的说明将 hammer 工具安装到 undercloud。

5. 运行以下 hammer 命令，为您的 Satellite 组织创建新产品 (OSP13 Containers)：

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

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

6. 为产品添加基本容器镜像：

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

7. 添加 satellite_images 文件中的 overcloud 容器镜像。

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

8. 同步容器镜像：

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

   等待 Satellite 服务器完成同步。

   注意

   根据具体配置情况，hammer 可能会询问您的 Satellite 服务器用户名和密码。您可以使用配置文件将 hammer 配置为自动登录。请参阅 Hammer CLI Guide 中的“Authentication”部分。

9. 如果 Satellite 6 服务器使用了内容视图，请创建新的内容视图版本以纳入这些镜像。

10. 检查 base 镜像中的标签：

    $ hammer docker tag list --repository "base" \
      --organization "ACME" \
      --product "OSP13 Containers"

    这会显示 OpenStack Platform 容器镜像的标签。

11. 返回到 undercloud 并为 Satellite 服务器上的镜像生成环境文件。以下是用于生成环境文件的命令示例：

    (undercloud) $ openstack overcloud container image prepare \
      --namespace=satellite6.example.com:5000 \
      --prefix=acme-osp13_containers- \
      --tag-from-label {version}-{release} \
      --output-env-file=/home/stack/templates/overcloud_images.yaml

    注意

    此版本的 openstack overcloud container image prepare 命令针对 Satellite 服务器。命令中使用的值不同于上一步骤中的 openstack overcloud container image prepare 命令。

    在运行这个命令时，请纳入以下数据：

    • --namespace - Satellite 服务器上注册表的 URL 和端口。Red Hat Satellite 上的默认注册表端口是 5000。例如，--namespace=satellite6.example.com:5000。

    • --prefix= - 前缀基于 Satellite 6 规范。它的值取决于您是否使用了内容视图：

      • 如果您使用了内容视图，则前缀的结构为 [组织]-[环境]-[内容视图]-[产品]-。例如：acme-production-myosp13-osp13_containers-。
      • 如果不使用内容视图，则前缀的结构为 [组织]-[产品]-。例如：acme-osp13_containers-。
    • --tag-from-label {version}-{release} - 识别各个镜像的最新标签。
    • -e - 为可选服务纳入任意环境文件。

    • --set ceph_namespace、--set ceph_image、--set ceph_tag - 如果正在使用 Ceph Storage，请额外纳入这些参数以定义 Ceph Storage 容器镜像的位置。请注意，ceph_image 现包含特定于 Satellite 的前缀。这个前缀与 --prefix 选项的值相同。例如：

      --set ceph_image=acme-osp13_containers-rhceph-3-rhel7

      这可确保 overcloud 使用符合 Satellite 命名规范的 Ceph 容器镜像。

12. 这将创建 overcloud_images.yaml 环境文件，其中包含 Satellite 服务器上的镜像位置。需要将该文件包括在您的部署中。