Networking Operators

流程

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. 如果要从 OpenShift Container Platform Web 控制台中的 Developer 视角查看指标，请完成以下任务：

   1. 点 Observe。
   2. 要查看特定项目的指标，请在 Project: 列表中选择该项目。例如，openshift-nmstate。
   3. 点 Metrics 选项卡。

   4. 要在图表中视觉化指标，请从 Select query 列表中选择查询，或者通过选择 Show PromQL 根据所选查询创建自定义 PromQL 查询。

      注意

      在 Developer 视角中，您一次只能运行一个查询。

2. 如果要从 OpenShift Container Platform Web 控制台中的 Administrator 视角查看指标，请完成以下任务：

   1. 点 Observe → Metrics。
   2. 在 Expression 字段中输入 kubernetes_nmstate_features_applied。
   3. 点 Add query，然后点 Run query。

3. 要探索视觉化的指标，请执行以下操作之一：

   1. 要放大图表并更改时间范围，请执行以下任何任务：

      • 要可视化选择时间范围，请单击并拖动图表。
      • 要选择时间范围，请使用控制台左上角的菜单。
   2. 要重置时间范围，请选择 Reset Zoom。
   3. 要显示所有查询在特定时间点的输出，请将鼠标光标停留在图表中的对应点上。查询输出显示在弹出窗口中。

流程

1. 要从 OperatorHub 部署 AWS Load Balancer Operator on-demand，请运行以下命令创建一个 Subscription 对象：

   $ 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. 运行以下命令来创建 bpfman 命名空间：

   $ cat << EOF| oc create -f -
   apiVersion: v1
   kind: Namespace
   metadata:
     labels:
       pod-security.kubernetes.io/enforce: privileged
       pod-security.kubernetes.io/enforce-version: v1.24
     name: bpfman
   EOF

   Copy to Clipboard Toggle word wrap

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

   $ cat << EOF| oc create -f -
   apiVersion: operators.coreos.com/v1
   kind: OperatorGroup
   metadata:
     name: bpfman-operators
     namespace: bpfman
   EOF

   Copy to Clipboard Toggle word wrap

3. 订阅 eBPF Manager Operator。

   1. 要为 eBPF Manager Operator 创建 Subscription CR，请输入以下命令：

      $ cat << EOF| oc create -f -
      apiVersion: operators.coreos.com/v1alpha1
      kind: Subscription
      metadata:
        name: bpfman-operator
        namespace: bpfman
      spec:
        name: bpfman-operator
        channel: alpha
        source: community-operators
        sourceNamespace: openshift-marketplace
      EOF

      Copy to Clipboard Toggle word wrap

4. 要验证是否已安装 Operator，请输入以下命令：

   $ oc get ip -n bpfman

   Copy to Clipboard Toggle word wrap

   输出示例

   NAME            CSV                                 APPROVAL    APPROVED
   install-ppjxl   security-profiles-operator.v0.8.5   Automatic   true

   Copy to Clipboard Toggle word wrap

5. 要验证 Operator 的版本，请输入以下命令：

   $ oc get csv -n bpfman

   Copy to Clipboard Toggle word wrap

   输出示例

   NAME                                DISPLAY                      VERSION   REPLACES                            PHASE
   bpfman-operator.v0.5.0              eBPF Manager Operator              0.5.0     bpfman-operator.v0.4.2              Succeeded

   Copy to Clipboard Toggle word wrap

流程

1. 安装 eBPF Manager Operator：

   1. 在 OpenShift Container Platform Web 控制台中，点击 Operators → OperatorHub。
   2. 从可用的 Operator 列表中选择 eBPF Manager Operator，如果提示输入 Show community Operator，请点 Continue。
   3. 点 Install。
   4. 在 Install Operator 页面中，在 Installed Namespace 下选择 Operator recommended Namespace。
   5. 点 Install。

