过渡到容器化服务

流程

1. 要在 overcloud 部署中直接从 registry.redhat.io 拉取镜像，需要一个环境文件来指定镜像参数。运行以下命令以生成容器镜像环境文件：

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

   Copy to Clipboard Toggle word wrap
   • 使用 -e 选项包括可选服务的任何环境文件。
   • 使用 -r 选项包括自定义角色文件。
   • 如果使用 Ceph Storage，包括额外的参数来定义 Ceph Storage 容器镜像位置：-- set ceph_namespace ,--set ceph _image,--set ceph_tag.

2. 修改 overcloud_images.yaml 文件，并包括下列参数以在部署期间与 registry.redhat.io 进行身份验证：

   ContainerImageRegistryLogin: true
   ContainerImageRegistryCredentials:
     registry.redhat.io:
       <USERNAME>: <PASSWORD>

   Copy to Clipboard Toggle word wrap

   • 将 & lt;USERNAME& gt ; 和 <PASSWORD > 替换为 registry.redhat.io 的凭证。

     overcloud_images.yaml 文件包含 undercloud 上的镜像位置。在您的部署中包含此文件。

     注意

     在运行 openstack overcloud deploy 命令前，您必须登录远程 registry：

     (undercloud) $ sudo docker login registry.redhat.io

     Copy to Clipboard Toggle word wrap

流程

1. 查找本地 undercloud registry 的地址。地址使用以下模式：

   <REGISTRY_IP_ADDRESS>:8787

   Copy to Clipboard Toggle word wrap

   使用 undercloud 的 IP 地址，之前使用 undercloud.conf 文件中的 local_ip 参数进行设置。对于下列命令，该地址被假定为 192.168.24.1:8787。

2. 登录到 registry.redhat.io ：

   (undercloud) $ docker login registry.redhat.io --username $RH_USER --password $RH_PASSWD

   Copy to Clipboard Toggle word wrap

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

   (undercloud) $ openstack overcloud container image prepare \
     --namespace=registry.redhat.io/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

   Copy to Clipboard Toggle word wrap
   • 使用 -e 选项包括可选服务的任何环境文件。
   • 使用 -r 选项包括自定义角色文件。
   • 如果使用 Ceph Storage，包括额外的参数来定义 Ceph Storage 容器镜像位置：-- set ceph_namespace ,--set ceph _image,--set ceph_tag.

4. 验证是否已创建以下两个文件：

   • local_registry_images.yaml，其中包含来自远程源的容器镜像信息。使用此文件将 Red Hat Container Registry (registry.redhat.io)中的镜像拉取到 undercloud。
   • overcloud_images.yaml，其中包含 undercloud 上的最终镜像位置。您的部署会包含这个文件。

5. 从远程 registry 拉取容器镜像并将其推送到 undercloud registry：

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

   Copy to Clipboard Toggle word wrap

   拉取所需的镜像可能需要一些时间，具体取决于您的网络和 undercloud 磁盘的速度。

   注意

   容器镜像大约消耗 10 GB 磁盘空间。

6. 该镜像现在存储在 undercloud 的 docker-distribution 注册表中。要查看 undercloud 的 docker-distribution registry 中的镜像列表，请运行以下命令：

   (undercloud) $  curl http://192.168.24.1:8787/v2/_catalog | jq .repositories[]

   Copy to Clipboard Toggle word wrap
   注意

   本身中的 _catalog 资源仅显示 100 个镜像。要显示更多镜像，请使用 ?n=<interger& gt; 查询字符串及 _catalog 资源来显示更多镜像数量：

   (undercloud) $  curl http://192.168.24.1:8787/v2/_catalog?n=150 | jq .repositories[]

   Copy to Clipboard Toggle word wrap

   要查看特定镜像的标签列表，请使用 skopeo 命令：

   (undercloud) $ curl -s http://192.168.24.1:8787/v2/rhosp13/openstack-keystone/tags/list | jq .tags

   Copy to Clipboard Toggle word wrap

   要验证标记的镜像，使用 skopeo 命令：

   (undercloud) $ skopeo inspect --tls-verify=false docker://192.168.24.1:8787/rhosp13/openstack-keystone:13.0-44

   Copy to Clipboard Toggle word wrap

流程

1. 创建模板以将镜像拉取到本地 registry：

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

   Copy to Clipboard Toggle word wrap
   • 使用 -e 选项包括可选服务的任何环境文件。
   • 使用 -r 选项包括自定义角色文件。
   • 如果使用 Ceph Storage，包括额外的参数来定义 Ceph Storage 容器镜像位置：-- set ceph_namespace ,--set ceph _image,--set ceph_tag.
   注意

   此版本的 openstack overcloud 容器镜像准备命令以 registry.redhat.io 上的 registry 为目标，以生成镜像列表。它使用与 openstack overcloud 容器镜像准备 命令不同的值。

