1.4. Submariner multicluster networking 和 service discovery

自定义并应用类似以下示例的 YAML 内容：

apiVersion: submarineraddon.open-cluster-management.io/v1alpha1
kind: SubmarinerConfig
metadata:
    name: submariner
    namespace: <managed-cluster-namespace>
spec:
    gatewayConfig:
      gateways: 1

将 managed-cluster-namespace 替换为受管集群的名称。SubmarinerConfig 的名称必须是 submariner，如示例所示。

此配置将其中一个 worker 节点标记为裸机集群上的 Submariner 网关。

默认情况下，Submariner 使用 IP 安全(IPsec) 在网关节点上的集群之间建立安全隧道。您可以使用默认 IPsec NATT 端口，或者指定您配置的不同端口。当您运行这个步骤时，没有指定 IPsec NATT 端口，4500/UDP 用于连接。

在 Azure CLI 中运行以下命令安装扩展：

az extension add --upgrade -s <path-to-extension>

将 path-to-extension 替换为您下载 .whl 扩展文件的路径。

运行以下命令验证是否使用了 CLI 扩展：

az extension list

如果使用扩展，输出可能类似以下示例：

"experimental": false,
"extensionType": "whl",
"name": "aro",
"path": "<path-to-extension>",
"preview": true,
"version": "1.0.x"

在 Azure CLI 中，运行以下命令来注册 preview 功能：

az feature registration create --namespace Microsoft.RedHatOpenShift --name AdminKubeconfig

运行以下命令来检索管理员 kubeconfig ：

az aro get-admin-kubeconfig -g <resource group> -n <cluster resource name>

注： az aro 命令将 kubeconfig 保存到本地目录，并使用名称 kubeconfig。要使用它，设置环境变量 KUBECONFIG 以匹配文件的路径。请参见以下示例：

export KUBECONFIG=<path-to-kubeconfig>
oc get nodes

运行以下命令，登录到 OpenShift Service on AWS：

rosa login
oc login <rosa-cluster-url>:6443 --username cluster-admin --password <password>

运行以下命令，在 AWS 集群上为 OpenShift Service 创建 kubeconfig ：

oc config view --flatten=true > rosa_kube/kubeconfig

按照 Creating a ManagedClusterSet 在 hub 集群中创建一个 ManagedClusterSet 资源。确保您的 ManagedClusterSet 条目类似以下内容：

apiVersion: cluster.open-cluster-management.io/v1beta2
kind: ManagedClusterSet
metadata:
  name: <managed-cluster-set-name>

将 managed-cluster-set-name 替换为您要创建的 ManagedClusterSet 的名称。

重要：Kubernetes 命名空间的最大字符长度为 63 个字符。可用于 <managed-cluster-set-name> 的最大字符长度为 56 个字符。如果 <managed-cluster-set-name> 的字符长度超过 56 个字符，则 <managed-cluster-set-name> 会从头开始切断。

创建 ManagedClusterSet 后，submariner-addon 会创建一个名为 <managed-cluster-set-name>-broker 的命名空间，并将 Submariner 代理部署到其中。

通过自定义并应用类似以下示例的 YAML 内容，在 <managed-cluster-set-name>-broker 命名空间中的 hub 集群上创建 Broker 配置：

apiVersion: submariner.io/v1alpha1
kind: Broker
metadata:
     name: submariner-broker
     namespace: <managed-cluster-set-name>-broker
     labels:
         cluster.open-cluster-management.io/backup: submariner
spec:
     globalnetEnabled: <true-or-false>

将 managed-cluster-set-name 替换为受管集群的名称。

如果要在 ManagedClusterSet 中启用 Submariner Globalnet，请将 globalnetEnabled 的值设置为 true。

运行以下命令，将一个受管集群添加到 ManagedClusterSet 中：

oc label managedclusters <managed-cluster-name> "cluster.open-cluster-management.io/clusterset=<managed-cluster-set-name>" --overwrite