2. 验证 eBPF Manager Operator 是否已成功安装：

   1. 导航到 Operators → Installed Operators 页面。

   2. 确保 openshift-ingress-node-firewall 项目中列出的 eBPF Manager Operator 的 Status 为 InstallSucceeded。

      注意

      在安装过程中，Operator 可能会显示 Failed 状态。如果安装过程结束后有 InstallSucceeded 信息，您可以忽略这个 Failed 信息。

      如果 Operator 没有 InstallSucceeded 状态，请按照以下步骤进行故障排除：

      • 检查 Operator Subscriptions 和 Install Plans 选项卡中的 Status 项中是否有任何错误。
      • 进入到 Workloads → Pods 页面，在 bpfman 项目中检查 pod 的日志。

流程

1. 要下载清单，请输入以下命令：

   $ curl -L https://github.com/bpfman/bpfman/releases/download/v0.5.1/go-xdp-counter-install-selinux.yaml -o go-xdp-counter-install-selinux.yaml

   Copy to Clipboard Toggle word wrap

2. 要部署示例 eBPF 应用程序，请输入以下命令：

   $ oc create -f go-xdp-counter-install-selinux.yaml

   Copy to Clipboard Toggle word wrap

   输出示例

   namespace/go-xdp-counter created
   serviceaccount/bpfman-app-go-xdp-counter created
   clusterrolebinding.rbac.authorization.k8s.io/xdp-binding created
   daemonset.apps/go-xdp-counter-ds created
   xdpprogram.bpfman.io/go-xdp-counter-example created
   selinuxprofile.security-profiles-operator.x-k8s.io/bpfman-secure created

   Copy to Clipboard Toggle word wrap

3. 要确认 eBPF 示例应用程序已被成功部署，请输入以下命令：

   $ oc get all -o wide -n go-xdp-counter

   Copy to Clipboard Toggle word wrap

   输出示例

   NAME                          READY   STATUS    RESTARTS   AGE   IP             NODE                                 NOMINATED NODE   READINESS GATES
   pod/go-xdp-counter-ds-4m9cw   1/1     Running   0          44s   10.129.0.92    ci-ln-dcbq7d2-72292-ztrkp-master-1   <none>           <none>
   pod/go-xdp-counter-ds-7hzww   1/1     Running   0          44s   10.130.0.86    ci-ln-dcbq7d2-72292-ztrkp-master-2   <none>           <none>
   pod/go-xdp-counter-ds-qm9zx   1/1     Running   0          44s   10.128.0.101   ci-ln-dcbq7d2-72292-ztrkp-master-0   <none>           <none>
   
   NAME                               DESIRED   CURRENT   READY   UP-TO-DATE   AVAILABLE   NODE SELECTOR   AGE   CONTAINERS       IMAGES                                           SELECTOR
   daemonset.apps/go-xdp-counter-ds   3         3         3       3            3           <none>          44s   go-xdp-counter   quay.io/bpfman-userspace/go-xdp-counter:v0.5.0   name=go-xdp-counter

   Copy to Clipboard Toggle word wrap

4. 要确认示例 XDP 程序正在运行，请输入以下命令：

   $ oc get xdpprogram go-xdp-counter-example

   Copy to Clipboard Toggle word wrap

   输出示例

   NAME                     BPFFUNCTIONNAME   NODESELECTOR   STATUS
   go-xdp-counter-example   xdp_stats         {}             ReconcileSuccess

   Copy to Clipboard Toggle word wrap

5. 要确认 XDP 程序正在收集数据，请输入以下命令：

   $ oc logs <pod_name> -n go-xdp-counter

   Copy to Clipboard Toggle word wrap

   将 <pod_name> 替换为 XDP 程序 pod 的名称，如 go-xdp-counter-ds-4m9cw。

   输出示例

   2024/08/13 15:20:06 15016 packets received
   2024/08/13 15:20:06 93581579 bytes received
   ...

   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