3.2. 部署和升级集群应用程序迁移（CAM）工具

流程

1. 在 OpenShift Container Platform Web 控制台中，点击 Operators OperatorHub。
2. 使用 Filter by keyword 项（在这里是 Migration）找到 Cluster Application Migration Operator。
3. 选择 Cluster Application Migration Operator 并点 Install。

4. 在 Create Operator Subscription 页中点 Subscribe：

   在 Installed Operators 页中，Cluster Application Migration Operator 会出现在 openshift-migration 项目中，其状态为 Succeeded。

5. 点 Cluster Application Migration Operator。
6. 在 Provided APIs 下，找到 Migration Controller 标题，再点 Create Instance。
7. 点击 Create。
8. 点 Workloads Pod 来验证 Controller Manager 、Migration UI 、Restic 和 Velero pod 是否正在运行。

流程

1. 在 OpenShift Container Platform Web 控制台中，点击 Operators OperatorHub。
2. 使用 Filter by keyword 项（在这里是 Migration）找到 Cluster Application Migration Operator。
3. 选择 Cluster Application Migration Operator 并点 Install。

4. 在 Create Operator Subscription 页中点 Subscribe：

   在 Installed Operators 页中，Cluster Application Migration Operator 会出现在 openshift-migration 项目中，其状态为 Succeeded。

5. 点 Cluster Application Migration Operator。
6. 在 Provided APIs 下，找到 Migration Controller 标题，再点 Create Instance。

7. 在 spec 小节中将 migration_controller 和 migration_ui 参数设置为 false：

   spec:
     ...
     migration_controller: false
     migration_ui: false
     ...

8. 点击 Create。
9. 点 Workloads Pod 来验证 Restic 和 Velero pod 是否正在运行。

流程

1. 在没有网络访问限制的工作站中，与目标镜像（mirror） registry 进行身份验证：

   $ podman login <registry_host_name>

   还可使用 registry.redhat.io 验证，以便在构建期间拉取基础镜像：

   $ podman login registry.redhat.io

2. 根据 quay.io 中的 redhat-operators 目录构建目录镜像，进行标记并将其推送到您的镜像 registry：

   $ oc adm catalog build \
       --appregistry-org redhat-operators \1
       --from=registry.redhat.io/openshift4/ose-operator-registry:v4.4 \2
       --filter-by-os="linux/amd64" \3
       --to=<registry_host_name>:<port>/olm/redhat-operators:v1 \4
       [-a ${REG_CREDS}] \5
       [--insecure] \6
       [--auth-token "${AUTH_TOKEN}"] 7
   
   INFO[0013] loading Bundles                               dir=/var/folders/st/9cskxqs53ll3wdn434vw4cd80000gn/T/300666084/manifests-829192605
   ...
   Pushed sha256:f73d42950021f9240389f99ddc5b0c7f1b533c054ba344654ff1edaf6bf827e3 to example_registry:5000/olm/redhat-operators:v1

   1

   从 App Registry 实例中拉取的机构（命名空间）。

   2

   使用与目标 OpenShift Container Platform 集群主版本和次版本匹配的标签，将 --from 设置为 ose-operator-registry 基础镜像。

   3

   将 --filter-by-os 设置为用于基本镜像的操作系统和架构，该镜像必须与目标 OpenShift Container Platform 集群匹配。有效值是 linux/amd64、linux/ppc64le 和 linux/s390x。

   4

   为您的目录镜像命名并包含标签，例如: v1。

   5

   可选：如果需要，指定 registry 凭证文件的位置。

   6

   可选：如果您不想为目标 registry 配置信任，请添加 --insecure 标志。

   7

   可选：如果使用其他不公开的应用程序 registry 目录，则需要指定 Quay 身份验证令牌。

   有时红帽目录中会意外引入无效的清单；当发生这种情况时，您可能会看到一些错误：

   ...
   INFO[0014] directory                                     dir=/var/folders/st/9cskxqs53ll3wdn434vw4cd80000gn/T/300666084/manifests-829192605 file=4.2 load=package
   W1114 19:42:37.876180   34665 builder.go:141] error building database: error loading package into db: fuse-camel-k-operator.v7.5.0 specifies replacement that couldn't be found
   Uploading ... 244.9kB/s

   这些错误通常不是致命的，如果所提及 Operator 软件包不包含您计划安装的 Operator 或其依赖项，则可以忽略它们。

流程

