网络

流程

1. 选择 Operators → OperatorHub。
2. 在 All Items 下面的搜索字段中, 输入 nmstate 并点 Enter 来搜索 Kubernetes NMState Operator。
3. 点 Kubernetes NMState Operator 搜索结果。
4. 点 Install 打开 Install Operator 窗口。
5. 点 Install 安装 Operator。
6. Operator 安装完成后，点 View Operator。
7. 在 Provided APIs 下，点 Create Instance 打开对话框以创建 kubernetes-nmstate 实例。

8. 在对话框的 Name 字段中，确保实例的名称是 nmstate.

   注意

   名称限制是一个已知问题。该实例是整个集群的单个实例。

9. 接受默认设置并点 Create 创建实例。

流程

1. 创建 nmstate Operator 命名空间：

   $ cat << EOF | oc apply -f -
   apiVersion: v1
   kind: Namespace
   metadata:
     name: openshift-nmstate
   spec:
     finalizers:
     - kubernetes
   EOF

   Copy to Clipboard Toggle word wrap

2. 创建 OperatorGroup ：

   $ cat << EOF | oc apply -f -
   apiVersion: operators.coreos.com/v1
   kind: OperatorGroup
   metadata:
     name: openshift-nmstate
     namespace: openshift-nmstate
   spec:
     targetNamespaces:
     - openshift-nmstate
   EOF

   Copy to Clipboard Toggle word wrap

3. 订阅 nmstate Operator:

   $ cat << EOF| oc apply -f -
   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: kubernetes-nmstate-operator
     namespace: openshift-nmstate
   spec:
     channel: stable
     installPlanApproval: Automatic
     name: kubernetes-nmstate-operator
     source: redhat-operators
     sourceNamespace: openshift-marketplace
   EOF

   Copy to Clipboard Toggle word wrap

4. 确认 nmstate Operator 部署的 ClusterServiceVersion (CSV) 状态等于 Succeeded ：

   $ oc get clusterserviceversion -n openshift-nmstate \
    -o custom-columns=Name:.metadata.name,Phase:.status.phase

   Copy to Clipboard Toggle word wrap

5. 创建 nmstate Operator 实例：

   $ cat << EOF | oc apply -f -
   apiVersion: nmstate.io/v1
   kind: NMState
   metadata:
     name: nmstate
   EOF

   Copy to Clipboard Toggle word wrap

6. 如果您的集群因为 DNS 连接问题导致 DNS 健康检查探测出现问题，您可以在 NMState CRD 中添加以下 DNS 主机名配置，以便在可以解决这些问题的健康检查中构建：

   apiVersion: nmstate.io/v1
   kind: NMState
   metadata:
     name: nmstate
   spec:
     probeConfiguration:
       dns:
         host: redhat.com
   # ...

   Copy to Clipboard Toggle word wrap

   1. 运行以下命令，将 DNS 主机名配置应用到集群网络。确保将 <filename> 替换为 CRD 文件的名称。

      $ oc apply -f <filename>.yaml

      Copy to Clipboard Toggle word wrap

   2. 运行以下命令，监控 nmstate CRD，直到资源达到 Available 条件。确保为 the- timeout 选项设置了一个值，以便在此设置的最大等待时间中没有满足 Available 条件时，命令会超时并生成错误消息。

      $ oc wait --for=condition=Available nmstate/nmstate --timeout=600s

      Copy to Clipboard Toggle word wrap

验证

1. 输入以下命令验证 NMState Operator 的所有 pod 是否具有 Running 状态：

   $ oc get pod -n openshift-nmstate

   Copy to Clipboard Toggle word wrap

流程

1. 您可以通过运行以下命令来创建 Subscription 对象，以按需部署 AWS Load Balancer Operator：

   $ oc -n aws-load-balancer-operator get sub aws-load-balancer-operator --template='{{.status.installplan.name}}{{"\n"}}'

   Copy to Clipboard Toggle word wrap

2. 运行以下命令，检查安装计划的状态是否为 Complete ：

   $ oc -n aws-load-balancer-operator get ip <install_plan_name> --template='{{.status.phase}}{{"\n"}}'

   Copy to Clipboard Toggle word wrap

3. 运行以下命令，查看 aws-load-balancer-operator-controller-manager 部署的状态：

   $ oc get -n aws-load-balancer-operator deployment/aws-load-balancer-operator-controller-manager

   Copy to Clipboard Toggle word wrap

   输出示例

   NAME                                           READY     UP-TO-DATE   AVAILABLE   AGE
   aws-load-balancer-operator-controller-manager  1/1       1            1           23h

   Copy to Clipboard Toggle word wrap

