github.com/argoproj/argo-cd/v2@v2.10.9/docs/user-guide/commands/argocd_app_sync.md (about) 1 # `argocd app sync` Command Reference 2 3 ## argocd app sync 4 5 Sync an application to its target state 6 7 ``` 8 argocd app sync [APPNAME... | -l selector | --project project-name] [flags] 9 ``` 10 11 ### Examples 12 13 ``` 14 # Sync an app 15 argocd app sync my-app 16 17 # Sync multiples apps 18 argocd app sync my-app other-app 19 20 # Sync apps by label, in this example we sync apps that are children of another app (aka app-of-apps) 21 argocd app sync -l app.kubernetes.io/instance=my-app 22 argocd app sync -l app.kubernetes.io/instance!=my-app 23 argocd app sync -l app.kubernetes.io/instance 24 argocd app sync -l '!app.kubernetes.io/instance' 25 argocd app sync -l 'app.kubernetes.io/instance notin (my-app,other-app)' 26 27 # Sync a specific resource 28 # Resource should be formatted as GROUP:KIND:NAME. If no GROUP is specified then :KIND:NAME 29 argocd app sync my-app --resource :Service:my-service 30 argocd app sync my-app --resource argoproj.io:Rollout:my-rollout 31 argocd app sync my-app --resource '!apps:Deployment:my-service' 32 argocd app sync my-app --resource apps:Deployment:my-service --resource :Service:my-service 33 argocd app sync my-app --resource '!*:Service:*' 34 # Specify namespace if the application has resources with the same name in different namespaces 35 argocd app sync my-app --resource argoproj.io:Rollout:my-namespace/my-rollout 36 ``` 37 38 ### Options 39 40 ``` 41 --apply-out-of-sync-only Sync only out-of-sync resources 42 --assumeYes Assume yes as answer for all user queries or prompts 43 --async Do not wait for application to sync before continuing 44 --dry-run Preview apply without affecting cluster 45 --force Use a force apply 46 -h, --help help for sync 47 --ignore-normalizer-jq-execution-timeout duration Set ignore normalizer JQ execution timeout (default 1s) 48 --info stringArray A list of key-value pairs during sync process. These infos will be persisted in app. 49 --label stringArray Sync only specific resources with a label. This option may be specified repeatedly. 50 --local string Path to a local directory. When this flag is present no git queries will be made 51 --local-repo-root string Path to the repository root. Used together with --local allows setting the repository root (default "/") 52 -o, --output string Output format. One of: json|yaml|wide|tree|tree=detailed (default "wide") 53 --preview-changes Preview difference against the target and live state before syncing app and wait for user confirmation 54 --project stringArray Sync apps that belong to the specified projects. This option may be specified repeatedly. 55 --prune Allow deleting unexpected resources 56 --replace Use a kubectl create/replace instead apply 57 --resource stringArray Sync only specific resources as GROUP:KIND:NAME or !GROUP:KIND:NAME. Fields may be blank and '*' can be used. This option may be specified repeatedly 58 --retry-backoff-duration duration Retry backoff base duration. Input needs to be a duration (e.g. 2m, 1h) (default 5s) 59 --retry-backoff-factor int Factor multiplies the base duration after each failed retry (default 2) 60 --retry-backoff-max-duration duration Max retry backoff duration. Input needs to be a duration (e.g. 2m, 1h) (default 3m0s) 61 --retry-limit int Max number of allowed sync retries 62 --revision string Sync to a specific revision. Preserves parameter overrides 63 -l, --selector string Sync apps that match this label. Supports '=', '==', '!=', in, notin, exists & not exists. Matching apps must satisfy all of the specified label constraints. 64 --server-side Use server-side apply while syncing the application 65 --strategy string Sync strategy (one of: apply|hook) 66 --timeout uint Time out after this many seconds 67 ``` 68 69 ### Options inherited from parent commands 70 71 ``` 72 --auth-token string Authentication token 73 --client-crt string Client certificate file 74 --client-crt-key string Client certificate key file 75 --config string Path to Argo CD config (default "/home/user/.config/argocd/config") 76 --controller-name string Name of the Argo CD Application controller; set this or the ARGOCD_APPLICATION_CONTROLLER_NAME environment variable when the controller's name label differs from the default, for example when installing via the Helm chart (default "argocd-application-controller") 77 --core If set to true then CLI talks directly to Kubernetes instead of talking to Argo CD API server 78 --grpc-web Enables gRPC-web protocol. Useful if Argo CD server is behind proxy which does not support HTTP2. 79 --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. 80 -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) 81 --http-retry-max int Maximum number of retries to establish http connection to Argo CD server 82 --insecure Skip server certificate and domain verification 83 --kube-context string Directs the command to the given kube-context 84 --logformat string Set the logging format. One of: text|json (default "text") 85 --loglevel string Set the logging level. One of: debug|info|warn|error (default "info") 86 --plaintext Disable TLS 87 --port-forward Connect to a random argocd-server port using port forwarding 88 --port-forward-namespace string Namespace name which should be used for port forwarding 89 --redis-haproxy-name string Name of the Redis HA Proxy; set this or the ARGOCD_REDIS_HAPROXY_NAME environment variable when the HA Proxy's name label differs from the default, for example when installing via the Helm chart (default "argocd-redis-ha-haproxy") 90 --redis-name string Name of the Redis deployment; set this or the ARGOCD_REDIS_NAME environment variable when the Redis's name label differs from the default, for example when installing via the Helm chart (default "argocd-redis") 91 --repo-server-name string Name of the Argo CD Repo server; set this or the ARGOCD_REPO_SERVER_NAME environment variable when the server's name label differs from the default, for example when installing via the Helm chart (default "argocd-repo-server") 92 --server string Argo CD server address 93 --server-crt string Server certificate file 94 --server-name string Name of the Argo CD API server; set this or the ARGOCD_SERVER_NAME environment variable when the server's name label differs from the default, for example when installing via the Helm chart (default "argocd-server") 95 ``` 96 97 ### SEE ALSO 98 99 * [argocd app](argocd_app.md) - Manage applications 100