2. 这会利用容器镜像信息创建名为 satellite_images 的文件。您将使用此文件将容器镜像同步到卫星 6 服务器。

3. 从 satellite_images 文件中删除特定于 YAML 的信息，并将其转换为仅包含镜像列表的平面文件。以下 sed 命令完成此操作：

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

   Copy to Clipboard Toggle word wrap

   这为您提供了拉取到 Satellite 服务器的镜像列表。

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

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

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

   Copy to Clipboard Toggle word wrap

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

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

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

   Copy to Clipboard Toggle word wrap

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.redhat.io \
     --docker-upstream-name $IMAGE \
     --name $IMAGENAME ; done < satellite_images_names

   Copy to Clipboard Toggle word wrap

8. 同步容器镜像：

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

   Copy to Clipboard Toggle word wrap

   等待 Satellite 服务器完成同步。

   注意

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

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

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

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

    Copy to Clipboard Toggle word wrap

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

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

    (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

    Copy to Clipboard Toggle word wrap
    注意

    此版本的 openstack overcloud 容器镜像准备命令以 Satellite 服务器为目标。它使用与上一步中使用的 openstack overcloud 容器镜像准备命令不同的值。

    在运行这个命令时，包含以下数据：

    • --namespace - Satellite 服务器上 registry 的 URL 和端口。Red Hat Satellite 上的 registry 端口是 5000。例如： --namespace=satellite6.example.com:5000。

      注意

      如果您使用 Red Hat Satellite 版本 6.10，则不需要指定端口。使用 443 的默认端口。如需更多信息，请参阅 "如何把 RHOSP13 部署调整为 Red Hat Satellite 6.10？"。

    • --prefix= - 前缀基于标签的 Satellite 6 约定，它使用小写字符并用下划线替换空格。前缀根据您是否使用内容视图而不同：

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

    • --set ceph_namespace,--set ceph_image,--set ceph_tag - If using Ceph Storage, 包括额外的参数来定义 Ceph Storage 容器镜像位置。请注意，ceph_image 现包含特定于 Satellite 的前缀。这个前缀与 --prefix 选项的值相同。例如：

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

      Copy to Clipboard Toggle word wrap

      这将确保 overcloud 使用 Ceph 容器镜像，它利用卫星命名约定。

12. overcloud_images.yaml 文件包含 Satellite 服务器上的镜像位置。在您的部署中包含此文件。

流程

1. 拉取您要修改的镜像。例如，对于 openstack-keystone 镜像：

   $ sudo docker pull registry.redhat.io/rhosp13/openstack-keystone:latest

   Copy to Clipboard Toggle word wrap

2. 检查原始镜像上的默认用户。例如，对于 openstack-keystone 镜像：

   $ sudo docker run -it registry.redhat.io/rhosp13/openstack-keystone:latest whoami
   root

   Copy to Clipboard Toggle word wrap
   注意

   openstack-keystone 镜像使用 root 作为默认用户。其他镜像使用特定用户。例如，openstack-glance-api 将 glance 用于默认用户。

3. 创建 Dockerfile 以在现有容器镜像上构建额外层。以下示例从 Container Catalog 拉取最新的 OpenStack Identity (keystone)镜像，并将自定义 RPM 文件安装到镜像中：

   FROM registry.redhat.io/rhosp13/openstack-keystone
   MAINTAINER Acme
   LABEL name="rhosp13/openstack-keystone-acme" vendor="Acme" version="2.1" release="1"
   
   # switch to root and install a custom RPM, etc.
   USER root
   COPY custom.rpm /tmp
   RUN rpm -ivh /tmp/custom.rpm
   
   # switch the container back to the default user
   USER root

   Copy to Clipboard Toggle word wrap

4. 构建并标记新镜像。例如，使用保存在 /home/stack/keystone 目录中的本地 Dockerfile 进行构建，并将其标记为 undercloud 的本地 registry：

   $ docker build /home/stack/keystone -t "192.168.24.1:8787/rhosp13/openstack-keystone-acme:rev1"

   Copy to Clipboard Toggle word wrap

5. 将生成的镜像推送到 undercloud 的本地 registry：

   $ docker push 192.168.24.1:8787/rhosp13/openstack-keystone-acme:rev1

   Copy to Clipboard Toggle word wrap
6. 编辑 overcloud 容器镜像环境文件（通常为 overcloud_images.yaml）并更改适当的参数，以使用自定义容器镜像。

流程

1. Source stackrc 文件：

   $ source ~/stackrc

   Copy to Clipboard Toggle word wrap

2. 运行 deploy 命令，并包含包含 overcloud 镜像位置的文件（通常为 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. 等待 overcloud 完成部署。