流程

1. 运行以下命令来创建 aws-load-balancer-operator 项目：

   $ oc new-project aws-load-balancer-operator

   Copy to Clipboard Toggle word wrap

2. 运行以下命令来创建 OperatorGroup 对象：

   $ cat <<EOF | oc apply -f -
   apiVersion: operators.coreos.com/v1
   kind: OperatorGroup
   metadata:
     name: aws-load-balancer-operator
     namespace: aws-load-balancer-operator
   spec:
     targetNamespaces: []
   EOF

   Copy to Clipboard Toggle word wrap

3. 运行以下命令来创建 Subscription 对象：

   $ cat <<EOF | oc apply -f -
   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: aws-load-balancer-operator
     namespace: aws-load-balancer-operator
   spec:
     channel: stable-v1
     name: aws-load-balancer-operator
     source: redhat-operators
     sourceNamespace: openshift-marketplace
     config:
       env:
       - name: ROLEARN
         value: "<albo_role_arn>" 

   1

   
   EOF

   Copy to Clipboard Toggle word wrap

   1

   指定 CredentialsRequest 中使用的 ARN 角色，以便为 AWS Load Balancer Operator 置备 AWS 凭证。一个 <albo_role_arn> 示例是 arn:aws:iam::<aws_account_number>:role/albo-operator。

   注意

   AWS Load Balancer Operator 会在进入 Available 状态前等待创建 secret。

流程

1. 在 OpenShift Container Platform Web 控制台中进入 Operators → OperatorHub。
2. 选择 AWS Load Balancer Operator。您可以使用 Filter by keyword 文本框，或者使用过滤器列表从 Operator 列表搜索 AWS Load Balancer Operator。
3. 选择 aws-load-balancer-operator 命名空间。

4. 在 Install Operator 页面中，选择以下选项：

   1. 更新频道为 stable-v1。
   2. 安装模式 为 All namespaces on the cluster (default)。
   3. Installed Namespace 为 aws-load-balancer-operator。如果 aws-load-balancer-operator 命名空间不存在，它会在 Operator 安装过程中创建。
   4. 选择 Update approval 为 Automatic 或 Manual。默认情况下，Update approval 设置为 Automatic。如果选择自动更新，Operator Lifecycle Manager(OLM)将自动升级 Operator 的运行实例，而无需任何干预。如果选择手动更新，OLM 将创建一个更新请求。作为集群管理员，您必须手动批准该更新请求，以便将 Operator 更新至新版本。
5. 点 Install。

流程

1. 创建一个 Namespace 对象：

   1. 创建定义 Namespace 对象的 YAML 文件：

      namespace.yaml 文件示例

      apiVersion: v1
      kind: Namespace
      metadata:
        name: aws-load-balancer-operator

      Copy to Clipboard Toggle word wrap

   2. 运行以下命令来创建 Namespace 对象：

      $ oc apply -f namespace.yaml

      Copy to Clipboard Toggle word wrap

2. 创建一个 OperatorGroup 对象：

   1. 创建定义 OperatorGroup 对象的 YAML 文件：

      operatorgroup.yaml 文件示例

      apiVersion: operators.coreos.com/v1
      kind: OperatorGroup
      metadata:
        name: aws-lb-operatorgroup
        namespace: aws-load-balancer-operator
      spec:
        upgradeStrategy: Default

      Copy to Clipboard Toggle word wrap

   2. 运行以下命令来创建 OperatorGroup 对象：

      $ oc apply -f operatorgroup.yaml

      Copy to Clipboard Toggle word wrap

3. 创建 Subscription 对象：

   1. 创建定义 Subscription 对象的 YAML 文件：

      subscription.yaml 文件示例

      apiVersion: operators.coreos.com/v1alpha1
      kind: Subscription
      metadata:
        name: aws-load-balancer-operator
        namespace: aws-load-balancer-operator
      spec:
        channel: stable-v1
        installPlanApproval: Automatic
        name: aws-load-balancer-operator
        source: redhat-operators
        sourceNamespace: openshift-marketplace

      Copy to Clipboard Toggle word wrap

   2. 运行以下命令来创建 Subscription 对象：

      $ oc apply -f subscription.yaml

      Copy to Clipboard Toggle word wrap

验证

1. 从订阅中获取安装计划的名称：

   $ oc -n aws-load-balancer-operator \
     get subscription aws-load-balancer-operator \
     --template='{{.status.installplan.name}}{{"\n"}}'

   Copy to Clipboard Toggle word wrap

