Argo CD 应用程序

流程

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

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

   应用程序名称

   spring-petclinic

   project

   default

   同步策略

   自动

   仓库 URL

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

   修订

   HEAD

   路径

   app

   目的地

   https://kubernetes.default.svc

   命名空间

   spring-petclinic

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 仪表板中，验证您的应用程序是否具有 Synced 状态。
2. 点 Argo CD 仪表板中的 app-spring-petclinic 标题，查看部署到集群中的应用程序资源。
3. 在 OpenShift Container Platform web 控制台中进入 Developer 视角。

4. 修改 Spring PetClinic 部署，并将更改提交到 Git 仓库的 app/ 目录。Argo CD 将自动将更改部署到集群。

   1. Fork OpenShift GitOps getting started repository。
   2. 在 deployment.yaml 文件中，将 failureThreshold 值改为 5。

   3. 在部署集群中，运行以下命令验证 failureThreshold 字段更改的值：

      $ oc edit deployment spring-petclinic -n spring-petclinic

5. 通过修改集群上的部署并扩展到两个容器集来测试自我修复行为，同时在 OpenShift Container Platform Web 控制台中观察应用程序。

   1. 运行以下命令修改部署：

      $ oc scale deployment spring-petclinic --replicas 2  -n spring-petclinic

   2. 在 OpenShift Container Platform Web 控制台中，请注意部署最多扩展两个 pod，并立即缩减到一个 pod。Argo CD 检测到与 Git 存储库的区别，并在 OpenShift Container Platform 集群中自动修复应用程序。
6. 在 Argo CD 仪表板中，点 app-spring-petclinic 标题 → APP DETAILS → EVENTS。EVENTS 选项卡显示以下事件： Argo CD 检测集群中缺少同步部署资源，然后重新同步 Git 存储库进行更正。

流程

1. 获取 Argo CD 服务器的 admin 帐户密码：

   $ ADMIN_PASSWD=$(oc get secret openshift-gitops-cluster -n openshift-gitops -o jsonpath='{.data.admin\.password}' | base64 -d)

2. 获取 Argo CD 服务器 URL：

   $ SERVER_URL=$(oc get routes openshift-gitops-server -n openshift-gitops -o jsonpath='{.status.ingress[0].host}')

3. 使用 admin 帐户密码以单引号登录到 Argo CD 服务器：

   重要

   将密码包含在单引号中，确保 shell 无法错误地解译特殊字符，如 $。始终使用单引号括起密码的字面值。

   $ argocd login --username admin --password ${ADMIN_PASSWD} ${SERVER_URL}

   Example

   $ argocd login --username admin --password '<password>' openshift-gitops.openshift-gitops.apps-crc.testing

4. 通过列出所有应用程序，验证您是否可以在默认模式下运行 argocd 命令：

   $ argocd app list

   如果配置正确，则使用以下标头列出现有应用程序：

   输出示例

   NAME CLUSTER NAMESPACE  PROJECT  STATUS  HEALTH   SYNCPOLICY  CONDITIONS  REPO PATH TARGET

5. 在默认模式中创建应用程序：

   $ argocd app create app-spring-petclinic \
       --repo https://github.com/redhat-developer/openshift-gitops-getting-started.git \
       --path app \
       --revision main \
       --dest-server  https://kubernetes.default.svc \
       --dest-namespace spring-petclinic \
       --directory-recurse \
       --sync-policy automated \
       --self-heal \
       --sync-option Prune=true \
       --sync-option CreateNamespace=true

6. 将 spring-petclinic 目标命名空间标记为由 openshif-gitops Argo CD 实例管理：

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

7. 列出可用的应用程序，以确认应用程序已被成功创建并重复该命令，直到应用程序具有 Healthy 和 Synced 状态：

   $ argocd app list

流程

1. 使用 oc CLI 工具登录到 OpenShift Container Platform 集群：

   $ oc login -u <username> -p <password> <server_url>

   Example

   $ oc login -u kubeadmin -p '<password>' https://api.crc.testing:6443

2. 检查 kubeconfig 文件中是否正确设置了上下文：

   $ oc config current-context

