argocd app create: Define an Application
argocd app create registers a new Application that maps a Git repo path to a destination cluster and namespace.
An Application is the core Argo CD object: source repo plus destination plus sync policy. Creating it from the CLI lets a pipeline bootstrap or update the definition.
What it does
argocd app create defines an Application resource pointing at a source (--repo plus --path, or a Helm chart) and a destination (--dest-server or --dest-name, plus --dest-namespace). Without --sync-policy the app is created OutOfSync and waits for a manual sync.
Common usage
argocd app create guestbook \
--repo https://github.com/acme/manifests.git \
--path guestbook --revision main \
--dest-server https://kubernetes.default.svc \
--dest-namespace guestbook \
--sync-policy automated --auto-pruneOptions
| Flag | What it does |
|---|---|
| --repo <url> | Source Git repository URL |
| --path <dir> | Directory within the repo holding manifests |
| --revision <ref> | Git branch, tag, or commit to track |
| --dest-server / --dest-name | Target cluster API URL or registered name |
| --dest-namespace <ns> | Namespace to deploy into |
| --sync-policy automated | Enable auto-sync (default is manual) |
| --helm-set key=value | Override a Helm value for a chart source |
Common errors in CI
"FATA[0000] rpc error: code = NotFound desc = repository not found" means the --repo was never added with argocd repo add (or lacks credentials). "application destination ... is not permitted in project" means the AppProject restricts that cluster/namespace; widen the project or use --project. "cluster ... not found" means --dest-server is not a registered cluster.