2. 检查安装计划的状态：

   $ oc -n aws-load-balancer-operator \
     get ip <install_plan_name> \
     --template='{{.status.phase}}{{"\n"}}'

   Copy to Clipboard Toggle word wrap

   输出必须是 Complete。

流程

1. 创建定义 AWSLoadBalancerController 对象的 YAML 文件：

   sample-aws-lb.yaml 文件示例

   apiVersion: networking.olm.openshift.io/v1
   kind: AWSLoadBalancerController 

   1

   
   metadata:
     name: cluster 

   2

   
   spec:
     subnetTagging: Auto 

   3

   
     additionalResourceTags: 

   4

   
     - key: example.org/security-scope
       value: staging
     ingressClass: alb 

   5

   
     config:
       replicas: 2 

   6

   
     enabledAddons: 

   7

   
       - AWSWAFv2 

   8

   Copy to Clipboard Toggle word wrap

   1

   定义 AWSLoadBalancerController 对象。

   2

   定义 AWS Load Balancer Controller 名称。此实例名称作为后缀添加到所有相关资源。

   3

   配置 AWS Load Balancer Controller 的子网标记方法。以下值有效：

   • Auto ：AWS Load Balancer Operator 决定属于集群的子网，并相应地标记它们。如果内部子网上不存在内部子网标签，Operator 无法正确确定角色。
   • Manual ：您可以使用适当的角色标签手动标记属于集群的子网。如果在用户提供的基础架构上安装集群，则使用这个选项。

   4

   定义在置备 AWS 资源时 AWS Load Balancer Controller 使用的标签。

   5

   定义入口类名称。默认值为 alb。

   6

   指定 AWS Load Balancer Controller 的副本数。

   7

   将注解指定为 AWS Load Balancer Controller 的附加组件。

   8

   启用 alb.ingress.kubernetes.io/wafv2-acl-arn 注解。

2. 运行以下命令来创建 AWSLoadBalancerController 对象：

   $ oc create -f sample-aws-lb.yaml

   Copy to Clipboard Toggle word wrap

3. 创建定义 Deployment 资源的 YAML 文件：

   sample-aws-lb.yaml 文件示例

   apiVersion: apps/v1
   kind: Deployment 

   1

   
   metadata:
     name: <echoserver> 

   2

   
     namespace: echoserver
   spec:
     selector:
       matchLabels:
         app: echoserver
     replicas: 3 

   3

   
     template:
       metadata:
         labels:
           app: echoserver
       spec:
         containers:
           - image: openshift/origin-node
             command:
              - "/bin/socat"
             args:
               - TCP4-LISTEN:8080,reuseaddr,fork
               - EXEC:'/bin/bash -c \"printf \\\"HTTP/1.0 200 OK\r\n\r\n\\\"; sed -e \\\"/^\r/q\\\"\"'
             imagePullPolicy: Always
             name: echoserver
             ports:
               - containerPort: 8080

   Copy to Clipboard Toggle word wrap

   1

   定义部署资源。

   2

   指定部署名称。

   3

   指定部署的副本数量。

4. 创建定义 Service 资源的 YAML 文件：

   service-albo.yaml 文件示例

   apiVersion: v1
   kind: Service 

   1

   
   metadata:
     name: <echoserver> 

   2

   
     namespace: echoserver
   spec:
     ports:
       - port: 80
         targetPort: 8080
         protocol: TCP
     type: NodePort
     selector:
       app: echoserver

   Copy to Clipboard Toggle word wrap

   1

   定义服务资源。

   2

   指定服务名称。

5. 创建定义 Ingress 资源的 YAML 文件：

   ingress-albo.yaml 文件示例

   apiVersion: networking.k8s.io/v1
   kind: Ingress
   metadata:
     name: <name> 

   1

   
     namespace: echoserver
     annotations:
       alb.ingress.kubernetes.io/scheme: internet-facing
       alb.ingress.kubernetes.io/target-type: instance
   spec:
     ingressClassName: alb
     rules:
       - http:
           paths:
             - path: /
               pathType: Exact
               backend:
                 service:
                   name: <echoserver> 

   2

   
                   port:
                     number: 80

   Copy to Clipboard Toggle word wrap

   1

   为 Ingress 资源指定一个名称。

   2

   指定服务名称。

1. 运行以下命令，创建配置映射以在 aws-load-balancer-operator 命名空间中包含证书颁发机构 (CA) 捆绑包：

   $ oc -n aws-load-balancer-operator create configmap trusted-ca

   Copy to Clipboard Toggle word wrap

