集群管理

流程

1. 进入到 Hybrid Cloud Console 的 Clusters 页。
2. 点集群名称进入集群详情页面。
3. 点 Support 标签页。
4. 在 Support 选项卡中，找到 Notification contacts 部分。
5. 单击 Add notification contact。
6. 在 Red Hat username 或 email 字段中输入新接收者的用户名。
7. 点 Add contact。

流程

1. 进入到 Hybrid Cloud Console 的 Clusters 页。
2. 点集群名称进入集群详情页面。
3. 点 Support 标签页。
4. 在 Support 选项卡中，找到 Notification contacts 部分。
5. 点您要删除的接收者旁的选项菜单(swig)。
6. 点击 Delete。

流程

1. 登录到 Red Hat OpenShift Service on AWS AWS 帐户的 Web 控制台，在托管集群的区域进入 VPC 仪表板。
2. 进入 Peering Connections 页面，点 Create Peering Connection 按钮。

3. 验证您登录到的帐户的详情，以及您要连接的帐户和 VPC 的详情：

   1. 对等连接名称标签 ：为 VPC Peering Connection 设置一个描述性名称。
   2. VPC (Requester) ：从列表中选择 Red Hat OpenShift Service on AWS Cluster VPC ID。
   3. 帐户 ：选择 另一个帐户 并提供客户 AWS 帐户号 *（不带横线）。
   4. 区域 ：如果客户 VPC 区域与当前区域不同，请选择 Another Region，然后从列表中选择客户 VPC 区域。
   5. VPC (Accepter) ：设置客户 VPC ID。
4. 点 Create Peering Connection。
5. 确认请求变为 Pending 状态。如果它变为 Failed 状态，请确认详情并重复此过程。

流程

1. 登录到 AWS Web 控制台。
2. 进入 VPC Service。
3. 进入 Peering Connections。
4. 点 Pending peering connection。
5. 确认请求来自于的 AWS 帐户和 VPC ID。这应该来自 Red Hat OpenShift Service on AWS AWS 帐户和 Red Hat OpenShift Service on AWS 集群 VPC。
6. 点 Accept Request。

流程

1. 登录到 Red Hat OpenShift Service on AWS AWS 帐户的 AWS Web 控制台。
2. 导航到 VPC Service，然后进入 Route tables。

3. 为 Red Hat OpenShift Service on AWS Cluster VPC 选择路由表。

   注意

   在一些集群中，特定 VPC 可能有多个路由表。选择具有多个显式关联子网的私有子网。

4. 选择 Routes 标签页，然后选择 Edit。
5. 在 Destination 文本框中输入 Customer VPC CIDR 块。
6. 在 Target 文本框中输入 Peering Connection ID。
7. 点 Save。

8. 您必须使用其他 VPC 的 CIDR 块完成相同的进程：

   1. 登录到 Customer AWS Web Console → VPC Service → Route Tables。
   2. 选择 VPC 的路由表。
   3. 选择 Routes 标签页，然后选择 Edit。
   4. 在 Destination 文本框中输入 Red Hat OpenShift Service on AWS Cluster VPC CIDR 块。
   5. 在 Target 文本框中输入 Peering Connection ID。
   6. 点 Save Changes。

流程

1. 验证隧道是否在 AWS 中启动。

   1. 在 Virtual private network (VPN) 下，从 VPC 仪表板中点 Site-to-Site VPN 连接。
   2. 选择之前创建的 VPN 连接并点击 Tunnel 详情 选项卡。
   3. 您应该可以看到至少一个 VPN 隧道处于 Up 状态。

2. 验证连接。

   要测试到端点设备的网络连接，nc （或 netcat）是一个有用的故障排除工具。它包含在默认镜像中，如果可以建立连接，提供快速和清晰的输出：

   1. 使用 busybox 镜像创建一个临时 pod，它会自行清理：

      $ oc run netcat-test \
          --image=busybox -i -t \
          --restart=Never --rm \
          -- /bin/sh

      Copy to Clipboard Toggle word wrap

   2. 使用 nc 检查连接。

      • 成功连接结果示例：

        / nc -zvv 192.168.1.1 8080
        10.181.3.180 (10.181.3.180:8080) open
        sent 0, rcvd 0

        Copy to Clipboard Toggle word wrap

      • 连接结果示例：

        / nc -zvv 192.168.1.2 8080
        nc: 10.181.3.180 (10.181.3.180:8081): Connection refused
        sent 0, rcvd 0

        Copy to Clipboard Toggle word wrap

   3. 退出容器，该容器自动删除 Pod:

      / exit

      Copy to Clipboard Toggle word wrap

流程

