https://github.com/codefresh-io/argocd-agent
https://github.com/codefresh-io/argocd-agent
Last synced: 3 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/codefresh-io/argocd-agent
- Owner: codefresh-io
- License: mit
- Created: 2020-07-27T13:10:52.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2023-08-08T09:25:17.000Z (almost 3 years ago)
- Last Synced: 2026-02-13T08:05:54.524Z (4 months ago)
- Language: Go
- Size: 17.5 MB
- Stars: 5
- Watchers: 8
- Forks: 0
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ArgoCD agent for codefresh gitops dashboard
[](https://codecov.io/gh/codefresh-io/argocd-agent)
[]( https://g.codefresh.io/pipelines/edit/new/builds?id=5f21305719d46c880abeeeb5&pipeline=argocd-agent&projects=argo&projectId=5f16b786f25d80a086a56bcb)
[](https://goreportcard.com/report/github.com/codefresh-io/argocd-agent)
Codefresh providing [dashboard](https://codefresh.io/docs/docs/ci-cd-guides/gitops-deployments/) for watching on all activities that happens on argocd side. Codefresh argocd agent important part for check all argocd CRD use watch api and notify codefresh about all changes.
Like:
* Application created/removed/updated
* Project created/removed/updated
* Your manifest repo information base on context that you provide to us during installation
In addition this agent do automatic application sync between argocd and codefresh
## Prerequisites
Make sure that you have
* a [Codefresh account](https://codefresh.io/docs/docs/getting-started/create-a-codefresh-account/) with enabled gitops feature
* a [Codefresh API token](https://codefresh.io/docs/docs/integrations/codefresh-api/#authentication-instructions) that will be used as a secret in the agent
* a [Codefresh CLI](https://codefresh-io.github.io/cli/) that will be used for install agent
* a [ArgoCD Server](https://argoproj.github.io/argo-cd/cli_installation/)
ArgoCD agent has following resource requirements
```
resources:
requests:
memory: "256Mi"
cpu: "0.4"
limits:
memory: "512Mi"
cpu: "0.8"
```
## Installation
```sh
codefresh install gitops argocd-agent
```

## Uninstall
```sh
codefresh uninstall gitops argocd-agent
```
## Upgrade
Codefresh will show you indicator inside your [gitops integration](https://g.codefresh.io/account-admin/account-conf/integration/gitops) when you need upgrade your agent
```sh
codefresh upgrade gitops argocd-agent
```
## How to use the ArgoCD agent

## How it works ( Diagram )


## Local execution
### Environment variables
* ARGO_HOST - Argocd host (like https://34.71.103.174/)
* ARGO_USERNAME - Argocd username ( Need provide if ARGO_TOKEN empty )
* ARGO_PASSWORD - Argocd password ( Need provide if ARGO_TOKEN empty )
* ARGO_TOKEN - Argocd user token
* CODEFRESH_TOKEN - [Codefresh user token](https://codefresh.io/docs/docs/integrations/codefresh-api/#authentication-instructions)
* CODEFRESH_INTEGRATION - Codefresh gitops integration name
* CODEFRESH_HOST - Codefresh host ( prodution https://g.codefresh.io)
* CODEFRESH_SUFFIX - Suffix for agent application's resources. Can be used for installing multiple agents in one namespace
* GIT_PASSWORD - Git token
## Run tests
`go test -cover ./...`