2. 要将可信 CA 捆绑包注入配置映射中，请运行以下命令将 config.openshift.io/inject-trusted-cabundle=true 标签添加到配置映射中：

   $ oc -n aws-load-balancer-operator label cm trusted-ca config.openshift.io/inject-trusted-cabundle=true

   Copy to Clipboard Toggle word wrap

3. 运行以下命令，更新 AWS Load Balancer Operator 订阅以访问 AWS Load Balancer Operator 部署中的配置映射：

   $ oc -n aws-load-balancer-operator patch subscription aws-load-balancer-operator --type='merge' -p '{"spec":{"config":{"env":[{"name":"TRUSTED_CA_CONFIGMAP_NAME","value":"trusted-ca"}],"volumes":[{"name":"trusted-ca","configMap":{"name":"trusted-ca"}}],"volumeMounts":[{"name":"trusted-ca","mountPath":"/etc/pki/tls/certs/albo-tls-ca-bundle.crt","subPath":"ca-bundle.crt"}]}}}'

   Copy to Clipboard Toggle word wrap

4. 部署 AWS Load Balancer Operator 后，运行以下命令来验证 CA 捆绑包是否已添加到 aws-load-balancer-operator-controller-manager 部署中：

   $ oc -n aws-load-balancer-operator exec deploy/aws-load-balancer-operator-controller-manager -c manager -- bash -c "ls -l /etc/pki/tls/certs/albo-tls-ca-bundle.crt; printenv TRUSTED_CA_CONFIGMAP_NAME"

   Copy to Clipboard Toggle word wrap

   输出示例

   -rw-r--r--. 1 root 1000690000 5875 Jan 11 12:25 /etc/pki/tls/certs/albo-tls-ca-bundle.crt
   trusted-ca

   Copy to Clipboard Toggle word wrap

5. 可选：通过运行以下命令，每次 configmap 发生变化时重启 AWS Load Balancer Operator 的部署：

   $ oc -n aws-load-balancer-operator rollout restart deployment/aws-load-balancer-operator-controller-manager

   Copy to Clipboard Toggle word wrap

流程

1. 创建定义 AWSLoadBalancerController 资源的 YAML 文件：

   add-tls-termination-albc.yaml 文件示例

   apiVersion: networking.olm.openshift.io/v1
   kind: AWSLoadBalancerController
   metadata:
     name: cluster
   spec:
     subnetTagging: Auto
     ingressClass: tls-termination 

   1

   Copy to Clipboard Toggle word wrap

   1

   定义入口类名称。如果集群中没有 ingress 类，AWS Load Balancer Controller 会创建一个。如果 spec.controller 设置为 ingress.k8s.aws/alb，AWS Load Balancer Controller 会协调额外的入口类值。

2. 创建定义 Ingress 资源的 YAML 文件：

   add-tls-termination-ingress.yaml 文件示例

   apiVersion: networking.k8s.io/v1
   kind: Ingress
   metadata:
     name: <example> 

   1

   
     annotations:
       alb.ingress.kubernetes.io/scheme: internet-facing 

   2

   
       alb.ingress.kubernetes.io/certificate-arn: arn:aws:acm:us-west-2:xxxxx 

   3

   
   spec:
     ingressClassName: tls-termination 

   4

   
     rules:
     - host: example.com 

   5

   
       http:
           paths:
             - path: /
               pathType: Exact
               backend:
                 service:
                   name: <example_service> 

   6

   
                   port:
                     number: 80

   Copy to Clipboard Toggle word wrap

   1

   指定入口名称。

   2

   控制器在公共子网中为入口置备负载均衡器，以便通过互联网访问负载均衡器。

   3

   附加到负载均衡器的证书的 Amazon 资源名称(ARN)。

   4

   定义入口类名称。

   5

   定义流量路由的域。

   6

   定义流量路由的服务。

流程

1. 创建一个 IngressClassParams 资源 YAML 文件，如 sample-single-lb-params.yaml，如下所示：

   apiVersion: elbv2.k8s.aws/v1beta1 

   1

   
   kind: IngressClassParams
   metadata:
     name: single-lb-params 

   2

   
   spec:
     group:
       name: single-lb 

   3

   Copy to Clipboard Toggle word wrap

   1

   定义 IngressClassParams 资源的 API 组和版本。

   2

   指定 IngressClassParams 资源名称。

   3

   指定 IngressGroup 资源名称。此类的所有 Ingress 资源都属于此 IngressGroup。

2. 运行以下命令来创建 IngressClassParams 资源：

   $ oc create -f sample-single-lb-params.yaml

   Copy to Clipboard Toggle word wrap

