附加组件

运行以下命令来检索 <broker-namespace> ：

oc get ManagedClusterSet <cluster-set-name> -o jsonpath="{.metadata.annotations['cluster\.open-cluster-management\.io/submariner-broker-ns']}"

创建一个 submariner-broker 对象，通过创建名为 submariner-broker 的 YAML 文件来指定 Globalnet 配置。在 YAML 文件中添加类似以下行的内容：

apiVersion: submariner.io/v1alpha1
kind: Broker
metadata:
  name: submariner-broker
  namespace: <broker-namespace>
spec:
  globalnetEnabled: <true-or-false>

将 broker-namespace 替换为代理命名空间的名称。

将 true-or-false 替换为 true 来启用 Globalnet。

注： 元数据 name 参数必须是 submariner-broker。

输入以下命令将该文件应用到 YAML 文件中：

oc apply -f submariner-broker.yaml

自定义并应用类似以下示例的 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

选择 Kubeconfig Import 模式，并在 Kubeconfig 窗口中输入 kubeconfig 文件中的内容。按照控制台中的说明完成导入。

您可以通过进入到 Infrastructure > Clusters 来验证 Azure Red Hat OpenShift 集群是否已成功导入。

运行以下命令，创建一个新节点来运行 Submariner 网关：

rosa create machinepool --cluster=<cluster_name> --name=sm-gw-mp --replicas=<number of Submariner gateway > --labels='submariner.io/gateway=true'

运行以下命令，登录到 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

选择 Kubeconfig Import 模式，并在 Kubeconfig 窗口中输入 kubeconfig 文件中的内容。按照控制台中的说明完成导入。

您可以通过进入到 Infrastructure > Clusters 来验证 OpenShift Service on AWS 集群是否已成功导入。

按照 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 资源的名称。

通过创建类似以下 YAML 内容的 secret 来指定存储备份镜像的存储库：

apiVersion: v1
kind: Secret
metadata:
  name: restic-config
type: Opaque
stringData:
  RESTIC_REPOSITORY: <my-restic-repository>
  RESTIC_PASSWORD: <my-restic-password>
  AWS_ACCESS_KEY_ID: access
  AWS_SECRET_ACCESS_KEY: password

将 my-restic-repository 替换为您要存储备份文件的 S3 存储桶存储库的位置。

将 my-restic-password 替换为访问存储库所需的加密密钥。

如果需要，将 access 和 password 替换为您的供应商凭证。如需更多信息，请参阅准备新存储库。

如果您需要准备新存储库，请参阅为流程准备新存储库。如果使用这个步骤，请跳过运行 restic init 命令的步骤来初始化存储库。VolSync 在第一个备份过程中自动初始化存储库。

重要：当将多个持久性卷声明备份到同一 S3 存储桶时，存储桶的路径对于每个持久性卷声明来说必须是唯一的。每个持久性卷声明都使用单独的 ReplicationSource 备份，每个声明都需要单独的 restic-config secret。

通过共享相同的 S3 存储桶，每个 ReplicationSource 具有对整个 S3 存储桶的写入访问权限。

通过创建类似以下 YAML 内容的 ReplicationSource 对象来配置备份策略：

apiVersion: volsync.backube/v1alpha1
kind: ReplicationSource
metadata:
  name: mydata-backup
spec:
  sourcePVC: <source>
  trigger:
    schedule: "*/30 * * * *" #\*
  restic:
    pruneIntervalDays: 14
    repository: <restic-config>
    retain:
      hourly: 6
      daily: 5
      weekly: 4
      monthly: 2
      yearly: 1
    copyMethod: Clone
  # The StorageClass to use when creating the PiT copy (same as source PVC if omitted)
  #storageClassName: my-sc-name
  # The VSC to use if the copy method is Snapshot (default if omitted)
  #volumeSnapshotClassName: my-vsc-name

使用您要备份的持久性卷声明替换 source。

将 schedule 值替换为运行备份的频率。这个示例有每 30 分钟的调度。如需更多信息，请参阅调度同步。

