LinuxCommandLibrary

argocd

Manage declarative GitOps CD workflows for Kubernetes

TLDR

Login to Argo CD server

$ argocd login --insecure --username [user] --password [password] [argocd_server:port]
copy

List applications
$ argocd app list
copy

SYNOPSIS

argocd [global-flags] <subcommand> [<args>]

PARAMETERS

--auth-token string
    Authentication token for API server

--config string
    Path to config file (default ~/.config/argocd/config)

--grpc-web
    Enables gRPC-web mode for browser/proxy access

--grpc-web-root-path string
    gRPC-web proxy path (default '/grpc-web/')

--header strings
    Add custom HTTP headers (repeatable)

--help
    Show help for command

--insecure
    Skip TLS certificate/domain verification

--kubeconfig string
    Path to kubeconfig file

--loglevel string
    Set log level: debug|info|warn|error (default 'info')

--port-forward
    Use kubectl port-forward to connect to server

--server string
    ArgoCD API server address (default localhost:8080)

--tls-client-cert-key string
    Path to client TLS cert key

--tls-client-cert-name string
    TLS cert name in secret

--tls-client-cert-path string
    Path to client TLS certificate

--username string
    Username for basic auth

--password string
    Password for basic auth

DESCRIPTION

argocd is the official command-line interface (CLI) for ArgoCD, a declarative continuous delivery platform for Kubernetes based on GitOps principles.

ArgoCD follows the GitOps pattern: applications are described declaratively via Kubernetes manifests or Helm charts stored in Git repositories. The ArgoCD server continuously monitors these repositories, compares the desired state (Git) with the live state (Kubernetes cluster), and automatically applies changes to achieve synchronization.

The CLI enables users to manage ArgoCD resources such as applications, clusters, projects, repositories, and secrets. Common operations include creating, syncing, and deleting applications; adding clusters; managing RBAC; and logging in with various auth methods. It supports both interactive use and automation in CI/CD pipelines.

Key features include multi-tenancy support, application health checks, rollouts with analysis, and integration with tools like Helm, Kustomize, and Jsonnet. Designed for operators and developers, it simplifies Kubernetes deployments by leveraging Git as the single source of truth.

Requires a running ArgoCD server and kubectl access to target clusters.

CAVEATS

Requires running ArgoCD server; most operations need auth token or login. Not a standard distro package—install via script or package manager. Subcommands have additional flags; use argocd <subcommand> --help for details.

MAIN SUBCOMMANDS

app: manage applications; cluster: add/manage clusters; project: RBAC projects; repo: repositories; login: authenticate CLI.

INSTALLATION

curl -sSL -o argocd https://github.com/argoproj/argo-cd/releases/latest/download/argocd-linux-amd64 && sudo mv argocd /usr/local/bin/

HISTORY

Originally developed by Intuit in 2018 as open-source GitOps tool for Kubernetes. Joined CNCF as Sandbox project in 2020, graduated to Incubating in 2022. CLI evolves with server releases; current v2.12+ emphasizes security and multi-cluster support.

SEE ALSO

kubectl(1), helm(1), kustomize(1), git(1)

Copied to clipboard