3. 创建 IngressClass 资源 YAML 文件，如 sample-single-lb-class.yaml，如下所示：

   apiVersion: networking.k8s.io/v1 

   1

   
   kind: IngressClass
   metadata:
     name: single-lb 

   2

   
   spec:
     controller: ingress.k8s.aws/alb 

   3

   
     parameters:
       apiGroup: elbv2.k8s.aws 

   4

   
       kind: IngressClassParams 

   5

   
       name: single-lb-params 

   6

   Copy to Clipboard Toggle word wrap

   1

   定义 IngressClass 资源的 API 组和版本。

   2

   指定入口类名称。

   3

   定义控制器名称。ingress.k8s.aws/alb 值表示此类的所有入口资源都应由 AWS Load Balancer Controller 管理。

   4

   定义 IngressClassParams 资源的 API 组。

   5

   定义 IngressClassParams 资源的资源类型。

   6

   定义 IngressClassParams 资源名称。

4. 运行以下命令来创建 IngressClass 资源：

   $ oc create -f sample-single-lb-class.yaml

   Copy to Clipboard Toggle word wrap

5. 创建 AWSLoadBalancerController 资源 YAML 文件，如 sample-single-lb.yaml，如下所示：

   apiVersion: networking.olm.openshift.io/v1
   kind: AWSLoadBalancerController
   metadata:
     name: cluster
   spec:
     subnetTagging: Auto
     ingressClass: single-lb 

   1

   Copy to Clipboard Toggle word wrap

   1

   定义 IngressClass 资源的名称。

6. 运行以下命令来创建 AWSLoadBalancerController 资源：

   $ oc create -f sample-single-lb.yaml

   Copy to Clipboard Toggle word wrap

7. 创建 Ingress 资源 YAML 文件，如 sample-multiple-ingress.yaml，如下所示：

   apiVersion: networking.k8s.io/v1
   kind: Ingress
   metadata:
     name: example-1 

   1

   
     annotations:
       alb.ingress.kubernetes.io/scheme: internet-facing 

   2

   
       alb.ingress.kubernetes.io/group.order: "1" 

   3

   
       alb.ingress.kubernetes.io/target-type: instance 

   4

   
   spec:
     ingressClassName: single-lb 

   5

   
     rules:
     - host: example.com 

   6

   
       http:
           paths:
           - path: /blog 

   7

   
             pathType: Prefix
             backend:
               service:
                 name: example-1 

   8

   
                 port:
                   number: 80 

   9

   
   ---
   apiVersion: networking.k8s.io/v1
   kind: Ingress
   metadata:
     name: example-2
     annotations:
       alb.ingress.kubernetes.io/scheme: internet-facing
       alb.ingress.kubernetes.io/group.order: "2"
       alb.ingress.kubernetes.io/target-type: instance
   spec:
     ingressClassName: single-lb
     rules:
     - host: example.com
       http:
           paths:
           - path: /store
             pathType: Prefix
             backend:
               service:
                 name: example-2
                 port:
                   number: 80
   ---
   apiVersion: networking.k8s.io/v1
   kind: Ingress
   metadata:
     name: example-3
     annotations:
       alb.ingress.kubernetes.io/scheme: internet-facing
       alb.ingress.kubernetes.io/group.order: "3"
       alb.ingress.kubernetes.io/target-type: instance
   spec:
     ingressClassName: single-lb
     rules:
     - host: example.com
       http:
           paths:
           - path: /
             pathType: Prefix
             backend:
               service:
                 name: example-3
                 port:
                   number: 80

   Copy to Clipboard Toggle word wrap

   1

   指定入口名称。

   2

   指明在公共子网中置备的负载均衡器，以访问互联网。

   3

   指定在负载均衡器收到请求时，来自多个入口资源的规则的顺序匹配。

   4

   表示负载均衡器将针对 OpenShift Container Platform 节点为目标，以访问该服务。

   5

   指定属于此入口的入口类。

   6

   定义用于请求路由的域名。

   7

   定义必须路由到服务的路径。

   8

   定义提供 Ingress 资源中配置的端点的服务名称。

   9

   定义服务上提供端点的端口。

8. 运行以下命令来创建 Ingress 资源：

   $ oc create -f sample-multiple-ingress.yaml

   Copy to Clipboard Toggle word wrap

1. 运行以下命令，检查安装计划的名称，如 install-zcvlr ：

   $ oc -n external-dns-operator get sub external-dns-operator -o yaml | yq '.status.installplan.name'

   Copy to Clipboard Toggle word wrap

