github.com/argoproj/argo-cd/v3@v3.2.1/docs/user-guide/commands/argocd_app_set.md (about)

     1  # `argocd app set` Command Reference
     2  
     3  ## argocd app set
     4  
     5  Set application parameters
     6  
     7  ```
     8  argocd app set APPNAME [flags]
     9  ```
    10  
    11  ### Examples
    12  
    13  ```
    14    # Set application parameters for the application "my-app"
    15    argocd app set my-app --parameter key1=value1 --parameter key2=value2
    16    
    17    # Set and validate application parameters for "my-app"
    18    argocd app set my-app --parameter key1=value1 --parameter key2=value2 --validate
    19    
    20    # Set and override application parameters for a source at position 1 under spec.sources of app my-app. source-position starts at 1.
    21    argocd app set my-app --source-position 1 --repo https://github.com/argoproj/argocd-example-apps.git
    22    
    23    # Set and override application parameters for a source named "test" under spec.sources of app my-app.
    24    argocd app set my-app --source-name test --repo https://github.com/argoproj/argocd-example-apps.git
    25    
    26    # Set application parameters and specify the namespace
    27    argocd app set my-app --parameter key1=value1 --parameter key2=value2 --namespace my-namespace
    28  ```
    29  
    30  ### Options
    31  
    32  ```
    33        --allow-empty                                Set allow zero live resources when sync is automated
    34    -N, --app-namespace string                       Set application parameters in namespace
    35        --auto-prune                                 Set automatic pruning when sync is automated
    36        --config-management-plugin string            Config management plugin name
    37        --dest-name string                           K8s cluster Name (e.g. minikube)
    38        --dest-namespace string                      K8s target namespace
    39        --dest-server string                         K8s cluster URL (e.g. https://kubernetes.default.svc)
    40        --directory-exclude string                   Set glob expression used to exclude files from application source path
    41        --directory-include string                   Set glob expression used to include files from application source path
    42        --directory-recurse                          Recurse directory
    43        --dry-source-path string                     Path in repository to the app directory for the dry source
    44        --dry-source-repo string                     Repository URL of the app dry source
    45        --dry-source-revision string                 Revision of the app dry source
    46        --env string                                 Application environment to monitor
    47        --helm-api-versions stringArray              Helm api-versions (in format [group/]version/kind) to use when running helm template (Can be repeated to set several values: --helm-api-versions traefik.io/v1alpha1/TLSOption --helm-api-versions v1/Service). If not set, use the api-versions from the destination cluster
    48        --helm-chart string                          Helm Chart name
    49        --helm-kube-version string                   Helm kube-version to use when running helm template. If not set, use the kube version from the destination cluster
    50        --helm-namespace string                      Helm namespace to use when running helm template. If not set, use app.spec.destination.namespace
    51        --helm-pass-credentials                      Pass credentials to all domain
    52        --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)
    53        --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)
    54        --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)
    55        --helm-skip-crds                             Skip helm crd installation step
    56        --helm-skip-schema-validation                Skip helm schema validation step
    57        --helm-skip-tests                            Skip helm test manifests installation step
    58        --helm-version string                        Helm version
    59    -h, --help                                       help for set
    60        --hydrate-to-branch string                   The branch to hydrate the app to
    61        --ignore-missing-components                  Ignore locally missing component directories when setting Kustomize components
    62        --ignore-missing-value-files                 Ignore locally missing valueFiles when setting helm template --values
    63        --jsonnet-ext-var-code stringArray           Jsonnet ext var
    64        --jsonnet-ext-var-str stringArray            Jsonnet string ext var
    65        --jsonnet-libs stringArray                   Additional jsonnet libs (prefixed by repoRoot)
    66        --jsonnet-tla-code stringArray               Jsonnet top level code arguments
    67        --jsonnet-tla-str stringArray                Jsonnet top level string arguments
    68        --kustomize-api-versions stringArray         api-versions (in format [group/]version/kind) to use when running helm template (Can be repeated to set several values: --helm-api-versions traefik.io/v1alpha1/TLSOption --helm-api-versions v1/Service). If not set, use the api-versions from the destination cluster. Only applicable when Helm is enabled for Kustomize builds
    69        --kustomize-common-annotation stringArray    Set common labels in Kustomize
    70        --kustomize-common-label stringArray         Set common labels in Kustomize
    71        --kustomize-force-common-annotation          Force common annotations in Kustomize
    72        --kustomize-force-common-label               Force common labels in Kustomize
    73        --kustomize-image stringArray                Kustomize images (e.g. --kustomize-image node:8.15.0 --kustomize-image mysql=mariadb,alpine@sha256:24a0c4b4a4c0eb97a1aabb8e29f18e917d05abfe1b7a7c07857230879ce7d3d)
    74        --kustomize-kube-version string              kube-version to use when running helm template. If not set, use the kube version from the destination cluster. Only applicable when Helm is enabled for Kustomize builds
    75        --kustomize-label-include-templates          Apply common label to resource templates
    76        --kustomize-label-without-selector           Do not apply common label to selectors. Also do not apply label to templates unless --kustomize-label-include-templates is set
    77        --kustomize-namespace string                 Kustomize namespace
    78        --kustomize-replica stringArray              Kustomize replicas (e.g. --kustomize-replica my-development=2 --kustomize-replica my-statefulset=4)
    79        --kustomize-version string                   Kustomize version
    80        --nameprefix string                          Kustomize nameprefix
    81        --namesuffix string                          Kustomize namesuffix
    82    -p, --parameter stringArray                      set a parameter override (e.g. -p guestbook=image=example/guestbook:latest)
    83        --path string                                Path in repository to the app directory, ignored if a file is set
    84        --plugin-env stringArray                     Additional plugin envs
    85        --project string                             Application project name
    86        --ref string                                 Ref is reference to another source within sources field
    87        --release-name string                        Helm release-name
    88        --repo string                                Repository URL, ignored if a file is set
    89        --revision string                            The tracking source branch, tag, commit or Helm chart version the application will sync to
    90        --revision-history-limit int                 How many items to keep in revision history (default 10)
    91        --self-heal                                  Set self healing when sync is automated
    92        --source-name string                         Name of the source from the list of sources of the app.
    93        --source-position int                        Position of the source from the list of sources of the app. Counting starts at 1. (default -1)
    94        --sync-option Prune=false                    Add or remove a sync option, e.g add Prune=false. Remove using `!` prefix, e.g. `!Prune=false`
    95        --sync-policy string                         Set the sync policy (one of: manual (aliases of manual: none), automated (aliases of automated: auto, automatic))
    96        --sync-retry-backoff-duration duration       Sync retry backoff base duration. Input needs to be a duration (e.g. 2m, 1h) (default 5s)
    97        --sync-retry-backoff-factor int              Factor multiplies the base duration after each failed sync retry (default 2)
    98        --sync-retry-backoff-max-duration duration   Max sync retry backoff duration. Input needs to be a duration (e.g. 2m, 1h) (default 3m0s)
    99        --sync-retry-limit int                       Max number of allowed sync retries
   100        --sync-retry-refresh                         Indicates if the latest revision should be used on retry instead of the initial one
   101        --sync-source-branch string                  The branch from which the app will sync
   102        --sync-source-path string                    The path in the repository from which the app will sync
   103        --validate                                   Validation of repo and cluster (default true)
   104        --values stringArray                         Helm values file(s) to use
   105        --values-literal-file string                 Filename or URL to import as a literal Helm values block
   106  ```
   107  
   108  ### Options inherited from parent commands
   109  
   110  ```
   111        --argocd-context string           The name of the Argo-CD server context to use
   112        --auth-token string               Authentication token; set this or the ARGOCD_AUTH_TOKEN environment variable
   113        --client-crt string               Client certificate file
   114        --client-crt-key string           Client certificate key file
   115        --config string                   Path to Argo CD config (default "/home/user/.config/argocd/config")
   116        --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")
   117        --core                            If set to true then CLI talks directly to Kubernetes instead of talking to Argo CD API server
   118        --grpc-web                        Enables gRPC-web protocol. Useful if Argo CD server is behind proxy which does not support HTTP2.
   119        --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.
   120    -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)
   121        --http-retry-max int              Maximum number of retries to establish http connection to Argo CD server
   122        --insecure                        Skip server certificate and domain verification
   123        --kube-context string             Directs the command to the given kube-context
   124        --logformat string                Set the logging format. One of: json|text (default "json")
   125        --loglevel string                 Set the logging level. One of: debug|info|warn|error (default "info")
   126        --plaintext                       Disable TLS
   127        --port-forward                    Connect to a random argocd-server port using port forwarding
   128        --port-forward-namespace string   Namespace name which should be used for port forwarding
   129        --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.
   130        --redis-compress string           Enable this if the application controller is configured with redis compression enabled. (possible values: gzip, none) (default "gzip")
   131        --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")
   132        --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")
   133        --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")
   134        --server string                   Argo CD server address
   135        --server-crt string               Server certificate file
   136        --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")
   137  ```
   138  
   139  ### SEE ALSO
   140  
   141  * [argocd app](argocd_app.md)	 - Manage applications
   142