1. 通过在 spec 中添加 disableAllDefaultSources: true 来禁用默认 OperatorSource：

   $ oc patch OperatorHub cluster --type json \
       -p '[{"op": "add", "path": "/spec/disableAllDefaultSources", "value": true}]'

   该操作将禁用在 OpenShift Container Platform 安装期间默认配置的默认 OperatorSource。

2. oc adm catalog mirror 命令提取自定义 Operator catalog 镜像的内容，以生成镜像（mirror）所需的清单：您可以选择：

   • 允许该命令的默认行为在生成清单后自动将所有镜像内容镜像到您的镜像 registry 中，或者
   • 添加 --manifests-only 标志来只生成镜像所需的清单，但并不实际将镜像内容镜像到 registry。这对检查哪些要镜像（mirror）非常有用。如果您只需要部分内容的话，可以对映射列表做出任何修改。然后，您可以使用该文件与 oc image mirror 命令一起，在以后的步骤中镜像修改的镜像列表。

   在没有网络访问限制的工作站中，运行以下命令：

   $ oc adm catalog mirror \
       <registry_host_name>:<port>/olm/redhat-operators:v1 \1
       <registry_host_name>:<port> \
       [-a ${REG_CREDS}] \2
       [--insecure] \3
       [--filter-by-os="<os>/<arch>"] \4
       [--manifests-only] 5

   1

   指定 Operator 目录镜像。

   2

   可选：如果需要，指定 registry 凭证文件的位置。

   3

   可选：如果您不想为目标 registry 配置信任，请添加 --insecure 标志。

   4

   可选： 因为目录可能会引用支持多个架构和操作系统的镜像，您可以根据架构和操作系统进行过滤来只对匹配的镜像进行镜像（mirror）。有效值是 linux/amd64、linux/ppc64le 和 linux/s390x。

   5

   可选：只生成镜像所需的清单，但并不实际将镜像内容镜像到 registry。

   输出示例

   using database path mapping: /:/tmp/190214037
   wrote database to /tmp/190214037
   using database at: /tmp/190214037/bundles.db 1
   ...

   1

   命令生成的临时数据库。

   在运行命令后，会在当前目录中生成 <image_name>-manifests/ 目录以及以下文件：

   • 用来定义 ImageContentSourcePolicy 对象的 imageContentSourcePolicy.yaml，它可以将节点配置为在 Operator 清单中存储的镜像（image）引用和镜像 (mirror) 的 registry 间进行转换。
   • mapping.txt 文件，在其中包含所有源镜像，并将它们映射到目标 registry。此文件与 oc image mirror 命令兼容，可用于进一步自定义镜像（mirror）配置。

3. 如果您在上一步中使用 --manifests-only 标志，并只想镜像部分内容：

   1. 将 mapping.txt 文件中的镜像列表改为您的规格。如果您不确定要镜像的镜像子集的名称和版本，请使用以下步骤查找：

      1. 对 oc adm catalog mirror 命令生成的临时数据库运行 sqlite3 工具，以检索与一般搜索查询匹配的镜像列表。输出以后如何编辑 mapping.txt 文件的帮助信息。

         例如，要检索与字符串 clusterlogging.4.3 类似的镜像列表：

         $ echo "select * from related_image \
             where operatorbundle_name like 'clusterlogging.4.3%';" \
             | sqlite3 -line /tmp/190214037/bundles.db 1

         1

         请参阅 oc adm catalog mirror 命令的输出结果来查找数据库文件的路径。

         输出示例

         image = registry.redhat.io/openshift4/ose-logging-kibana5@sha256:aa4a8b2a00836d0e28aa6497ad90a3c116f135f382d8211e3c55f34fb36dfe61
         operatorbundle_name = clusterlogging.4.3.33-202008111029.p0
         
         image = registry.redhat.io/openshift4/ose-oauth-proxy@sha256:6b4db07f6e6c962fc96473d86c44532c93b146bbefe311d0c348117bf759c506
         operatorbundle_name = clusterlogging.4.3.33-202008111029.p0
         ...

      2. 使用上一步的结果来编辑 mapping.txt 文件，使其只包含您要镜像的镜像子集。

         例如，您可以使用前面示例输出中的 image 值来找出您的 mapping.txt 文件中存在以下匹配行：

         mapping.txt 中的匹配镜像映射

         registry.redhat.io/openshift4/ose-logging-kibana5@sha256:aa4a8b2a00836d0e28aa6497ad90a3c116f135f382d8211e3c55f34fb36dfe61=<registry_host_name>:<port>/openshift4-ose-logging-kibana5:a767c8f0
         registry.redhat.io/openshift4/ose-oauth-proxy@sha256:6b4db07f6e6c962fc96473d86c44532c93b146bbefe311d0c348117bf759c506=<registry_host_name>:<port>/openshift4-ose-oauth-proxy:3754ea2b

         在这个示例中，如果您只想镜像这些 image，可以在 mapping.txt 文件中删除所有其他条目，仅保留上述两行。

   2. 在您的没有网络访问限制的工作站中，使用您修改的 mapping.txt 文件，使用 oc image mirror 命令将镜像镜像到 registry:

      $ oc image mirror \
          [-a ${REG_CREDS}] \
          -f ./redhat-operators-manifests/mapping.txt