1. 登陆到 Red Hat OpenShift Service on AWS AWS Account Dashboard 并选择正确的区域。
2. 在 AWS AWS 帐户区域中的 Red Hat OpenShift Service 中，从 Services 菜单中选择 VPC。
3. 从 虚拟专用网络(VPN)，选择 虚拟专用网关。
4. 选择 Create virtual private gateway。
5. 在 Details 字段中为虚拟专用网关指定合适的名称。
6. 点 Custom ASN，然后输入前面收集的 Amazon side ASN 值或使用 Amazon Provided ASN。
7. 单击 Create virtual private gateway。
8. 在 Red Hat OpenShift Service on AWS AWS Account 区域中，选择 Direct Connect from the Services 菜单。
9. 单击 虚拟专用网关，再选择虚拟专用网关。
10. 单击 View details。
11. 点 Direct Connect 网关关联 选项卡。
12. 点 关联直接连接网关
13. 在 关联 帐户类型 下，对于帐户所有者，单击 Another account。
14. 在关联设置下，用于直接连接网关 ID，输入 Direct Connect 网关的 ID。
15. 对于 直接连接网关所有者，请输入拥有直接连接网关的 AWS 帐户的 ID。
16. 可选：为 允许前缀 添加前缀，使用逗号分隔它们，或者将它们放在单独的行中。
17. 单击 关联直接连接网关。
18. 在发送关联建议后，它会等待您接受的接受。AWS 文档中提供了您必须执行的最终步骤。

集群创建过程

1. 在 Red Hat OpenShift Service on AWS 集群向导中导航到 Cluster settings。
2. 进入 Machine pool 步骤。
3. 选择所需的 Root 磁盘大小。
4. 选择 Next 以继续创建集群。

创建机器池的步骤

1. 进入到 OpenShift Cluster Manager 并选择您的集群。
2. 导航到 Machine pool 选项卡。
3. 点 Add machine pool。
4. 选择所需的 Root 磁盘大小。
5. 选择 Add machine pool 来创建机器池。

流程

1. 列出集群中的机器池：

   $ rosa list machinepools --cluster=<cluster_name>

   Copy to Clipboard Toggle word wrap

   输出示例

   ID        AUTOSCALING   REPLICAS    INSTANCE TYPE  LABELS    TAINTS   AVAILABILITY ZONES    DISK SIZE   SG IDs
   default   No            2           m5.xlarge                         us-east-1a            300GiB      sg-0e375ff0ec4a6cfa2
   mp1       No            2           m5.xlarge                         us-east-1a            300GiB      sg-0e375ff0ec4a6cfa2

   Copy to Clipboard Toggle word wrap

2. 增加或减少机器池中的计算节点副本数量：

   $ rosa edit machinepool --cluster=<cluster_name> \
                           --replicas=<replica_count> \

   1

   
                           <machine_pool_id> 

   2

   Copy to Clipboard Toggle word wrap

   1

   副本数定义要置备到区域的机器池的计算节点数量。

   2

   将 <machine_pool_id> 替换为机器池的 ID，如上一命令的输出中所示。

验证

1. 列出集群中可用的机器池：

   $ rosa list machinepools --cluster=<cluster_name>

   Copy to Clipboard Toggle word wrap

   输出示例

   ID        AUTOSCALING   REPLICAS    INSTANCE TYPE  LABELS    TAINTS   AVAILABILITY ZONES    DISK SIZE   SG IDs
   default   No            2           m5.xlarge                         us-east-1a            300GiB      sg-0e375ff0ec4a6cfa2
   mp1       No            3           m5.xlarge                         us-east-1a            300GiB      sg-0e375ff0ec4a6cfa2

   Copy to Clipboard Toggle word wrap

2. 在上一命令的输出中，验证机器池的计算节点副本数是否如预期。在示例输出中，mp1 机器池的计算节点副本数已扩展到 3。

流程

1. 列出集群中的所有机器池：

   $ rosa list machinepools --cluster=<cluster_name>

   Copy to Clipboard Toggle word wrap

   输出示例

   ID           AUTOSCALING  REPLICAS  INSTANCE TYPE  LABELS    TAINTS    AVAILABILITY ZONE  SUBNET                    VERSION  AUTOREPAIR
   db-nodes-mp  No           0/2       m5.xlarge                          us-east-2a         subnet-08d4d81def67847b6  4.14.34  Yes
   workers      No           2/2       m5.xlarge                          us-east-2a         subnet-08d4d81def67847b6  4.14.34  Yes

   Copy to Clipboard Toggle word wrap

