## 一 背景

Argo CD 每三分钟会轮询一次 Git 存储库，以检测清单的更改。为了消除这种轮询延迟，可以将 API 服务器配置为接收 webhook 事件的方式，这样就能实时获取到 Git 存储库中的变化了。 Argo CD 支持来自 GitHub、GitLab、Bitbucket、Bitbucket Server 和 Gogs 的 Git webhook 通知。下面以 GitLab 为例配置 webhook。

## 二 原理

通过Git仓库的tag/brach实践，Git仓库调用配置的ArgoCD webhook地址，实现自动触发，

实现目标：
1.  **消除轮询延迟**：Argo CD 默认通过轮询 Git 存储库来检测清单的更改，但这可能会导致一些延迟。通过配置 webhook，Git 存储库可以直接通知 Argo CD 有关代码变更，从而消除轮询延迟，实现即时获取变更的效果。
1.  **实时获取代码变更**：通过 webhook，Git 存储库将即时发送事件通知给 Argo CD 的 API 服务器，包含了代码变更的详细信息。这使得 Argo CD 能够立即获知代码的改变，而无需等待下一次轮询周期。
1.  **支持多种 Git 存储库**：Argo CD 支持来自 GitHub、GitLab、Bitbucket、Bitbucket Server 和 Gogs 的 Git webhook 通知。这意味着您可以在这些平台上配置 webhook，并与 Argo CD 集成，无论您选择的是哪种 Git 存储库，都能够实现即时获取代码变更的目的。


## 三 实战

### 3.1 获取Argocd webhook地址

在 GitLab 中配置的 URL 应该使用您的 Argo CD 实例的 `/api/webhook` 接口（例如 <https://argocd.xxx.com/api/webhook）。下面的> Secret Token 是可选的，建议添加上，可输入任意值。在下一步配置 webhook 时将使用此值。

```shell
https://124.156.169.236:8080/api/webhook
```

### 3.2 Git源码仓库配置

Gitlab 配置webhook 的Merge request events事件触发

![image.png](https://developer.qcloudimg.com/http-save/yehe-1137075/2d2747ec4c49a8b5d80ce9975e74f3fd.png#?w=1356&h=934&s=257393&e=png&a=1&b=fcfbfb)

secret token 可选，但建议填写：argocdgitlab123

### 3.3 使用WebHook Secret配置Argo CD

在 kubernetes secret `argocd-secret` 中添加上面配置的 Secret Token：

    $ kubectl edit secret argocd-secret -n argocd

> \*\*TIP：\*\*为了方便输入secret，kubernetes支持在stringData字段中输入secret，这样就省去了base64编码后复制到data字段的麻烦。只需将步骤 1 中创建的共享 webhook 秘密复制到 stringData 字段下相应的 GitLab 键：

    apiVersion: v1
    kind: Secret
    metadata:
      name: argocd-secret
      namespace: argocd
    type: Opaque
    data:
    ...

    stringData:
      # gitlab webhook secret
      webhook.gitlab.secret: argocdgitlab123

### 3.4 创建ArgoCD应用测试

*   创建argocd应用

![](https://developer.qcloudimg.com/http-save/yehe-1137075/834ce73686d9fe45d6041c2274e05c99.png#?w=934\&h=511\&s=106062\&e=png\&a=1\&b=ffffff)

*   并快速提交代码触发测试

![](https://developer.qcloudimg.com/http-save/yehe-1137075/a88e1253b2b31508af091b73781d8ce8.png#?w=1906\&h=456\&s=169336\&e=png\&a=1\&b=0a232c)

可以查看argocd 应用不用等待3分钟，直接触发更新。

## 四 注意事项

*   由于是Git仓库主动去调用ArgoCD地址，需要Git仓库能与ArgoCD地址能正常通讯。
*   如果Git链接不到ArgoCD，可以配置ArgoCD 通过pull方式，三分钟触发，或手动触发拉取配置，进行部署。

## 五 总结

为了实时获取Git存储库中的变化，可以配置GitLab与Argo CD的Webhook。通过配置Webhook，当Git存储库中的清单发生更改时，GitLab会向Argo CD的API服务器发送通知，从而消除了轮询延迟。配置的步骤包括在GitLab中创建项目并关联存储库，以及获取Argo CD的API服务器URL用于接收来自GitLab的Webhook事件。

## 参考链接

*   <https://argo-cd.readthedocs.io/en/stable/operator-manual/webhook/>
*   <https://docs.gitlab.com/ee/ci/environments/external_deployment_tools.html>
*   <https://argo-cd.readthedocs.io/en/stable/operator-manual/applicationset/Generators-Pull-Request/#webhook-configuration>


Argo CD 每三分钟会轮询一次 Git 存储库，以检测清单的更改。为了消除这种轮询延迟，可以将 API 服务器配置为接收 webhook 事件的方式，这样就能实时获取到 Git 存储库中的变化了。 Argo CD 支持来自 GitHub、GitLab、Bitbucket、Bitbucket Server 和 Gogs 的 Git webhook 通知。下面以 GitLab 为例配置 webhook。

Gitlab+ArgoCD webhook配置自动触发

Argo CD 每三分钟会轮询一次 Git 存储库，以检测清单的更改。为了消除这种轮询延迟，可以将 API 服务器配置为接收 webhook 事件的方式，这样就能实时获取到 Git 存储库中的变化了。 Argo CD 支持来自 GitHub、GitLab、Bitbucket、Bitbucket Server 和 Gogs 的 Git webhook 通知。下面以 GitLab 为例配置 webho

Devops工程师

云计算

运维

开发工具

ArgoCD通过配置GitLab Webhook实现实时同步，消除默认3分钟轮询延迟。详细步骤包括获取ArgoCD Webhook地址、配置GitLab仓库Webhook、设置Secret Token等，支持GitHub/GitLab/Bitbucket等多种仓库。确保网络连通性后，代码变更可立即触发ArgoCD自动更新部署。

服务器

Bitbucket

GitHub

4核4G3M云服务器 新用户低至38元/年！

文章

问答

视频

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

ArgoCD通过配置GitLab Webhook实现实时同步，消除默认3分钟轮询延迟。详细步骤包括获取ArgoCD Webhook地址、配置GitLab仓库Webhook、设置Secret Token等，支持GitHub/GitLab/Bitbucket等多种仓库。确保网络连通性后，代码变更可立即触发ArgoCD自动更...

Gitlab+ArgoCD webhook配置自动触发-腾讯云开发者社区-腾讯云

Gitlab+ArgoCD webhook配置自动触发

Gitlab+ArgoCD webhook配置自动触发

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