argocd-cli

Name: argocd-cli
Author: oldwinter

github.com/oldwinterCloud & DevOps1050 installsUpdated 1w ago

About argocd-cli

argocd-cli is a skill for managing GitOps deployments with the ArgoCD CLI, aimed at operators responsible for application delivery and cluster state. It documents commands for syncing, status checks, rollbacks, diffs, and resource operations.

Key features

01Inspect sync and health status
02Sync applications and selected resources
03Refresh application state
04Review diffs and deployment history
05Roll back to a chosen revision
06Inspect resources and pod logs

Use cases

01Check whether an app matches Git state
02Deploy the latest changes from Git
03Investigate sync errors or unhealthy status
04Restore an application to an earlier revision

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/oldwinter/skills --skill argocd-cli

After installing, type/argocd-cliin Claude Code to confirm it loaded.

Details

From the project README

ArgoCD CLI Skill

This skill enables GitOps deployment management using ArgoCD CLI.

Environment

Connection

Server: 192.168.10.117:31006
Web UI: http://192.168.10.117:31006
Credentials: admin / CpfsoneT7ogVKWOh

Login Command

If token expires, re-authenticate:

yes | argocd login 192.168.10.117:31006 --username admin --password CpfsoneT7ogVKWOh --insecure

Applications Overview

Application	Cluster	Namespace	Environment
`simplex-k1-prod`	AWS EKS	production	生产环境
`simplex-k2-staging`	AWS EKS	staging	预发布环境
`simplex-local`	K3s	simplex	本地开发
`simplex-local-infra`	K3s	common	本地基础设施

Common Operations

Application Status

# List all applications
argocd app list

# Get specific application status
argocd app get argocd/simplex-k1-prod
argocd app get argocd/simplex-k2-staging
argocd app get argocd/simplex-local

# Get application in JSON format
argocd app get argocd/simplex-k1-prod -o json

# Get application in YAML format
argocd app get argocd/simplex-k1-prod -o yaml

Sync Operations

# Sync application (deploy latest from git)
argocd app sync argocd/simplex-k1-prod

# Sync with prune (remove resources not in git)
argocd app sync argocd/simplex-k1-prod --prune

# Sync specific resources only
argocd app sync argocd/simplex-k1-prod --resource apps:Deployment:simplex-api

# Sync with force (replace resources)
argocd app sync argocd/simplex-k1-prod --force

# Sync and wait for completion
argocd app sync argocd/simplex-k1-prod --timeout 300

# Dry run sync (preview changes)
argocd app sync argocd/simplex-k1-prod --dry-run

Refresh

# Refresh application (re-read from git)
argocd app get argocd/simplex-k1-prod --refresh

# Hard refresh (clear cache and re-read)
argocd app get argocd/simplex-k1-prod --hard-refresh

Rollback

# View deployment history
argocd app history argocd/simplex-k1-prod

# Rollback to specific revision
argocd app rollback argocd/simplex-k1-prod <revision-id>

# Example: rollback to revision 5
argocd app rollback argocd/simplex-k1-prod 5

Diff and Comparison

# Show diff between live and desired state
argocd app diff argocd/simplex-k1-prod

# Show diff with local manifests
argocd app diff argocd/simplex-k1-prod --local /path/to/manifests

Resource Management

# List application resources
argocd app resources argocd/simplex-k1-prod

# Get logs from application pods
argocd app logs argocd/simplex-k1-prod

# Follow logs
argocd app logs argocd/simplex-k1-prod --follow

# Logs from specific container
argocd app logs argocd/simplex-k1-prod --container simplex-api

# Delete specific resource
argocd app delete-resource argocd/simplex-k1-prod --kind Deployment --resource-name simplex-api

Application Management

# Create new application
argocd app create <name> \
  --repo ssh://[email protected]:2222/simplexai/infra/simplex-gitops.git \
  --path kubernetes/overlays/<env> \
  --dest-server https://kubernetes.default.svc \
  --dest-namespace <namespace>

# Delete application
argocd app delete argocd/<app-name>

# Set application parameters
argocd app set argocd/simplex-k1-prod --parameter key=value

Project Management

# List projects
argocd proj list

# Get project details
argocd proj get simplex

# List project roles
argocd proj role list simplex

Status Interpretation

Sync Status

Status	Meaning
`Synced`	Live state matches desired state in git
`OutOfSync`	Live state differs from git
`Unknown`	Unable to determine sync status

Health Status

Status	Meaning
`Healthy`	All resources are healthy
`Progressing`	Resources are being updated
`Degraded`	One or more resources are unhealthy
`Suspended`	Resources are suspended
`Missing`	Resources don't exist
`Unknown`	Health status unknown