将 <managed-cluster-name> 替换为您要添加到 ManagedClusterSet 的受管集群的名称。

将 <managed-cluster-set-name> 替换为您要添加受管集群的 ManagedClusterSet 的名称。

自定义并应用类似以下示例的 YAML 内容：

apiVersion: submarineraddon.open-cluster-management.io/v1alpha1
kind: SubmarinerConfig
metadata:
    name: submariner
    namespace: <managed-cluster-namespace>
spec:{}

将 managed-cluster-namespace 替换为受管集群的命名空间。

注： SubmarinerConfig 的名称必须是 submariner，如示例中所示。

通过自定义并应用类似以下示例的 YAML 内容，在受管集群中部署 Submariner：

apiVersion: addon.open-cluster-management.io/v1alpha1
kind: ManagedClusterAddOn
metadata:
     name: submariner
     namespace: <managed-cluster-name>
spec:
     installNamespace: submariner-operator

将 managed-cluster-name 替换为您要使用 Submariner 的受管集群的名称。

ManagedClusterAddOn 的 spec 中的 installNamespace 字段是在受管集群上安装 Submariner 的命名空间。目前，Submariner 必须安装到 submariner-operator 命名空间中。

创建 ManagedClusterAddOn 后，submariner-addon 将 Submariner 部署到受管集群上的 submariner-operator 命名空间。您可以从这个 ManagedClusterAddOn 的状态查看 Submariner 的部署状态。

注： ManagedClusterAddOn 的名称必须是 submariner。

在受管集群中部署了 Submariner 后，您可以通过输入以下命令检查 submarinerr ManagedClusterAddOn 的状态来验证 Submariner 部署状态：

oc -n <managed-cluster-name> get managedclusteraddons submariner -oyaml

将 managed-cluster-name 替换为受管集群的名称。

在 Submariner ManagedClusterAddOn 的状态中，三个条件代表 Submariner 的部署状态：

使用以下命令，在 ManagedClusterSet 中的受管集群中应用 nginx 服务实例：

oc -n default create deployment nginx --image=nginxinc/nginx-unprivileged:stable-alpine
oc -n default expose deployment nginx --port=8080

通过输入带有类似以下示例的 subctl 工具的命令创建一个 ServiceExport 条目来导出服务：

subctl export service --namespace <service-namespace> <service-name>

将 service-namespace 替换为服务所在的命名空间的名称。在本例中，是 default。

使用您要导出的服务的名称替换 service-name。在本例中是 nginx。

如需有关其他可用标记的更多信息，请参阅 Submariner 文档中的 导出。

在不同的受管集群中运行以下命令，确认它可以访问 nginx 服务：

oc -n default run --generator=run-pod/v1 tmp-shell --rm -i --tty --image quay.io/submariner/nettest -- /bin/bash curl nginx.default.svc.clusterset.local:8080

对您要从中删除 Submariner 的其他集群重复这些步骤。

提示： 您可以通过选择多个集群并点 Actions，从同一集群集中的多个集群中删除 Submariner 附加组件。选择 Uninstall Submariner add-ons。

运行以下命令来删除集群的 Submariner 部署：

oc -n <managed-cluster-namespace> delete managedclusteraddon submariner

将 managed-cluster-namespace 替换为受管集群的命名空间。

运行以下命令删除集群的云资源：

oc -n <managed-cluster-namespace> delete submarinerconfig submariner

将 managed-cluster-namespace 替换为受管集群的命名空间。

运行以下命令删除集群集以删除代理详情：

oc delete managedclusterset <managedclusterset>

将 managedclusterset 替换为受管集群集的名称。

运行以下命令列出集群中保留的所有 Submariner 资源：

oc get cluster <CLUSTER_NAME> grep submariner

将 CLUSTER_NAME 替换为集群的名称。

输入以下命令删除列表中的任何资源：

oc delete resource <RESOURCE_NAME> cluster <CLUSTER_NAME>

将 RESOURCE_NAME 替换为您要删除的 Submariner 资源的名称。