2. 您可以将调优配置添加到现有或新机器池中。

   1. 在创建机器池时添加调整：

      $ rosa create machinepool -c <cluster-name> --name <machinepoolname> --tuning-configs <tuning_config_name>

      Copy to Clipboard Toggle word wrap

      输出示例

      ? Tuning configs: sample-tuning
      I: Machine pool 'db-nodes-mp' created successfully on hosted cluster 'sample-cluster'
      I: To view all machine pools, run 'rosa list machinepools -c sample-cluster'

      Copy to Clipboard Toggle word wrap

   2. 为机器池添加或更新调整：

      $ rosa edit machinepool -c <cluster-name> --machinepool <machinepoolname> --tuning-configs <tuning_config_name>

      Copy to Clipboard Toggle word wrap

      输出示例

      I: Updated machine pool 'db-nodes-mp' on cluster 'mycluster'

      Copy to Clipboard Toggle word wrap

验证

1. 描述您添加调优配置的机器池：

   $ rosa describe machinepool --cluster=<cluster_name> --machinepool=<machine_pool_name>

   Copy to Clipboard Toggle word wrap

   输出示例

   ID:                                    db-nodes-mp
   Cluster ID:                            <cluster_ID>
   Autoscaling:                           No
   Desired replicas:                      2
   Current replicas:                      2
   Instance type:                         m5.xlarge
   Labels:
   Tags:
   Taints:
   Availability zone:                     us-east-2a
   Subnet:                                subnet-08d4d81def67847b6
   Version:                               4.14.34
   EC2 Metadata Http Tokens:              optional
   Autorepair:                            Yes
   Tuning configs:                        sample-tuning
   ...

   Copy to Clipboard Toggle word wrap

2. 验证您的机器池是否包含在输出中调整配置。

流程

1. 运行以下命令，列出集群中的所有机器池：

   $ rosa list machinepools --cluster=<cluster_name>

   Copy to Clipboard Toggle word wrap

   输出示例

   ID           AUTOSCALING  REPLICAS  INSTANCE TYPE  LABELS    TAINTS    AVAILABILITY ZONE  SUBNET                    VERSION  AUTOREPAIR
   db-nodes-mp  No           2/2       m5.xlarge                          us-east-2a         subnet-08d4d81def67847b6  4.14.34  Yes
   workers      No           2/2       m5.xlarge                          us-east-2a         subnet-08d4d81def67847b6  4.14.34  Yes

   Copy to Clipboard Toggle word wrap

2. 运行以下命令，检查机器池的节点排空宽限期：

   $ rosa describe machinepool --cluster <cluster_name> --machinepool=<machinepool_name>

   Copy to Clipboard Toggle word wrap

   输出示例

   ID:                                    workers
   Cluster ID:                            2a90jdl0i4p9r9k9956v5ocv40se1kqs
   ...
   Node drain grace period:               

   1

   
   ...

   Copy to Clipboard Toggle word wrap

   1

   如果这个值为空，机器池会在没有时间限制的情况下排空，直到完成为止。

3. 可选：运行以下命令来更新机器池的节点排空宽限期：

   $ rosa edit machinepool --node-drain-grace-period="<node_drain_grace_period_value>" --cluster=<cluster_name>  <machinepool_name>

   Copy to Clipboard Toggle word wrap
   注意

   在机器池升级过程中更改节点排空宽限期适用于将来的升级，而不是进行中升级。

验证

1. 运行以下命令，检查机器池的节点排空宽限期：

   $ rosa describe machinepool --cluster <cluster_name> <machinepool_name>

   Copy to Clipboard Toggle word wrap

   输出示例

   ID:                                    workers
   Cluster ID:                            2a90jdl0i4p9r9k9956v5ocv40se1kqs
   ...
   Node drain grace period:               30 minutes
   ...

   Copy to Clipboard Toggle word wrap

2. 在输出中验证您的机器池的正确 节点排空宽限期。

流程

1. 在 OpenShift Cluster Manager 中，导航到 Cluster List 页面，再选择您要为其启用自动扩展的集群。
2. 在所选集群中，选择 Machine pool 选项卡。
3. 点击您要为其启用自动扩展的机器池末尾的 Options 菜单 ，然后选择 Edit。
4. 在 Edit machine pool 对话框中，选中 Enable autoscaling 复选框。
5. 选择 Save 保存这些更改并为机器池启用自动扩展。

流程