2. 运行以下命令，检查安装计划的状态是否为 Complete ：

   $ oc -n external-dns-operator get ip <install_plan_name> -o yaml | yq '.status.phase'

   Copy to Clipboard Toggle word wrap

3. 运行以下命令，查看 external-dns-operator 部署的状态：

   $ oc get -n external-dns-operator deployment/external-dns-operator

   Copy to Clipboard Toggle word wrap

   输出示例

   NAME                    READY     UP-TO-DATE   AVAILABLE   AGE
   external-dns-operator   1/1       1            1           23h

   Copy to Clipboard Toggle word wrap

流程

1. 运行以下命令，查看外部 DNS Operator 的日志：

   $ oc logs -n external-dns-operator deployment/external-dns-operator -c external-dns-operator

   Copy to Clipboard Toggle word wrap

流程

1. 在 OpenShift Container Platform Web 控制台中点 Operators → OperatorHub。
2. 点 External DNS Operator。您可以使用 Filter by keyword 文本框或过滤器列表从 Operator 列表中搜索 External DNS Operator。
3. 选择 external-dns-operator 命名空间。
4. 在 External DNS Operator 页面中，点 Install。

5. 在 Install Operator 页面中，确保选择了以下选项：

   1. 将频道更新为 stable-v1。
   2. 安装模式为 A specific name on the cluster。
   3. 安装的命名空间为 external-dns-operator。如果命名空间 external-dns-operator 不存在，它会在 Operator 安装过程中创建。
   4. 将 Approval Strategy 选为 Automatic 或 Manual。默认情况下，批准策略设置为 Automatic。
   5. 点 Install。

流程

1. 创建一个 Namespace 对象：

   1. 创建定义 Namespace 对象的 YAML 文件：

      namespace.yaml 文件示例

      apiVersion: v1
      kind: Namespace
      metadata:
        name: external-dns-operator

      Copy to Clipboard Toggle word wrap

   2. 运行以下命令来创建 Namespace 对象：

      $ oc apply -f namespace.yaml

      Copy to Clipboard Toggle word wrap

2. 创建一个 OperatorGroup 对象：

   1. 创建定义 OperatorGroup 对象的 YAML 文件：

      operatorgroup.yaml 文件示例

      apiVersion: operators.coreos.com/v1
      kind: OperatorGroup
      metadata:
        name: external-dns-operator
        namespace: external-dns-operator
      spec:
        upgradeStrategy: Default
        targetNamespaces:
        - external-dns-operator

      Copy to Clipboard Toggle word wrap

   2. 运行以下命令来创建 OperatorGroup 对象：

      $ oc apply -f operatorgroup.yaml

      Copy to Clipboard Toggle word wrap

3. 创建 Subscription 对象：

   1. 创建定义 Subscription 对象的 YAML 文件：

      subscription.yaml 文件示例

      apiVersion: operators.coreos.com/v1alpha1
      kind: Subscription
      metadata:
        name: external-dns-operator
        namespace: external-dns-operator
      spec:
        channel: stable-v1
        installPlanApproval: Automatic
        name: external-dns-operator
        source: redhat-operators
        sourceNamespace: openshift-marketplace

      Copy to Clipboard Toggle word wrap

   2. 运行以下命令来创建 Subscription 对象：

      $ oc apply -f subscription.yaml

      Copy to Clipboard Toggle word wrap

验证

1. 运行以下命令，从订阅获取安装计划的名称：

   $ oc -n external-dns-operator \
     get subscription external-dns-operator \
     --template='{{.status.installplan.name}}{{"\n"}}'

   Copy to Clipboard Toggle word wrap

2. 运行以下命令，验证安装计划的状态是否为 Complete ：

   $ oc -n external-dns-operator \
     get ip <install_plan_name> \
     --template='{{.status.phase}}{{"\n"}}'

   Copy to Clipboard Toggle word wrap

3. 运行以下命令，验证 external-dns-operator pod 的状态是否为 Running ：

   $ oc -n external-dns-operator get pod

   Copy to Clipboard Toggle word wrap

   输出示例

   NAME                                     READY   STATUS    RESTARTS   AGE
   external-dns-operator-5584585fd7-5lwqm   2/2     Running   0          11m

   Copy to Clipboard Toggle word wrap

4. 运行以下命令，验证订阅的目录源是否为 redhat-operators ：

   $ oc -n external-dns-operator get subscription

   Copy to Clipboard Toggle word wrap

5. 运行以下命令检查 external-dns-operator 版本：

   $ oc -n external-dns-operator get csv

   Copy to Clipboard Toggle word wrap

