rezkam ArgoCD
Interact with an ArgoCD server via its REST API.
Configuration
Run ./setup.sh from the repo root (recommended), or create config files manually:
mkdir -p ~/.boring/argocd
echo 'https://argocd.example.com' > ~/.boring/argocd/url
echo 'your-bearer-token' > ~/.boring/argocd/token
chmod 600 ~/.boring/argocd/token
Generate a token:
- API token:
argocd account generate-token --account <account-name> - Session token:
curl -s $ARGOCD_URL/api/v1/session -d '{"username":"admin","password":"PASSWORD"}'
Scripts
List applications
scripts/argocd-app-list.sh [--project PROJECT] [--repo REPO]
Application details
scripts/argocd-app-get.sh <app-name> [--project PROJECT]
Shows sync status, health, repo, target revision, conditions, last operation.
Sync an application
scripts/argocd-app-sync.sh <app-name> [--revision REV] [--prune] [--dry-run] [--project PROJECT]
Wait for sync and health
scripts/argocd-app-wait.sh <app-name> [--timeout SECONDS] [--project PROJECT]
Polls until the app is Synced + Healthy (or timeout). Default timeout: 300s.
Sync history
scripts/argocd-app-history.sh <app-name> [--project PROJECT]
Resource tree
scripts/argocd-app-resources.sh <app-name> [--project PROJECT]
Shows all Kubernetes resources managed by the app with their health and status.
Pod logs
scripts/argocd-app-logs.sh <app-name> [--resource NAME] [--container NAME] [--tail LINES] [--project PROJECT]
Rendered manifests
scripts/argocd-app-manifests.sh <app-name> [--project PROJECT]
Live vs desired diff
scripts/argocd-app-diff.sh <app-name> [--project PROJECT]
Shows resources that differ between the live cluster state and the desired state in Git.
Rollback
scripts/argocd-app-rollback.sh <app-name> <history-id> [--project PROJECT]
Use argocd-app-history.sh to find the history ID.
Resource actions
scripts/argocd-app-actions.sh <app-name> --kind KIND --name RESOURCE_NAME [--run ACTION] [--namespace NS] [--group GROUP] [--project PROJECT]
List available actions (omit --run) or execute one (e.g. restart a Deployment).
Delete application
scripts/argocd-app-delete.sh <app-name> [--cascade|--no-cascade] [--project PROJECT]
--cascade (default) also deletes Kubernetes resources. --no-cascade removes from ArgoCD only.
List projects
scripts/argocd-project-list.sh
Project details
scripts/argocd-project-get.sh <project-name>
List clusters
scripts/argocd-cluster-list.sh
List repositories
scripts/argocd-repo-list.sh
Raw API
scripts/argocd-api.sh <endpoint> [curl-options...]
Typical workflow
S=scripts
# Check what's deployed
$S/argocd-app-list.sh
$S/argocd-app-get.sh my-service
$S/argocd-app-resources.sh my-service
# After pushing code changes, sync
$S/argocd-app-sync.sh my-service
$S/argocd-app-wait.sh my-service --timeout 600
# Debug if unhealthy
$S/argocd-app-logs.sh my-service --resource my-service-pod --tail 200
$S/argocd-app-diff.sh my-service
# Rollback if needed
$S/argocd-app-history.sh my-service
$S/argocd-app-rollback.sh my-service 5
$S/argocd-app-wait.sh my-service
API endpoints reference
All endpoints are under the ArgoCD server URL:
/api/v1/applications— list/create applications/api/v1/applications/{name}— get/update/delete app/api/v1/applications/{name}/sync— trigger sync (POST)/api/v1/applications/{name}/rollback— rollback (POST)/api/v1/applications/{name}/resource-tree— resource tree/api/v1/applications/{name}/managed-resources— managed resources with diffs/api/v1/applications/{name}/manifests— rendered manifests/api/v1/applications/{name}/logs— pod logs/api/v1/applications/{name}/resource/actions— resource actions/api/v1/projects— list/create projects/api/v1/projects/{name}— get/update project/api/v1/clusters— list clusters/api/v1/repositories— list repositories/api/v1/session/userinfo— current user info
Auth: Authorization: Bearer <token>. All endpoints accept optional project query param.