github.com/argoproj/argo-cd/v3@v3.2.1/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 multi-source application for specific revision of specific sources 28 argocd app sync my-app --revisions 0.0.1 --source-positions 1 --revisions 0.0.2 --source-positions 2 29 argocd app sync my-app --revisions 0.0.1 --source-names my-chart --revisions 0.0.2 --source-names my-values 30 31 # Sync a specific resource 32 # Resource should be formatted as GROUP:KIND:NAME. If no GROUP is specified then :KIND:NAME 33 argocd app sync my-app --resource :Service:my-service 34 argocd app sync my-app --resource argoproj.io:Rollout:my-rollout 35 argocd app sync my-app --resource '!apps:Deployment:my-service' 36 argocd app sync my-app --resource apps:Deployment:my-service --resource :Service:my-service 37 argocd app sync my-app --resource '!*:Service:*' 38 # Specify namespace if the application has resources with the same name in different namespaces 39 argocd app sync my-app --resource argoproj.io:Rollout:my-namespace/my-rollout 40 ``` 41 42 ### Options 43 44 ``` 45 -N, --app-namespace string Only sync an application in namespace 46 --apply-out-of-sync-only Sync only out-of-sync resources 47 --assumeYes Assume yes as answer for all user queries or prompts 48 --async Do not wait for application to sync before continuing 49 --dry-run Preview apply without affecting cluster 50 --force Use a force apply 51 -h, --help help for sync 52 --ignore-normalizer-jq-execution-timeout duration Set ignore normalizer JQ execution timeout (default 1s) 53 --info stringArray A list of key-value pairs during sync process. These infos will be persisted in app. 54 --label stringArray Sync only specific resources with a label. This option may be specified repeatedly. 55 --local string Path to a local directory. When this flag is present no git queries will be made 56 --local-repo-root string Path to the repository root. Used together with --local allows setting the repository root (default "/") 57 -o, --output string Output format. One of: json|yaml|wide|tree|tree=detailed (default "wide") 58 --preview-changes Preview difference against the target and live state before syncing app and wait for user confirmation 59 --project stringArray Sync apps that belong to the specified projects. This option may be specified repeatedly. 60 --prune Allow deleting unexpected resources 61 --replace Use a kubectl create/replace instead apply 62 --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 63 --retry-backoff-duration duration Retry backoff base duration. Input needs to be a duration (e.g. 2m, 1h) (default 5s) 64 --retry-backoff-factor int Factor multiplies the base duration after each failed retry (default 2) 65 --retry-backoff-max-duration duration Max retry backoff duration. Input needs to be a duration (e.g. 2m, 1h) (default 3m0s) 66 --retry-limit int Max number of allowed sync retries 67 --retry-refresh Indicates if the latest revision should be used on retry instead of the initial one 68 --revision string Sync to a specific revision. Preserves parameter overrides 69 --revisions stringArray Show manifests at specific revisions for source position in source-positions 70 -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. 71 --server-side Use server-side apply while syncing the application 72 --source-names stringArray List of source names. Default is an empty array. 73 --source-positions int64Slice List of source positions. Default is empty array. Counting start at 1. (default []) 74 --strategy string Sync strategy (one of: apply|hook) 75 --timeout uint Time out after this many seconds 76 ``` 77 78 ### Options inherited from parent commands 79 80 ``` 81 --argocd-context string The name of the Argo-CD server context to use 82 --auth-token string Authentication token; set this or the ARGOCD_AUTH_TOKEN environment variable 83 --client-crt string Client certificate file 84 --client-crt-key string Client certificate key file 85 --config string Path to Argo CD config (default "/home/user/.config/argocd/config") 86 --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") 87 --core If set to true then CLI talks directly to Kubernetes instead of talking to Argo CD API server 88 --grpc-web Enables gRPC-web protocol. Useful if Argo CD server is behind proxy which does not support HTTP2. 89 --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. 90 -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) 91 --http-retry-max int Maximum number of retries to establish http connection to Argo CD server 92 --insecure Skip server certificate and domain verification 93 --kube-context string Directs the command to the given kube-context 94 --logformat string Set the logging format. One of: json|text (default "json") 95 --loglevel string Set the logging level. One of: debug|info|warn|error (default "info") 96 --plaintext Disable TLS 97 --port-forward Connect to a random argocd-server port using port forwarding 98 --port-forward-namespace string Namespace name which should be used for port forwarding 99 --prompts-enabled Force optional interactive prompts to be enabled or disabled, overriding local configuration. If not specified, the local configuration value will be used, which is false by default. 100 --redis-compress string Enable this if the application controller is configured with redis compression enabled. (possible values: gzip, none) (default "gzip") 101 --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") 102 --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") 103 --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") 104 --server string Argo CD server address 105 --server-crt string Server certificate file 106 --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") 107 ``` 108 109 ### SEE ALSO 110 111 * [argocd app](argocd_app.md) - Manage applications 112