将 PruneIntervalDays 值替换为重新打包数据实例之间经过的天数，以节省空间。修剪操作可在其运行时生成大量 I/O 流量。

将 restic-config 替换为在第 1 步中创建的 secret 的名称。

将 retain 的值设置为备份镜像的保留策略。

最佳实践： 将 Clone 用于 CopyMethod 的值，以确保保存点镜像。

有关备份选项的更多信息，请参阅 VolSync 文档中的备份选项。

创建一个类似以下示例的 ReplicationSource 自定义资源：

apiVersion: volsync.backube/v1alpha1
kind: ReplicationSource
metadata:
  name: <source>
  namespace: <source-ns>
spec:
  sourcePVC: <source-pvc>
  trigger:
    schedule: "*/6 * * * *" #\*
  rclone:
    rcloneConfigSection: <intermediate-s3-bucket>
    rcloneDestPath: <destination-bucket>
    rcloneConfig: <rclone-secret>
    copyMethod: Snapshot
    storageClassName: <my-sc-name>
    volumeSnapshotClassName: <my-vsc>

将 source-pvc 替换为复制源自定义资源的名称。

将 source-ns 替换为源所在持久性卷声明的命名空间。

使用您要复制的持久性卷声明替换 source。

将 schedule 值替换为运行复制的频率。这个示例有每 6 分钟的调度。这个值必须在引号内。如需更多信息，请参阅调度同步。

将 intermediate-s3-bucket 替换为 Rclone 配置文件配置部分的路径。

将 destination-bucket 替换为您要复制文件的对象存储桶的路径。

将 rclone-secret 替换为包含您的 Rclone 配置信息的 secret 名称。

将 copyMethod 的值设置为 Clone、Direct 或 Snapshot。这个值指定是否生成点时复制，如果是，则使用什么方法生成它。

将 my-sc-name 替换为您要用于点复制的存储类的名称。如果没有指定，则使用源卷的存储类。

如果您将 my-vsc 指定为 copyMethod，则将 my-vsc 替换为 VolumeSnapshotClass 的名称。对于其他类型的 copyMethod，这并不是必需的。

创建一个类似以下示例的 ReplicationDestination 自定义资源：

apiVersion: volsync.backube/v1alpha1
kind: ReplicationDestination
metadata:
  name: database-destination
  namespace: dest
spec:
  trigger:
    schedule: "3,9,15,21,27,33,39,45,51,57 * * * *" #/*
  rclone:
    rcloneConfigSection: <intermediate-s3-bucket>
    rcloneDestPath: <destination-bucket>
    rcloneConfig: <rclone-secret>
    copyMethod: Snapshot
    accessModes: [ReadWriteOnce]
    capacity: 10Gi
    storageClassName: <my-sc>
    volumeSnapshotClassName: <my-vsc>

将 schedule 值替换为将复制移到目的地的频率。源和目标的调度必须是偏移的，以允许数据在从目的地拉取前完成复制。这个示例有每 6 分钟的调度，将偏移 3 分钟。这个值必须在引号内。如需更多信息，请参阅调度同步。

将 intermediate-s3-bucket 替换为 Rclone 配置文件配置部分的路径。

将 destination-bucket 替换为您要复制文件的对象存储桶的路径。

将 rclone-secret 替换为包含您的 Rclone 配置信息的 secret 名称。

将 copyMethod 的值设置为 Clone、Direct 或 Snapshot。这个值指定是否生成点时复制，如果是，则使用什么方法生成它。

accessModes 的值指定持久性卷声明的访问模式。有效值为 ReadWriteOnce 或 ReadWriteMany。

capacity 指定目标卷的大小，它必须足够大来包含传入的数据。

将 my-sc 替换为您要用作点时副本的存储类的名称。如果没有指定，则使用系统存储类。

如果您将 my-vsc 指定为 copyMethod，则将 my-vsc 替换为 VolumeSnapshotClass 的名称。对于其他类型的 copyMethod，这并不是必需的。如果没有包括，则使用系统默认 VolumeSnapshotClass。