github.com/argoproj/argo-cd/v2@v2.10.5/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 --info stringArray A list of key-value pairs during sync process. These infos will be persisted in app. 48 --label stringArray Sync only specific resources with a label. This option may be specified repeatedly. 49 --local string Path to a local directory. When this flag is present no git queries will be made 50 --local-repo-root string Path to the repository root. Used together with --local allows setting the repository root (default "/") 51 -o, --output string Output format. One of: json|yaml|wide|tree|tree=detailed (default "wide") 52 --preview-changes Preview difference against the target and live state before syncing app and wait for user confirmation 53 --project stringArray Sync apps that belong to the specified projects. This option may be specified repeatedly. 54 --prune Allow deleting unexpected resources 55 --replace Use a kubectl create/replace instead apply 56 --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 57 --retry-backoff-duration duration Retry backoff base duration. Input needs to be a duration (e.g. 2m, 1h) (default 5s) 58 --retry-backoff-factor int Factor multiplies the base duration after each failed retry (default 2) 59 --retry-backoff-max-duration duration Max retry backoff duration. Input needs to be a duration (e.g. 2m, 1h) (default 3m0s) 60 --retry-limit int Max number of allowed sync retries 61 --revision string Sync to a specific revision. Preserves parameter overrides 62 -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. 63 --server-side Use server-side apply while syncing the application 64 --strategy string Sync strategy (one of: apply|hook) 65 --timeout uint Time out after this many seconds 66 ``` 67 68 ### Options inherited from parent commands 69 70 ``` 71 --auth-token string Authentication token 72 --client-crt string Client certificate file 73 --client-crt-key string Client certificate key file 74 --config string Path to Argo CD config (default "/home/user/.config/argocd/config") 75 --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") 76 --core If set to true then CLI talks directly to Kubernetes instead of talking to Argo CD API server 77 --grpc-web Enables gRPC-web protocol. Useful if Argo CD server is behind proxy which does not support HTTP2. 78 --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. 79 -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) 80 --http-retry-max int Maximum number of retries to establish http connection to Argo CD server 81 --insecure Skip server certificate and domain verification 82 --kube-context string Directs the command to the given kube-context 83 --logformat string Set the logging format. One of: text|json (default "text") 84 --loglevel string Set the logging level. One of: debug|info|warn|error (default "info") 85 --plaintext Disable TLS 86 --port-forward Connect to a random argocd-server port using port forwarding 87 --port-forward-namespace string Namespace name which should be used for port forwarding 88 --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") 89 --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") 90 --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") 91 --server string Argo CD server address 92 --server-crt string Server certificate file 93 --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") 94 ``` 95 96 ### SEE ALSO 97 98 * [argocd app](argocd_app.md) - Manage applications 99