OCM Cluster-Gateway Manager

OCM Cluster-Gateway Manager 插件在管理集群中安装了一个 operator 组件,帮助管理员通过自定义资源 “ClusterGatewayConfiguration” 轻松操作集群网关实例的配置。 警告:此插件将在首次安装时重新启动集群网关实例。

Cluster-Gateway Manager 可以做什么?

一般来说,它可以在以下几个方面来帮助我们:

  • 自动轮换集群网关服务器的 TLS 证书。
  • 自动发现新集群。
  • 结构化集群网关的组件配置。
  • 管理集群网关访问每个集群的“出口认证”。

请注意,由 cluster-gateway 代理的请求将使用open-cluster-management-managed-serviceaccount/cluster-gateway的身份访问托管集群,并且默认情况下具有 cluster-admin 权限,因此请注意这一点。

如何确定插件是正常运转的?

运行以下命令来检查插件的健康状况:

  1. $ kubectl -n <cluster> get managedclusteraddon
  2. kubectl get managedclusteraddon -A
  3. NAMESPACE NAME AVAILABLE DEGRADED PROGRESSING
  4. <cluster> cluster-gateway True
  5. <cluster> cluster-proxy True
  6. <cluster> managed-serviceaccount True

如果一次要浏览的集群太多,请通过下面的命令来安装二进制命令clusteradm

  1. curl -L https://raw.githubusercontent.com/open-cluster-management-io/clusteradm/main/install.sh | bash

然后通过运行下面的命令来获取多集群插件状态:

  1. $ clusteradm get addon
  2. <ManagedCluster>
  3. └── managed1
  4. └── cluster-gateway
  5. ├── <Status>
  6. ├── Available -> true
  7. ├── ...
  8. ├── <ManifestWork>
  9. └── clusterrolebindings.rbac.authorization.k8s.io
  10. ├── open-cluster-management:cluster-gateway:default (applied)
  11. └── ...
  12. └── cluster-proxy
  13. ├── <Status>
  14. ├── Available -> true
  15. ├── ...
  16. ├── <ManifestWork>
  17. └── ...
  18. └── managed-serviceaccount
  19. └── <Status>
  20. ├── Available -> true
  21. ├── ...
  22. └── <ManifestWork>
  23. └── ...

ClusterGatewayConfiguration API 配置示例

你可以通过以下命令来查看或编辑集群网关部署的整体配置信息:

  1. $ kubectl get clustergatewayconfiguration -o yaml
  2. apiVersion: v1
  3. kind: List
  4. items:
  5. - apiVersion: proxy.open-cluster-management.io/v1alpha1
  6. kind: ClusterGatewayConfiguration
  7. metadata: ...
  8. spec:
  9. egress:
  10. clusterProxy:
  11. credentials:
  12. namespace: open-cluster-management-addon
  13. proxyClientCASecretName: proxy-server-ca
  14. proxyClientSecretName: proxy-client
  15. proxyServerHost: proxy-entrypoint.open-cluster-management-addon
  16. proxyServerPort: 8090
  17. type: ClusterProxy
  18. image: oamdev/cluster-gateway:v1.1.11
  19. installNamespace: vela-system
  20. secretManagement:
  21. managedServiceAccount:
  22. name: cluster-gateway
  23. type: ManagedServiceAccount
  24. secretNamespace: open-cluster-management-credentials