第 2 章 启用 Argo CD 插件

流程

1. 在 Backstage 实例的 app-config.yaml 文件中，在 kubernetes 配置下添加以下 customResources 组件以启用 Argo Rollouts 和 AnalysisRuns：

   kubernetes:
     ...
     customResources:
       - group: 'argoproj.io'
         apiVersion: 'v1alpha1'
         plural: 'Rollouts'
       - group: 'argoproj.io'
         apiVersion: 'v1alpha1'
         plural: 'analysisruns'

   Copy to Clipboard Toggle word wrap

2. 为自定义资源授予 ClusterRole 权限。

   注意
   • 如果已经配置了 Backstage Kubernetes 插件，则可能已经授予 Rollouts 和 AnalysisRuns 的 ClusterRole 权限。
   • 使用 准备的清单 为 Kubernetes 和 ArgoCD 插件提供只读 ClusterRole 访问权限。
   1. 如果没有授予 ClusterRole 权限，请使用以下 YAML 清单来创建 ClusterRole ：

   apiVersion: rbac.authorization.k8s.io/v1
   kind: ClusterRole
   metadata:
     name: backstage-read-only
   rules:
     - apiGroups:
         - argoproj.io
       resources:
         - rollouts
         - analysisruns
       verbs:
         - get
         - list

   Copy to Clipboard Toggle word wrap

   1. 使用 kubectl 将清单应用到集群：

      kubectl apply -f <your-clusterrole-file>.yaml

      Copy to Clipboard Toggle word wrap
   2. 确保访问集群的 ServiceAccount 已分配此 ClusterRole。

3. 为 catalog-info.yaml 添加注解来标识 Backstage 的 Kubernetes 资源。

   1. 通过实体 ID 识别资源：

      annotations:
        ...
        backstage.io/kubernetes-id: <BACKSTAGE_ENTITY_NAME>

      Copy to Clipboard Toggle word wrap

   2. （可选） 用于通过命名空间识别资源：

      annotations:
        ...
        backstage.io/kubernetes-namespace: <RESOURCE_NAMESPACE>

      Copy to Clipboard Toggle word wrap

   3. 要使用自定义标签选择器，它覆盖由实体 ID 或命名空间的资源标识：

      annotations:
        ...
        backstage.io/kubernetes-label-selector: 'app=my-app,component=front-end'

      Copy to Clipboard Toggle word wrap
      注意

      确保指定 Kubernetes 资源上的 backstage.io/kubernetes-label-selector 中声明的标签。此注解会覆盖基于实体或基于命名空间的识别注解，如 backstage.io/kubernetes-id 和 backstage.io/kubernetes-namespace。

4. 为 Kubernetes 资源添加标签，以启用 Backstage 来查找适当的 Kubernetes 资源。

   1. Backstage Kubernetes 插件标签：添加此标签以将资源映射到特定的 Backstage 实体。

      labels:
        ...
        backstage.io/kubernetes-id: <BACKSTAGE_ENTITY_NAME>

      Copy to Clipboard Toggle word wrap

   2. GitOps 应用程序映射：添加此标签以将 Argo CD Rollouts 映射到特定的 GitOps 应用程序

      labels:
        ...
        app.kubernetes.io/instance: <GITOPS_APPLICATION_NAME>

      Copy to Clipboard Toggle word wrap
   注意

   如果使用标签选择器注解(backstage.io/kubernetes-label-selector)，请确保资源上存在指定的标签。标签选择器将覆盖其他注解，如 kubernetes-id 或 kubernetes-namespace。

验证

1. 将更新的配置推送到 GitOps 存储库，以触发推出部署。
2. 打开 Red Hat Developer Hub 界面并导航到您配置的实体。
3. 选择 CD 选项卡，然后选择 GitOps 应用程序。侧边面板将打开。

4. 在侧面板的 Resources 表中，验证是否显示以下资源：

   • rollouts
   • AnalysisRuns （可选）

5. 扩展推出部署资源并查看以下详情：

   • Revisions 行显示不同推出部署版本的流量分布详情。
   • Analysis Runs 行显示评估推出成功分析任务的状态。