流程

1. 运行以下命令，检查用户配置文件，如 system:admin。用户配置集必须有权访问 kube-system 命名空间。如果没有凭证，您可以从 kube-system 命名空间中获取凭证，运行以下命令来使用云供应商客户端：

   $ oc whoami

   Copy to Clipboard Toggle word wrap

2. 从 kube-system 命名空间中存在的 aws-creds secret 中获取值。

   $ export AWS_ACCESS_KEY_ID=$(oc get secrets aws-creds -n kube-system  --template={{.data.aws_access_key_id}} | base64 -d)

   Copy to Clipboard Toggle word wrap

   $ export AWS_SECRET_ACCESS_KEY=$(oc get secrets aws-creds -n kube-system  --template={{.data.aws_secret_access_key}} | base64 -d)

   Copy to Clipboard Toggle word wrap

3. 获取路由来检查域：

   $ oc get routes --all-namespaces | grep console

   Copy to Clipboard Toggle word wrap

   输出示例

   openshift-console          console             console-openshift-console.apps.testextdnsoperator.apacshift.support                       console             https   reencrypt/Redirect     None
   openshift-console          downloads           downloads-openshift-console.apps.testextdnsoperator.apacshift.support                     downloads           http    edge/Redirect          None

   Copy to Clipboard Toggle word wrap

4. 获取 DNS 区域列表，并找到与您之前查询的路由域对应的 DNS 区域：

   $ aws route53 list-hosted-zones | grep testextdnsoperator.apacshift.support

   Copy to Clipboard Toggle word wrap

   输出示例

   HOSTEDZONES	terraform	/hostedzone/Z02355203TNN1XXXX1J6O	testextdnsoperator.apacshift.support.	5

   Copy to Clipboard Toggle word wrap

5. 为路由源创建 ExternalDNS 资源：

   $ cat <<EOF | oc create -f -
   apiVersion: externaldns.olm.openshift.io/v1beta1
   kind: ExternalDNS
   metadata:
     name: sample-aws 

   1

   
   spec:
     domains:
     - filterType: Include   

   2

   
       matchType: Exact   

   3

   
       name: testextdnsoperator.apacshift.support 

   4

   
     provider:
       type: AWS 

   5

   
     source:  

   6

   
       type: OpenShiftRoute 

   7

   
       openshiftRouteOptions:
         routerName: default 

   8

   
   EOF

   Copy to Clipboard Toggle word wrap

   1

   定义外部 DNS 资源的名称。

   2

   默认情况下，所有托管区都被选为潜在的目标。您可以包括需要的托管区。

   3

   目标区的域匹配必须是完全准确的（与正则表达式匹配不同）。

   4

   指定您要更新的区域的确切域。路由的主机名必须是指定域的子域。

   5

   定义 AWS Route53 DNS 供应商。

   6

   定义 DNS 记录源的选项。

   7

   定义 OpenShift 路由资源，作为在之前指定的 DNS 供应商中创建的 DNS 记录来源。

   8

   如果源是 OpenShiftRoute，您可以传递 OpenShift Ingress Controller 名称。外部 DNS Operator 在创建 CNAME 记录时，选择该路由器的规范主机名作为目标。

6. 使用以下命令，检查为 OCP 路由创建的记录：

   $ aws route53 list-resource-record-sets --hosted-zone-id Z02355203TNN1XXXX1J6O --query "ResourceRecordSets[?Type == 'CNAME']" | grep console

   Copy to Clipboard Toggle word wrap

流程

1. 运行以下命令，获取您创建的 IAM 角色的 Role ARN，以允许帐户 B 访问帐户 A 的 Route 53 托管区：

   $ aws --profile account-a iam get-role --role-name user-rol1 | head -1

   Copy to Clipboard Toggle word wrap

   输出示例

   ROLE	arn:aws:iam::1234567890123:role/user-rol1	2023-09-14T17:21:54+00:00	3600	/	AROA3SGB2ZRKRT5NISNJN	user-rol1

   Copy to Clipboard Toggle word wrap

2. 运行以下命令，找到用于帐户 A 凭证的私有托管区：

   $ aws --profile account-a route53 list-hosted-zones | grep testextdnsoperator.apacshift.support

   Copy to Clipboard Toggle word wrap

   输出示例

   HOSTEDZONES	terraform	/hostedzone/Z02355203TNN1XXXX1J6O	testextdnsoperator.apacshift.support. 5

   Copy to Clipboard Toggle word wrap