3. 将当前上下文的默认命名空间设置为 openshift-gitops ：

   $ oc config set-context --current --namespace openshift-gitops

4. 设置以下环境变量来覆盖 Argo CD 组件名称：

   $ export ARGOCD_REPO_SERVER_NAME=openshift-gitops-repo-server

5. 通过列出所有应用程序，验证您能够在 核心 模式下运行 argocd 命令：

   $ argocd app list --core

   如果配置正确，则使用以下标头列出现有应用程序：

   输出示例

   NAME CLUSTER NAMESPACE  PROJECT  STATUS  HEALTH   SYNCPOLICY  CONDITIONS  REPO PATH TARGET

6. 以 核心 模式创建应用程序：

   $ argocd app create app-spring-petclinic --core \
       --repo https://github.com/redhat-developer/openshift-gitops-getting-started.git \
       --path app \
       --revision main \
       --dest-server  https://kubernetes.default.svc \
       --dest-namespace spring-petclinic \
       --directory-recurse \
       --sync-policy automated \
       --self-heal \
       --sync-option Prune=true \
       --sync-option CreateNamespace=true

7. 将 spring-petclinic 目标命名空间标记为由 openshif-gitops Argo CD 实例管理：

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

8. 列出可用的应用程序，以确认应用程序已被成功创建并重复该命令，直到应用程序具有 Healthy 和 Synced 状态：

   $ argocd app list --core

流程

1. 在 Web 控制台的 Administrator 视角中，点 Operators → Installed Operators。
2. 从 Project 列表中，选择安装用户定义的集群范围的 Argo CD 实例的项目。
3. 从安装的 Operator 列表中选择 Red Hat OpenShift GitOps，再进入 Argo CD 选项卡。
4. 点用户定义的集群范围的 Argo CD 实例。

5. 使用目标命名空间配置用户定义的集群范围的 Argo CD 实例的 ArgoCD CR：

   1. 点 YAML 选项卡，并编辑 ArgoCD CR 的 YAML 文件。

   2. 在 ArgoCD CR 中，将 sourceNamespaces 参数的值设置为包含非 control plane 命名空间：

      ArgoCD CR 示例

      apiVersion: argoproj.io/v1beta1
      kind: ArgoCD
      metadata:
        name: example 1
        namespace: spring-petclinic 2
      spec:
        sourceNamespaces: 3
          - dev 4
          - app-team-* 5

      1

      用户定义的集群范围的 Argo CD 实例的名称。

      2

      要运行用户定义的集群范围的 Argo CD 实例的命名空间。

      3

      用于创建和管理应用程序资源的非 control plane 命名空间列表。

      4

      Argo CD 服务器的目标命名空间名称，用于 创建和管理应用程序资源。

      5

      使用通配符(*)，指定与模式 app-team suit 匹配的目标命名空间的名称，如 app-team-1 和 app-team-2，用于 Argo CD 服务器来创建和管理应用程序资源。

   3. 单击 Save and Reload。

      注意

      当在 sourceNamespaces 字段中指定目标命名空间时，Operator 会将 argocd.argoproj.io/managed-by-cluster-argocd 标签添加到指定的命名空间中。

      dev 目标命名空间示例

      apiVersion: v1
      kind: Namespace
      metadata:
        name: dev
        labels:
          argocd.argoproj.io/managed-by-cluster-argocd: spring-petclinic 1
          kubernetes.io/metadata.name: dev 2

      1

      用户定义的集群范围的 Argo CD 实例的命名空间。

      2

      Argo CD 服务器的目标命名空间，用于 创建和管理应用程序资源。

6. 验证 Operator 是否将 argocd.argoproj.io/managed-by-cluster-argocd 标签添加到指定命名空间中：

   1. 进入 Administration → Namespaces，再点击 Create Namespace。

   2. 在 Create Namespace 对话框中，提供 Name 并点 Create。

      例如，若要创建 dev 目标命名空间，请在 Name 字段中输入 dev。您可以重复前面的步骤来创建 app-team-1 和 app-team-2 目标命名空间。

      Namespaces 页面显示创建的目标命名空间。

   3. 点目标命名空间并进入 YAML 选项卡，以验证 Operator 添加的 argocd.argoproj.io/managed-by-cluster-argocd 标签。