1. 要识别集群中的机器池 ID，请输入以下命令：

   $ rosa list machinepools --cluster=<cluster_name>

   Copy to Clipboard Toggle word wrap

   输出示例

   ID       AUTOSCALING  REPLICAS  INSTANCE TYPE  LABELS    TAINTS    AVAILABILITY ZONE  SUBNET                    VERSION  AUTOREPAIR
   workers  No           2/2       m5.xlarge                          us-east-2a         subnet-03c2998b482bf3b20  4.16.6   Yes
   mp1      No           2/2       m5.xlarge                          us-east-2a         subnet-03c2998b482bf3b20  4.16.6   Yes

   Copy to Clipboard Toggle word wrap

2. 获取您要配置的机器池的 ID。

3. 要在机器池上启用自动扩展，请输入以下命令：

   $ rosa edit machinepool --cluster=<cluster_name> <machinepool_ID> --enable-autoscaling --min-replicas=<number> --max-replicas=<number>

   Copy to Clipboard Toggle word wrap

   示例

   在名为 mycluster 的集群上 ID 为 mp1 的机器池上启用自动扩展，其副本数为 2 到 5 个 worker 节点：

   $ rosa edit machinepool --cluster=mycluster mp1 --enable-autoscaling --min-replicas=2 --max-replicas=5

   Copy to Clipboard Toggle word wrap

流程

1. 在 OpenShift Cluster Manager 中，导航到 Cluster List 页面，再选择必须禁用自动扩展的集群。
2. 在所选集群中，选择 Machine pool 选项卡。
3. 点带有自动扩展的机器池末尾的 Options 菜单 ，然后选择 Edit。
4. 在 Edit machine pool 对话框中，取消选择 Enable autoscaling 复选框。
5. 选择 Save 以保存这些更改并从机器池禁用自动扩展。

1. 覆盖 JVM 最大堆大小。
2. 在可能的情况下，促使 JVM 向操作系统释放未使用的内存。
3. 确保正确配置了容器中的所有 JVM 进程。

验证

1. 使用远程 shell 访问 pod：

   $ oc rsh test

   Copy to Clipboard Toggle word wrap

2. 检查是否应用了请求的值：

   $ env | grep MEMORY | sort

   Copy to Clipboard Toggle word wrap

   输出示例

   MEMORY_LIMIT=536870912
   MEMORY_REQUEST=402653184

   Copy to Clipboard Toggle word wrap

1. 使用远程 shell 访问 pod：

   # oc rsh <pod name>

   Copy to Clipboard Toggle word wrap

2. 运行以下命令，查看 /sys/fs/cgroup/memory/memory.oom_control 中的当前 OOM 终止计数：

   $ grep '^oom_kill ' /sys/fs/cgroup/memory/memory.oom_control

   Copy to Clipboard Toggle word wrap

   输出示例

   oom_kill 0

   Copy to Clipboard Toggle word wrap

3. 运行以下命令来引发一个 OOM kill：

   $ sed -e '' </dev/zero

   Copy to Clipboard Toggle word wrap

   输出示例

   Killed

   Copy to Clipboard Toggle word wrap

4. 运行以下命令，查看 /sys/fs/cgroup/memory/memory.oom_control 中的 OOM 终止计数器：

   $ grep '^oom_kill ' /sys/fs/cgroup/memory/memory.oom_control

   Copy to Clipboard Toggle word wrap

   输出示例

   oom_kill 1

   Copy to Clipboard Toggle word wrap

   如果 pod 中的一个或多个进程遭遇 OOM 终止，那么当 pod 随后退出时（不论是否立即发生），它都将会具有原因为 OOMKilled 的 Failed 阶段。被 OOM 终止的 pod 可能会根据 restartPolicy 的值重启。如果不重启，复制控制器等控制器会看到 pod 的失败状态，并创建一个新 pod 来替换旧 pod。

   使用以下命令获取 pod 状态：

   $ oc get pod test

   Copy to Clipboard Toggle word wrap

   输出示例

   NAME      READY     STATUS      RESTARTS   AGE
   test      0/1       OOMKilled   0          1m

   Copy to Clipboard Toggle word wrap

   • 如果 pod 没有重启，请运行以下命令来查看 pod:

     $ oc get pod test -o yaml

     Copy to Clipboard Toggle word wrap

     输出示例

     ...
     status:
       containerStatuses:
       - name: test
         ready: false
         restartCount: 0
         state:
           terminated:
             exitCode: 137
             reason: OOMKilled
       phase: Failed

     Copy to Clipboard Toggle word wrap

   • 如果重启，运行以下命令来查看 pod:

     $ oc get pod test -o yaml

     Copy to Clipboard Toggle word wrap

     输出示例

     ...
     status:
       containerStatuses:
       - name: test
         ready: true
         restartCount: 1
         lastState:
           terminated:
             exitCode: 137
             reason: OOMKilled
         state:
           running:
       phase: Running

     Copy to Clipboard Toggle word wrap