3. 运行以下命令来创建 ExternalDNS 对象：

   $ cat <<EOF | oc create -f -
   apiVersion: externaldns.olm.openshift.io/v1beta1
   kind: ExternalDNS
   metadata:
     name: sample-aws
   spec:
     domains:
     - filterType: Include
       matchType: Exact
       name: testextdnsoperator.apacshift.support
     provider:
       type: AWS
       aws:
         assumeRole:
           arn: arn:aws:iam::12345678901234:role/user-rol1 

   1

   
     source:
       type: OpenShiftRoute
       openshiftRouteOptions:
         routerName: default
   EOF

   Copy to Clipboard Toggle word wrap

   1

   指定 Role ARN，以便在帐户 A 中创建 DNS 记录。

4. 使用以下命令，检查为 OpenShift Container Platform (OCP) 路由创建的记录：

   $ aws --profile account-a route53 list-resource-record-sets --hosted-zone-id Z02355203TNN1XXXX1J6O --query "ResourceRecordSets[?Type == 'CNAME']" | grep console-openshift-console

   Copy to Clipboard Toggle word wrap

流程

1. 运行以下命令，从 kube-system 命名空间中获取凭证以使用云供应商客户端：

   $ CLIENT_ID=$(oc get secrets azure-credentials  -n kube-system  --template={{.data.azure_client_id}} | base64 -d)

   Copy to Clipboard Toggle word wrap

   $ CLIENT_SECRET=$(oc get secrets azure-credentials  -n kube-system  --template={{.data.azure_client_secret}} | base64 -d)

   Copy to Clipboard Toggle word wrap

   $ RESOURCE_GROUP=$(oc get secrets azure-credentials  -n kube-system  --template={{.data.azure_resourcegroup}} | base64 -d)

   Copy to Clipboard Toggle word wrap

   $ SUBSCRIPTION_ID=$(oc get secrets azure-credentials  -n kube-system  --template={{.data.azure_subscription_id}} | base64 -d)

   Copy to Clipboard Toggle word wrap

   $ TENANT_ID=$(oc get secrets azure-credentials  -n kube-system  --template={{.data.azure_tenant_id}} | base64 -d)

   Copy to Clipboard Toggle word wrap

2. 运行以下命令来登录到 Azure：

   $ az login --service-principal -u "${CLIENT_ID}" -p "${CLIENT_SECRET}" --tenant "${TENANT_ID}"

   Copy to Clipboard Toggle word wrap

3. 运行以下命令来获取路由列表：

   $ oc get routes --all-namespaces | grep console

   Copy to Clipboard Toggle word wrap

   输出示例

   openshift-console          console             console-openshift-console.apps.test.azure.example.com                       console             https   reencrypt/Redirect     None
   openshift-console          downloads           downloads-openshift-console.apps.test.azure.example.com                     downloads           http    edge/Redirect          None

   Copy to Clipboard Toggle word wrap

4. 获取 DNS 区域列表。

   1. 对于公共 DNS 区域，请运行以下命令：

      $ az network dns zone list --resource-group "${RESOURCE_GROUP}"

      Copy to Clipboard Toggle word wrap

   2. 对于私有 DNS 区域，请运行以下命令：

      $ az network private-dns zone list -g "${RESOURCE_GROUP}"

      Copy to Clipboard Toggle word wrap

5. 创建一个 YAML 文件，如 external-dns-sample-azure.yaml，该文件定义 ExternalDNS 对象：

   external-dns-sample-azure.yaml 文件示例

   apiVersion: externaldns.olm.openshift.io/v1beta1
   kind: ExternalDNS
   metadata:
     name: sample-azure 

   1

   
   spec:
     zones:
     - "/subscriptions/1234567890/resourceGroups/test-azure-xxxxx-rg/providers/Microsoft.Network/dnszones/test.azure.example.com" 

   2

   
     provider:
       type: Azure 

   3

   
     source:
       openshiftRouteOptions: 

   4

   
         routerName: default 

   5

   
       type: OpenShiftRoute 

   6

   Copy to Clipboard Toggle word wrap

   1

   指定外部 DNS 名称。

   2

   定义区域 ID。对于私有 DNS 区域，将 dnszones 更改为 privateDnsZones。

   3

   定义提供程序类型。

   4

   您可以定义 DNS 记录源的选项。

   5

   如果源类型是 OpenShiftRoute，您可以传递 OpenShift Ingress Controller 名称。外部 DNS 在创建 CNAME 记录时，选择该路由器的规范主机名作为目标。

   6

   将 route 资源定义为 Azure DNS 记录的来源。