5.7. 通过部署带有集群配置的应用程序来配置 OpenShift 集群

流程

1. 在 Web 控制台的 Administrator 视角中，进入到 Operators Installed Operators Red Hat OpenShift GitOps Subscription。
2. 点 Actions 下拉菜单，然后点 Edit Subscription。

3. 在 openshift-gitops-operator 订阅详情页面的 YAML 选项卡下，通过将 Argo CD 实例的命名空间添加到 spec 部分中的 ARGOCD_CLUSTER_CONFIG_NAMESPACES 环境变量来编辑 Subscription YAML 文件：

   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: openshift-gitops-operator
     namespace: openshift-operators
   ...
   spec:
     config:
       env:
       - name: ARGOCD_CLUSTER_CONFIG_NAMESPACES
         value: openshift-gitops, <list of namespaces of cluster-scoped Argo CD instances>
   ...

4. 要验证 Argo 实例是否已配置有集群角色来管理集群范围的资源，请执行以下步骤：

   1. 进入到 User Management Roles，然后从 Filter 下拉菜单中选择 Cluster-wide Roles。

   2. 使用 Search by name 字段搜索 argocd-application-controller。

      Roles 页面显示创建的集群角色。

      提示

      或者，在 OpenShift CLI 中运行以下命令：

      oc auth can-i create oauth -n openshift-gitops --as system:serviceaccount:openshift-gitops:openshift-gitops-argocd-application-controller

      输出 yes 代表 Argo 实例配置了集群角色来管理集群范围的资源。否则，检查您的配置并根据需要执行必要的步骤。

流程

1. 标记现有节点：

   $ oc label node <node-name> node-role.kubernetes.io/infra=""

2. 可选：如果需要，您还可以在基础架构节点上应用污点并隔离工作负载，并防止其他工作负载在这些节点上调度：

   $ oc adm taint nodes -l node-role.kubernetes.io/infra \
   infra=reserved:NoSchedule infra=reserved:NoExecute

3. 在 GitOpsService 自定义资源中添加 runOnInfra 切换：

   apiVersion: pipelines.openshift.io/v1alpha1
   kind: GitopsService
   metadata:
     name: cluster
   spec:
     runOnInfra: true

4. 可选：如果将污点添加到节点，则在 GitOpsService 自定义资源中添加 容限，例如：

     spec:
       runOnInfra: true
       tolerations:
       - effect: NoSchedule
         key: infra
         value: reserved
       - effect: NoExecute
         key: infra
         value: reserved

5. 通过在控制台 UI 中查看 Pods Pod details，验证 openshift-gitops 命名空间中的工作负载现在已调度到基础架构节点上。

流程

1. 在 Argo CD 控制面板中，单击 NEW APP 以添加新 Argo CD 应用。

2. 对于此工作流，使用以下配置创建一个 cluster-configs 应用程序：

   应用程序名称

   cluster-configs

   project

   default

   同步策略

   Manual（手动）

   仓库 URL

   https://github.com/redhat-developer/openshift-gitops-getting-started

   修订

   HEAD

   路径

   cluster

   目的地

   https://kubernetes.default.svc

   命名空间

   spring-petclinic

   Directory Recurse

   checked

3. 单击 CREATE 以创建应用程序。
4. 打开 Web 控制台的 Administrator 视角，并导航到左侧菜单中的 Administration Namespaces。
5. 搜索并选择命名空间，然后在 Label 字段中输入 argocd.argoproj.io/managed-by=openshift-gitops，以便 openshift-gitops 命名空间中的 Argo CD 实例可以管理您的命名空间。

流程

1. 下载 示例应用程序：

   $ git clone git@github.com:redhat-developer/openshift-gitops-getting-started.git

2. 创建应用程序：

   $ oc create -f openshift-gitops-getting-started/argo/app.yaml

3. 运行 oc get 命令以查看所创建的应用程序：

   $ oc get application -n openshift-gitops

4. 在部署应用程序的命名空间中添加标签，以便 openshift-gitops 命名空间中的 Argo CD 实例可以管理它：

   $ oc label namespace spring-petclinic argocd.argoproj.io/managed-by=openshift-gitops

流程

1. 在 Argo CD 仪表板中，cluster-configs Argo CD 应用程序的状态为 Missing 和 OutOfSync。因为应用程序配置了手动同步策略，所以 Argo CD 不会自动同步。
2. 点 cluster-configs 标题上的 SYNC，查看更改，然后点 SYNCHRONIZE。Argo CD 将自动检测 Git 存储库中的任何更改。如果更改了配置，Argo CD 会将 cluster-configs 的状态改为 OutOfSync。您可以修改 Argo CD 的同步策略，以自动将 Git 存储库中的更改应用到集群。
3. 现在，cluster-configs Argo CD 应用程序的状态为 Healthy 和 Synced。点 cluster-configs 标题检查同步资源的详情及其在集群中的状态。
4. 进入到 OpenShift Container Platform Web 控制台并点击 以验证 Red Hat Developer Blog - Kubernetes 的链接现在是否存在。

5. 导航到 Project 页面并搜索 spring-petclinic 命名空间，以验证它是否已添加到集群中。

   集群配置已成功与集群同步。

流程

1. 以 admin 用户身份登录 OpenShift Container Platform Web 控制台。

2. 在 Web 控制台中，选择 User Management Roles Create Role。使用以下 ClusterRole YAML 模板来添加规则来指定额外权限。

   apiVersion: rbac.authorization.k8s.io/v1
   kind: ClusterRole
   metadata:
     name: secrets-cluster-role
   rules:
   - apiGroups: [""]
     resources: ["secrets"]
     verbs: ["*"]

3. 点 Create 添加集群角色。
4. 现在，创建集群角色绑定。在 Web 控制台中，选择 User Management Role Bindings Create Binding。
5. 从 Project 下拉菜单中选择 All Projects。
6. 点 Create binding。
7. 将 Binding type 选择为 Cluster-wide role binding(ClusterRoleBinding)。
8. 为 RoleBinding 名称 输入一个唯一值。
9. 从下拉列表中选择新创建的集群角色或现有集群角色。

10. 选择 Subject 作为 ServiceAccount，并提供 Subject 命名空间和名称。

    1. 主题命名空间:openshift-gitops
    2. 主题名称:openshift-gitops-argocd-application-controller

11. 点 Create。ClusterRoleBinding 对象的 YAML 文件如下：

    kind: ClusterRoleBinding
    apiVersion: rbac.authorization.k8s.io/v1
    metadata:
      name: cluster-role-binding
    subjects:
      - kind: ServiceAccount
        name: openshift-gitops-argocd-application-controller
        namespace: openshift-gitops
    roleRef:
      apiGroup: rbac.authorization.k8s.io
      kind: ClusterRole
      name: admin