7. 验证您的用户定义的集群范围的 Argo CD 实例是否已配置有集群角色来管理集群范围的资源：

   1. 进入 User Management → Roles，然后从 Filter 列表中选择 Cluster-wide Roles。

   2. 使用 Search by name 字段搜索创建的集群角色。例如，example-spring-petclinic-argocd-application-controller 和 example-spring-petclinic-argocd-server。

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

   3. 验证 GitOps Operator 创建了以下基于角色的访问控制(RBAC)资源：

      Name	Kind	用途
      <argocd_name>-<argocd_namespace>-argocd-application-controller	ClusterRole 和 ClusterRoleBinding	对于 Argo CD Application Controller，在集群级别监视和列出应用程序资源
      <argocd_name>-<argocd_namespace>-argocd-server	ClusterRole 和 ClusterRoleBinding	对于 Argo CD 服务器，在集群级别监视和列出 应用程序资源
      <argocd_name>-<target_namespace>	Role 和 RoleBinding	要让 Argo CD 服务器通过 UI、API 或 CLI 管理目标命名空间中的 应用程序资源

流程

1. 在 openshift-gitops control plane 命名空间中创建和配置用户定义的 AppProject 实例，以便在 .spec.sourceNamespaces 字段中指定目标命名空间：

   1. 从 Project 列表中，选择 openshift-gitops 项目。
   2. 在 Web 控制台的 Administrator 视角中，点 Operators → Installed Operators → Red Hat OpenShift GitOps，进入 AppProject 选项卡。

   3. 点 Create AppProject，然后在 YAML 视图中输入以下配置：

      用户定义的 AppProject 实例示例

      kind: AppProject
      apiVersion: argoproj.io/v1alpha1
      metadata:
        name: project-one 1
        namespace: openshift-gitops 2
      spec:
        sourceNamespaces: 3
        - dev 4
        - app-team-* 5
        destinations: 6
          - name: '*'
            namespace: '*'
            server: '*'
         sourceRepos: 7
          - '*'

      1

      用户定义的 AppProject 实例的名称。

      2

      要运行用户定义的 AppProject 实例的 control plane 命名空间。

      3

      用于创建和管理应用程序资源的非 control plane 命名空间列表。

      4

      Argo CD 服务器的目标命名空间名称，用于 创建和管理应用程序资源。

      5

      使用通配符(*)，指定与模式 app-team suit 匹配的目标命名空间的名称，如 app-team-1 和 app-team-2，用于 Argo CD 服务器来创建和管理应用程序资源。

      6

      对用户定义的 AppProject 实例中的应用程序可以部署到的集群和命名空间的引用。

      7

      引用用户定义的 AppProject 实例中应用程序可从中拉取清单的存储库。

   4. 点 Create。

      AppProjects 页面显示创建的用户定义的 AppProject 实例。

流程

1. 使用 metadata.namespace 和 .spec.project 字段的参数创建和配置 Application CR，以引用目标命名空间和用户定义的 AppProject 实例：

   1. 从 Project 列表中，选择目标命名空间。
   2. 在 Web 控制台的 Administrator 视角中，点 Operators → Installed Operators → Red Hat OpenShift GitOps，进入 Application 选项卡。

   3. 点 Create Application，然后在 YAML 视图中输入以下配置：

      用户定义的 AppProject 实例示例

      kind: Application
      apiVersion: argoproj.io/v1alpha1
      metadata:
        name: cluster-configs 1
        namespace: dev 2
      spec:
        project: project-one 3
        # ...

      1

      应用程序的名称。

      2

      Argo CD 服务器的目标命名空间名称，用于 创建和管理应用程序资源。

      3

      用户定义的 AppProject 实例的名称。

   4. 点 Create。

      Applications 页面显示创建的应用程序。

      cluster-configs Argo CD 应用程序现在的状态为 Healthy 和 Synced。