Output Formatting

Status Summary

📊 ArgoCD Application Status

┌─────────────────────┬──────────┬───────────┬─────────────────┐
│ Application         │ Sync     │ Health    │ Last Sync       │
├─────────────────────┼──────────┼───────────┼─────────────────┤
│ simplex-k1-prod     │ Synced   │ Healthy   │ 2h ago          │
│ simplex-k2-staging  │ Synced   │ Healthy   │ 1h ago          │
│ simplex-local       │ OutOfSync│ Degraded  │ 30m ago         │
└─────────────────────┴──────────┴───────────┴─────────────────┘

Troubleshooting

Application Not Syncing

Check sync status: argocd app get argocd/<app>
Check for sync errors in conditions
Hard refresh: argocd app get argocd/<app> --hard-refresh
Check git repository access

ComparisonError

Usually indicates:

Git repository access issues
Invalid manifests in git
Kustomize/Helm rendering errors

Resolution:

# Hard refresh to clear cache
argocd app get argocd/<app> --hard-refresh

# Check app details for error message
argocd app get argocd/<app>

Authentication Expired

# Re-login
yes | argocd login 192.168.10.117:31006 --username admin --password CpfsoneT7ogVKWOh --insecure

Integration with Kargo

ArgoCD applications are managed by Kargo for progressive delivery:

Kargo Warehouse detects new images in ECR
Kargo Stages promote freights through environments
ArgoCD syncs the changes to clusters

Kargo-managed applications have annotation:

kargo.akuity.io/authorized-stage: kargo-simplex:prod

For progressive delivery operations, use the Kargo CLI skill.

Comments

Markdown supported

Details

Author: oldwinter
Repository: oldwinter/skills
Category: Cloud & DevOps
Installs: 50
GitHub stars: 10

Report

More skills

All skills

lark-apps

open.feishu.cn

732.0k

Develop and host Miaoda (Spark/Miaoda) apps: app creation, local full-stack development, cloud generation and iteration, creative design (UI mockups / interactive prototypes / wireframes / landing pages / dashboards / slide decks / visual exploration), integration of AI-related capabilities, Feishu platform capabilities, or other external capabilities; log/Trace/monitoring metric/PV/UV queries; environment variable management; app collaborators and collaboration permissions; app roles and members; and automation triggers (scheduled / record changes / Webhook / Feishu approvals). Use when users want to develop or create a system, tool, platform, or app; develop locally or in the cloud, modify, deploy, publish, launch, or get a shareable link; create a page or website with HTML and deploy it to Miaoda; design, create a mockup, prototype, wireframe, PPT, deck, or visual exploration; or mention Miaoda/Spark/Miaoda apps (links like `/app/app_xxx` or `/page/<token>`, runtime domains like *.aiforce.cloud), app databases, app file storage, open API Keys, visibility, app collaborators/developer permissions, app roles/role members, production logs, API request volume, error volume, latency, traffic, environment variables, or setting up automation tasks, scheduled triggers, or approval-triggered automation for Miaoda apps. Not for regular cloud drive file uploads (lark-drive), Feishu document editing (lark-doc), or native slide creation (lark-slides).

azure-prepare

github.com/microsoft

571.7k

Prepare azd-based Azure projects for deployment: generates azure.yaml, infrastructure (Bicep/Terraform), and Dockerfiles for the Azure Developer CLI (azd) workflow. USE ONLY when the user explicitly wants to use azd as the deployment tool, or the project already has an azure.yaml file. DO NOT USE FOR: non-azd deployments, Python App Service code-only deploys (use python-appservice-deploy), or cross-cloud migration (use azure-cloud-migrate). WHEN: prepare app for azd, create azure.yaml, set up azd infrastructure, modernize app for Azure with azd, deploy with azd, function app, timer trigger, service bus trigger, event-driven function, managed identity, generate Bicep, generate Terraform, create and deploy to Azure.

wizard

github.com/mattpocock

571.5k

Generate an interactive bash wizard that walks a human through steps only they can perform. Use when provisioning infrastructure, setting up credentials or CI secrets, walking an unfamiliar third-party dashboard, or running a one-off migration or cutover. Don't invoke this for steps the agent can perform itself.

azure-ai

github.com/microsoft

571.2k

Use for Azure AI: Search, Speech, OpenAI, Document Intelligence. Helps with search, vector/hybrid search, speech-to-text, text-to-speech, transcription, OCR. WHEN: AI Search, query search, vector search, hybrid search, semantic search, speech-to-text, text-to-speech, transcribe, OCR, convert text to speech.