4. 应用 ImageContentSourcePolicy:

   $ oc apply -f ./redhat-operators-manifests/imageContentSourcePolicy.yaml

5. 创建一个 CatalogSource 对象来引用您的目录镜像。

   1. 按照您的规格修改以下内容，并将它保存为 catalogsource.yaml 文件：

      apiVersion: operators.coreos.com/v1alpha1
      kind: CatalogSource
      metadata:
        name: my-operator-catalog
        namespace: openshift-marketplace
      spec:
        sourceType: grpc
        image: <registry_host_name>:<port>/olm/redhat-operators:v1 1
        displayName: My Operator Catalog
        publisher: grpc

      1

      指定您的自定义 Operator 目录镜像。

   2. 使用该文件创建 CatalogSource 对象：

      $ oc create -f catalogsource.yaml

6. 确定成功创建以下资源。

   1. 检查 Pod:

      $ oc get pods -n openshift-marketplace

      输出示例

      NAME                                    READY   STATUS    RESTARTS  AGE
      my-operator-catalog-6njx6               1/1     Running   0         28s
      marketplace-operator-d9f549946-96sgr    1/1     Running   0         26h

   2. 检查 CatalogSource:

      $ oc get catalogsource -n openshift-marketplace

      输出示例

      NAME                  DISPLAY               TYPE PUBLISHER  AGE
      my-operator-catalog   My Operator Catalog   grpc            5s

   3. 检查 PackageManifest:

      $ oc get packagemanifest -n openshift-marketplace

      输出示例

      NAME    CATALOG              AGE
      etcd    My Operator Catalog  34s

流程

1. 在 OpenShift Container Platform Web 控制台中，点击 Operators OperatorHub。
2. 使用 Filter by keyword 项（在这里是 Migration）找到 Cluster Application Migration Operator。
3. 选择 Cluster Application Migration Operator 并点 Install。

4. 在 Create Operator Subscription 页中点 Subscribe：

   在 Installed Operators 页中，Cluster Application Migration Operator 会出现在 openshift-migration 项目中，其状态为 Succeeded。

5. 点 Cluster Application Migration Operator。
6. 在 Provided APIs 下，找到 Migration Controller 标题，再点 Create Instance。
7. 点击 Create。
8. 点 Workloads Pod 来验证 Controller Manager 、Migration UI 、Restic 和 Velero pod 是否正在运行。

流程

1. 在 OpenShift Container Platform Web 控制台中，点击 Operators OperatorHub。
2. 使用 Filter by keyword 项（在这里是 Migration）找到 Cluster Application Migration Operator。
3. 选择 Cluster Application Migration Operator 并点 Install。

4. 在 Create Operator Subscription 页中点 Subscribe：

   在 Installed Operators 页中，Cluster Application Migration Operator 会出现在 openshift-migration 项目中，其状态为 Succeeded。

5. 点 Cluster Application Migration Operator。
6. 在 Provided APIs 下，找到 Migration Controller 标题，再点 Create Instance。
7. 点击 Create。

流程

1. 在 OpenShift Container Platform 控制台中导航至 Operators > Installed Operators。
2. 点 Cluster Application Migration Operator。
3. 在 Subscription 选项卡中，将 Approval 选项改为 Automatic。

4. 可选：编辑 Channel。

   更新订阅会部署更新的 Cluster Application Migration Operator，并更新 CAM 工具组件。

流程

1. 登录到集群并获取 migration-controller 服务帐户令牌：

   $ oc sa get-token -n openshift-migration migration-controller

2. 登录到 CAM web 控制台并点 Clusters。
3. 点击集群的 Options 菜单 并选择 Edit。
4. 将新令牌复制到 Service account token 字段。

5. 点击 Update cluster，然后点击 Close。

   为集群更新服务帐户令牌。