第 1 章 Backstage 的 ArgoCD 插件

流程

1. 在 backstage/packages/app 项目中，将 ArgoCD 插件添加为 package.json 依赖项，如下所示：

   cd packages/app
   yarn add @redhat/backstage-plugin-argo-cd

2. 在根目录中的 app-config.yaml 文件中，将 argo-cd 添加到 proxy 对象中，如下所示：

   proxy:
     ...
   
     '/argocd/api':
       # url to the api of your hosted argoCD instance
       target: https://159.65.209.132/api/v1/
       changeOrigin: true
       # this line is required if your hosted argoCD instance has self-signed certificate
       secure: false
       headers:
         Cookie:
           $env: ARGOCD_AUTH_TOKEN
   
   
   # optional: this will link to your argoCD web UI for each argoCD application
   argocd:
     baseUrl: https://my-argocd-web-ui.com

   另外，您还可以在前面的代码中为 ArgoCD Web UI 添加基本 URL。

3. 使用以下代码将 ArgoCD 插件添加到插件列表中：

   // packages/app/src/plugins.ts
   export { argocdPlugin } from '@redhat/backstage-plugin-argo-cd';

4. 将 ArgoCD 插件添加到 ENT itityPage.tsx 文件中，如下所示：

   // packages/app/src/components/catalog/EntityPage.tsx
   import {
     EntityArgoCDHistoryCard,
     isArgocdAvailable,
   } from '@redhat/backstage-plugin-argo-cd';
   
   
   const overviewContent = (
     <Grid container spacing={3} alignItems="stretch">
       ...
       <EntitySwitch>
         <EntitySwitch.Case if={e => Boolean(isArgocdAvailable(e))}>
           <Grid item sm={6}>
             <EntityArgoCDHistoryCard />
           </Grid>
         </EntitySwitch.Case>
       </EntitySwitch>
       ...
     </Grid>
   );

5. 要在 Backstage 中为组件使用 ArgoCD 插件，请在组件的 YAML 配置文件中添加注解：

   argocd/app-name: <app-name>

   要为组件选择多个 ArgoCD 应用程序，请使用标签，如下所示：

   argocd/app-selector: <app-selector>

   注意

   您可以对组件使用注解或标签。

6. 使用用户名和密码向 ArgoCD 的 /session 端点发送 GET HTTP 请求，以获取您的身份验证密钥。

7. 将获取的身份验证密钥添加到 Backstage 后端服务器的环境变量中，如下所示：

   ARGOCD_AUTH_TOKEN="argocd.token=<auth-token>"