mirror of
https://github.com/argoproj/argo-cd
synced 2026-04-30 13:27:18 +00:00
311926b8c9
* fix: argocd core commands should not drop existing persistent flags Signed-off-by: Alexander Matyushentsev <AMatyushentsev@gmail.com> * run cli codegen Signed-off-by: Alexander Matyushentsev <AMatyushentsev@gmail.com>
115 lines
8.7 KiB
Markdown
115 lines
8.7 KiB
Markdown
## argocd app create
|
|
|
|
Create an application
|
|
|
|
```
|
|
argocd app create APPNAME [flags]
|
|
```
|
|
|
|
### Examples
|
|
|
|
```
|
|
|
|
# Create a directory app
|
|
argocd app create guestbook --repo https://github.com/argoproj/argocd-example-apps.git --path guestbook --dest-namespace default --dest-server https://kubernetes.default.svc --directory-recurse
|
|
|
|
# Create a Jsonnet app
|
|
argocd app create jsonnet-guestbook --repo https://github.com/argoproj/argocd-example-apps.git --path jsonnet-guestbook --dest-namespace default --dest-server https://kubernetes.default.svc --jsonnet-ext-str replicas=2
|
|
|
|
# Create a Helm app
|
|
argocd app create helm-guestbook --repo https://github.com/argoproj/argocd-example-apps.git --path helm-guestbook --dest-namespace default --dest-server https://kubernetes.default.svc --helm-set replicaCount=2
|
|
|
|
# Create a Helm app from a Helm repo
|
|
argocd app create nginx-ingress --repo https://charts.helm.sh/stable --helm-chart nginx-ingress --revision 1.24.3 --dest-namespace default --dest-server https://kubernetes.default.svc
|
|
|
|
# Create a Kustomize app
|
|
argocd app create kustomize-guestbook --repo https://github.com/argoproj/argocd-example-apps.git --path kustomize-guestbook --dest-namespace default --dest-server https://kubernetes.default.svc --kustomize-image gcr.io/heptio-images/ks-guestbook-demo:0.1
|
|
|
|
# Create a app using a custom tool:
|
|
argocd app create ksane --repo https://github.com/argoproj/argocd-example-apps.git --path plugins/kasane --dest-namespace default --dest-server https://kubernetes.default.svc --config-management-plugin kasane
|
|
|
|
```
|
|
|
|
### Options
|
|
|
|
```
|
|
--allow-empty Set allow zero live resources when sync is automated
|
|
--annotations stringArray Set metadata annotations (e.g. example=value)
|
|
--auto-prune Set automatic pruning when sync is automated
|
|
--config-management-plugin string Config management plugin name
|
|
--dest-name string K8s cluster Name (e.g. minikube)
|
|
--dest-namespace string K8s target namespace (overrides the namespace specified in the ksonnet app.yaml)
|
|
--dest-server string K8s cluster URL (e.g. https://kubernetes.default.svc)
|
|
--directory-exclude string Set glob expression used to exclude files from application source path
|
|
--directory-include string Set glob expression used to include files from application source path
|
|
--directory-recurse Recurse directory
|
|
--env string Application environment to monitor
|
|
-f, --file string Filename or URL to Kubernetes manifests for the app
|
|
--helm-chart string Helm Chart name
|
|
--helm-set stringArray Helm set values on the command line (can be repeated to set several values: --helm-set key1=val1 --helm-set key2=val2)
|
|
--helm-set-file stringArray Helm set values from respective files specified via the command line (can be repeated to set several values: --helm-set-file key1=path1 --helm-set-file key2=path2)
|
|
--helm-set-string stringArray Helm set STRING values on the command line (can be repeated to set several values: --helm-set-string key1=val1 --helm-set-string key2=val2)
|
|
--helm-version string Helm version
|
|
-h, --help help for create
|
|
--jsonnet-ext-var-code stringArray Jsonnet ext var
|
|
--jsonnet-ext-var-str stringArray Jsonnet string ext var
|
|
--jsonnet-libs stringArray Additional jsonnet libs (prefixed by repoRoot)
|
|
--jsonnet-tla-code stringArray Jsonnet top level code arguments
|
|
--jsonnet-tla-str stringArray Jsonnet top level string arguments
|
|
--kustomize-common-annotation stringArray Set common labels in Kustomize
|
|
--kustomize-common-label stringArray Set common labels in Kustomize
|
|
--kustomize-force-common-annotation Force common annotations in Kustomize
|
|
--kustomize-force-common-label Force common labels in Kustomize
|
|
--kustomize-image stringArray Kustomize images (e.g. --kustomize-image node:8.15.0 --kustomize-image mysql=mariadb,alpine@sha256:24a0c4b4a4c0eb97a1aabb8e29f18e917d05abfe1b7a7c07857230879ce7d3d)
|
|
--kustomize-version string Kustomize version
|
|
-l, --label stringArray Labels to apply to the app
|
|
--name string A name for the app, ignored if a file is set (DEPRECATED)
|
|
--nameprefix string Kustomize nameprefix
|
|
--namesuffix string Kustomize namesuffix
|
|
-p, --parameter stringArray set a parameter override (e.g. -p guestbook=image=example/guestbook:latest)
|
|
--path string Path in repository to the app directory, ignored if a file is set
|
|
--plugin-env stringArray Additional plugin envs
|
|
--project string Application project name
|
|
--release-name string Helm release-name
|
|
--repo string Repository URL, ignored if a file is set
|
|
--revision string The tracking source branch, tag, commit or Helm chart version the application will sync to
|
|
--revision-history-limit int How many items to keep in revision history (default 10)
|
|
--self-heal Set self healing when sync is automated
|
|
--sync-option Prune=false Add or remove a sync option, e.g add Prune=false. Remove using `!` prefix, e.g. `!Prune=false`
|
|
--sync-policy string Set the sync policy (one of: none, automated (aliases of automated: auto, automatic))
|
|
--sync-retry-backoff-duration duration Sync retry backoff base duration. Input needs to be a duration (e.g. 2m, 1h) (default 5s)
|
|
--sync-retry-backoff-factor int Factor multiplies the base duration after each failed sync retry (default 2)
|
|
--sync-retry-backoff-max-duration duration Max sync retry backoff duration. Input needs to be a duration (e.g. 2m, 1h) (default 3m0s)
|
|
--sync-retry-limit int Max number of allowed sync retries
|
|
--upsert Allows to override application with the same name even if supplied application spec is different from existing spec
|
|
--validate Validation of repo and cluster (default true)
|
|
--values stringArray Helm values file(s) to use
|
|
--values-literal-file string Filename or URL to import as a literal Helm values block
|
|
```
|
|
|
|
### Options inherited from parent commands
|
|
|
|
```
|
|
--auth-token string Authentication token
|
|
--client-crt string Client certificate file
|
|
--client-crt-key string Client certificate key file
|
|
--config string Path to Argo CD config (default "/home/user/.argocd/config")
|
|
--core If set to true then CLI talks directly to Kubernetes instead of talking to Argo CD API server
|
|
--grpc-web Enables gRPC-web protocol. Useful if Argo CD server is behind proxy which does not support HTTP2.
|
|
--grpc-web-root-path string Enables gRPC-web protocol. Useful if Argo CD server is behind proxy which does not support HTTP2. Set web root.
|
|
-H, --header strings Sets additional header to all requests made by Argo CD CLI. (Can be repeated multiple times to add multiple headers, also supports comma separated headers)
|
|
--http-retry-max int Maximum number of retries to establish http connection to Argo CD server
|
|
--insecure Skip server certificate and domain verification
|
|
--logformat string Set the logging format. One of: text|json (default "text")
|
|
--loglevel string Set the logging level. One of: debug|info|warn|error (default "info")
|
|
--plaintext Disable TLS
|
|
--port-forward Connect to a random argocd-server port using port forwarding
|
|
--port-forward-namespace string Namespace name which should be used for port forwarding
|
|
--server string Argo CD server address
|
|
--server-crt string Server certificate file
|
|
```
|
|
|
|
### SEE ALSO
|
|
|
|
* [argocd app](argocd_app.md) - Manage applications
|
|
|