Application管理

通过ArgoCD控制台创建和部署

1. 登录ArgoCD UI，具体操作，请参见通过ArgoCD UI方式登录。

2. 在ArgoCD UI左侧导航栏选择Applications，然后单击+ NEW APP。

3. 在弹出的面板配置以下信息，然后单击CREATE进行创建。

   区域	参数	参数值
   GENERAL	Application Name	echo-server-demo
   	Project Name	default
   	SYNC POLICY	在下拉列表中选择Automatic。 参数取值如下： Manual：当Git端有变更时，需要用户手动执行同步动作将其部署至目标集群。 Automatic：ArgoCD Server每隔3分钟自动检测Git端的变更并将其自动部署至目标集群。
   	SYNC OPTIONS	勾选AUTO-CREATE NAMESPACE。
   SOURCE	Repository URL	在下拉列表选择已有Git Repo，此处选择https://github.com/AliyunContainerService/gitops-demo.git。
   	Revision	HEAD
   	Path	manifests/helm/echo-server
   DESTINATION	Cluster URL/Cluster Name	在下拉列表中选择目标集群。
   	Namespace	echo-server-demo
   HELM	VALUES FILES	values.yaml

4. 创建完成后，在Application页面，即可看到echo-server-demo的应用状态。

   如果SYNC POLICY选择的是Manual方式，需要手动点击SYNC，将应用同步部署至目标集群。应用的Status为Healthy和Synced，表示已经成功同步。

   

通过ArgoCD CLI创建和部署

1. 执行以下命令，创建echo-server-demo应用。

   argocd app create echo-server-demo --repo https://github.com/AliyunContainerService/gitops-demo.git --path  manifests/directory/production --dest-namespace echo-server-demo --dest-server https://47.97.XX.XX:6443 --sync-policy none

   预期输出：

   application 'echo-server-demo' created

   命令行参数解释如下表所示。

   参数	说明
   repo	该应用所引用的Git源仓库地址。
   path	echo-server-demo示例应用的YAML编排文件所在的子目录。
   dest-server	目标集群APIServer地址。
   dest-namespace	目标集群命名空间。
   sync-policy	应用的同步策略。默认为none，可选值为auto或none。 auto：表示GitOps系统每隔一段时间就会自动检测Git源仓库中echo-server实例应用的变动并自动将其部署到目标集群。 none：表示需要用户手动执行同步动作将应用部署到目标集群。

2. 执行以下命令，将echo-server-demo应用同步部署到目标集群。

   argocd app sync echo-server-demo

   预期输出：

   TIMESTAMP                  GROUP        KIND         NAMESPACE                 NAME         STATUS      HEALTH        HOOK  MESSAGE
   2022-10-17T16:43:20+08:00  apps         Deployment   echo-server-demo          echo-server  OutOfSync   Missing
   2022-10-17T16:43:20+08:00               Service      echo-server-demo          echo-server  OutOfSync   Missing
   2022-10-17T16:43:20+08:00               Service      echo-server-demo          echo-server  Synced      Progressing
   2022-10-17T16:43:20+08:00               Service      echo-server-demo          echo-server  Synced      Progressing         service/echo-server-demo created
   2022-10-17T16:43:20+08:00  apps         Deployment   echo-server-demo          echo-server  OutOfSync   Missing             deployment.apps/echo-server-demo created
   2022-10-17T16:43:20+08:00  apps         Deployment   echo-server-demo          echo-server  Synced      Progressing         deployment.apps/echo-server-demo created
   
   Name:               echo-server-demo
   Project:            default
   Server:             https://47.97.XX.XX:6443
   Namespace:          echo-server-demo
   URL:                https://127.0.0.1:65384/applications/echo-server-demo
   Repo:               https://github.com/AliyunContainerService/gitops-demo.git
   Target:
   Path:               manifests/directory/production
   SyncWindow:         Sync Allowed
   Sync Policy:        <none>
   Sync Status:        Synced to  (02af62b)
   Health Status:      Progressing
   
   Operation:          Sync
   Sync Revision:      02af62bf21e76f53ebfcc282c45865d2308c****
   Phase:              Succeeded
   Start:              2022-10-17 16:43:19 +0800 CST
   Finished:           2022-10-17 16:43:20 +0800 CST
   Duration:           1s
   Message:            successfully synced (all tasks run)
   
   GROUP  KIND        NAMESPACE         NAME              STATUS  HEALTH       HOOK  MESSAGE
          Service     echo-server-demo  echo-server-demo  Synced  Progressing        service/echo-server-demo created
   apps   Deployment  echo-server-demo  echo-server-demo  Synced  Progressing        deployment.apps/echo-server-demo created

通过ArgoCD控制台查看

1. 在ArgoCD UI左侧导航栏选择Applications，即可查看应用列表。

2. 单击echo-server-demo应用名称，即可查看应用详情，展示应用相关的Kubernetes资源的拓扑结构及相应状态。

   

通过ArgoCD CLI查看

执行以下命令，查看应用列表。

argocd app list

预期输出：

NAME         CLUSTER                     NAMESPACE         PROJECT  STATUS  HEALTH   SYNCPOLICY  CONDITIONS  REPO                                                       PATH                            TARGET
echo-server  https://47.97.XX.XX:6443    echo-server-demo  default  Synced  Healthy  <none>      <none>      https://github.com/AliyunContainerService/gitops-demo.git  manifests/directory/production

通过ArgoCD控制台回滚

1. 在ArgoCD UI左侧导航栏选择Applications，在应用列表中找到echo-server-demo应用并单击应用名称。

2. 在应用详情页面单击HISTORY AND ROLLBACK，在弹出的应用历史版本中，选择要回滚到的目标版本，单击右上角弹出的Rollback。

   

3. 等待回滚完成后，回到应用详情页面验证应用版本。

通过ArgoCD CLI回滚

1. 执行以下命令，查看已有且可用的历史版本。

   argocd app history echo-server-demo

   预期输出：

   ID  DATE                           REVISION
   0   2022-10-17 16:43:20 +0800 CST   (02af62b)
   1   2022-10-17 16:52:49 +0800 CST   (56ae547)

   当前新版本REVISION为56ae547，序列号为1。

2. 执行以下命令，将应用回滚到REVISION为02af62b的历史版本。

   argocd app rollback echo-server-demo 0

   待回滚完成后，继续验证访问应用。

3. 执行以下命令，访问应用。

   curl XX.XX.XX.XX:8080/version    #替换XX.XX.XX.XX为应用的IP地址。

   预期输出：

   "Hello Echo Server v1.0"