feat: add --set-values flags and migrate --set to alias new --set-variables (#4466)

Signed-off-by: Kit Patella <kit@defenseunicorns.com>

Author: mkcp

site/src/content/docs/commands/zarf_dev_deploy.md

@@ -21,17 +21,17 @@ zarf dev deploy [flags]
 ### Options
 
 ```
-      --adopt-existing-resources        Adopts any pre-existing K8s resources into the Helm charts managed by Zarf. ONLY use when you have existing deployments you want Zarf to takeover.
-      --components string               Comma-separated list of components to deploy.  Adding this flag will skip the prompts for selected components.  Globbing component names with '*' and deselecting 'default' components with a leading '-' are also supported.
-      --create-set stringToString       Specify package variables to set on the command line (KEY=value) (default [])
-      --deploy-set stringToString       Specify deployment variables to set on the command line (KEY=value) (default [])
-  -f, --flavor string                   The flavor of components to include in the resulting package (i.e. have a matching or empty "only.flavor" key)
-  -h, --help                            help for deploy
-      --no-yolo                         Disable the YOLO mode default override and create / deploy the package as-defined
-      --oci-concurrency int             Number of concurrent layer operations when pulling or pushing images or packages to/from OCI registries. (default 6)
-      --registry-override stringArray   Specify a mapping of domains to override on package create when pulling images (e.g. --registry-override docker.io=dockerio-reg.enterprise.intranet)
-      --retries int                     Number of retries to perform for Zarf operations like git/image pushes (default 3)
-      --timeout duration                Timeout for health checks and Helm operations such as installs and rollbacks (default 15m0s)
+      --adopt-existing-resources              Adopts any pre-existing K8s resources into the Helm charts managed by Zarf. ONLY use when you have existing deployments you want Zarf to takeover.
+      --components string                     Comma-separated list of components to deploy.  Adding this flag will skip the prompts for selected components.  Globbing component names with '*' and deselecting 'default' components with a leading '-' are also supported.
+      --create-set stringToString             Specify package templates to set on the command line (KEY=value) (default [])
+      --deploy-set-variables stringToString   Specify deployment variables to set on the command line (KEY=value) (default [])
+  -f, --flavor string                         The flavor of components to include in the resulting package (i.e. have a matching or empty "only.flavor" key)
+  -h, --help                                  help for deploy
+      --no-yolo                               Disable the YOLO mode default override and create / deploy the package as-defined
+      --oci-concurrency int                   Number of concurrent layer operations when pulling or pushing images or packages to/from OCI registries. (default 6)
+      --registry-override stringArray         Specify a mapping of domains to override on package create when pulling images (e.g. --registry-override docker.io=dockerio-reg.enterprise.intranet)
+      --retries int                           Number of retries to perform for Zarf operations like git/image pushes (default 3)
+      --timeout duration                      Timeout for health checks and Helm operations such as installs and rollbacks (default 15m0s)
 ```
 
 ### Options inherited from parent commands

site/src/content/docs/commands/zarf_dev_find-images.md

@@ -23,16 +23,16 @@ zarf dev find-images [ DIRECTORY ] [flags]
 ### Options
 
 ```
-      --create-set stringToString   Specify package variables to set on the command line (KEY=value). Note, if using a config file, this will be set by [package.create.set]. (default [])
-      --deploy-set stringToString   Specify deployment variables to set on the command line (KEY=value) (default [])
-  -f, --flavor string               The flavor of components to include in the resulting package (i.e. have a matching or empty "only.flavor" key)
-  -h, --help                        help for find-images
-      --kube-version string         Override the default helm template KubeVersion when performing a package chart template
-      --registry-url string         Override the ###ZARF_REGISTRY### value (default "127.0.0.1:31999")
-  -p, --repo-chart-path string      If git repos hold helm charts, often found with gitops tools, specify the chart path, e.g. "/" or "/chart"
-      --skip-cosign                 Skip searching for cosign artifacts related to discovered images
-  -u, --update                      Update the images in the zarf.yaml file if needed. Formatting such as comments and newlines may change.
-      --why string                  Prints the source manifest for the specified image
+      --create-set stringToString             Specify package templates to set on the command line (KEY=value). Note, if using a config file, this will be set by [package.create.set]. (default [])
+      --deploy-set-variables stringToString   Specify deployment variables to set on the command line (KEY=value) (default [])
+  -f, --flavor string                         The flavor of components to include in the resulting package (i.e. have a matching or empty "only.flavor" key)
+  -h, --help                                  help for find-images
+      --kube-version string                   Override the default helm template KubeVersion when performing a package chart template
+      --registry-url string                   Override the ###ZARF_REGISTRY### value (default "127.0.0.1:31999")
+  -p, --repo-chart-path string                If git repos hold helm charts, often found with gitops tools, specify the chart path, e.g. "/" or "/chart"
+      --skip-cosign                           Skip searching for cosign artifacts related to discovered images
+  -u, --update                                Update the images in the zarf.yaml file if needed. Formatting such as comments and newlines may change.
+      --why string                            Prints the source manifest for the specified image
 ```
 
 ### Options inherited from parent commands

site/src/content/docs/commands/zarf_dev_inspect_definition.md

@@ -23,7 +23,7 @@ zarf dev inspect definition [ DIRECTORY ] [flags]
 ```
   -f, --flavor string        The flavor of components to include in the resulting package (i.e. have a matching or empty "only.flavor" key)
   -h, --help                 help for definition
-      --set stringToString   Specify package variables to set on the command line (KEY=value) (default [])
+      --set stringToString   Specify package templates to set on the command line (KEY=value) (default [])
 ```
 
 ### Options inherited from parent commands

site/src/content/docs/commands/zarf_dev_inspect_manifests.md

@@ -17,13 +17,13 @@ zarf dev inspect manifests [ DIRECTORY ] [flags]
 ### Options
 
 ```
-      --create-set stringToString   Specify package variables to set on the command line (KEY=value) (default [])
-      --deploy-set stringToString   Specify deployment variables to set on the command line (KEY=value) (default [])
-  -f, --flavor string               The flavor of components to include in the resulting package (i.e. have a matching or empty "only.flavor" key)
-  -h, --help                        help for manifests
-      --kube-version string         Override the default helm template KubeVersion when performing a package chart template
-      --set-values stringToString   Set specific values via command line (format: key.path=value) (default [])
-      --values strings              Path to values file(s) for templating
+      --create-set stringToString             Specify package templates to set on the command line (KEY=value) (default [])
+      --deploy-set-variables stringToString   Specify deployment variables to set on the command line (KEY=value) (default [])
+  -f, --flavor string                         The flavor of components to include in the resulting package (i.e. have a matching or empty "only.flavor" key)
+  -h, --help                                  help for manifests
+      --kube-version string                   Override the default helm template KubeVersion when performing a package chart template
+      --set-values stringToString             Specify deployment package values to set on the command line (key.path=value). (default [])
+      --values strings                        [alpha] Values files to use for templating and Helm overrides. Multiple files can be passed in as a comma separated list, and the flag can be provided multiple times.
 ```
 
 ### Options inherited from parent commands

site/src/content/docs/commands/zarf_dev_inspect_values-files.md

@@ -21,13 +21,13 @@ zarf dev inspect values-files [ DIRECTORY ] [flags]
 ### Options
 
 ```
-      --create-set stringToString   Specify package variables to set on the command line (KEY=value) (default [])
-      --deploy-set stringToString   Specify deployment variables to set on the command line (KEY=value) (default [])
-  -f, --flavor string               The flavor of components to include in the resulting package (i.e. have a matching or empty "only.flavor" key)
-  -h, --help                        help for values-files
-      --kube-version string         Override the default helm template KubeVersion when performing a package chart template
-      --set-values stringToString   Set specific values via command line (format: key.path=value) (default [])
-      --values strings              Path to values file(s) for templating
+      --create-set stringToString             Specify package templates to set on the command line (KEY=value) (default [])
+      --deploy-set-variables stringToString   Specify deployment variables to set on the command line (KEY=value) (default [])
+  -f, --flavor string                         The flavor of components to include in the resulting package (i.e. have a matching or empty "only.flavor" key)
+  -h, --help                                  help for values-files
+      --kube-version string                   Override the default helm template KubeVersion when performing a package chart template
+      --set-values stringToString             Specify deployment package values to set on the command line (key.path=value). (default [])
+      --values strings                        [alpha] Values files to use for templating and Helm overrides. Multiple files can be passed in as a comma separated list, and the flag can be provided multiple times.
 ```
 
 ### Options inherited from parent commands

site/src/content/docs/commands/zarf_dev_lint.md

@@ -23,7 +23,7 @@ zarf dev lint [ DIRECTORY ] [flags]
 ```
   -f, --flavor string        The flavor of components to include in the resulting package (i.e. have a matching or empty "only.flavor" key)
   -h, --help                 help for lint
-      --set stringToString   Specify package variables to set on the command line (KEY=value) (default [])
+      --set stringToString   Specify package templates to set on the command line (KEY=value) (default [])
 ```
 
 ### Options inherited from parent commands

site/src/content/docs/commands/zarf_init.md

@@ -77,7 +77,7 @@ $ zarf init --artifact-push-password={PASSWORD} --artifact-push-username={USERNA
       --registry-secret string          Registry secret value
       --registry-url string             External registry url address to use for this Zarf cluster
       --retries int                     Number of retries to perform for Zarf operations like git/image pushes (default 3)
-      --set stringToString              Specify deployment variables to set on the command line (KEY=value) (default [])
+      --set-variables stringToString    Specify deployment variables to set on the command line (KEY=value) (default [])
       --storage-class string            Specify the storage class to use for the registry and git server.  E.g. --storage-class=standard
       --timeout duration                Timeout for health checks and Helm operations such as installs and rollbacks (default 15m0s)
       --verify                          Verify the Zarf package signature

site/src/content/docs/commands/zarf_package_create.md

@@ -33,7 +33,7 @@ zarf package create [ DIRECTORY ] [flags]
       --registry-override strings   Specify a mapping of domains to override on package create when pulling images (e.g. --registry-override docker.io=dockerio-reg.enterprise.intranet)
   -s, --sbom                        View SBOM contents after creating the package
       --sbom-out string             Specify an output directory for the SBOMs from the created Zarf package
-      --set stringToString          Specify package variables to set on the command line (KEY=value) (default [])
+      --set stringToString          Specify package templates to set on the command line (KEY=value) (default [])
       --signing-key string          Private key for signing packages. Accepts either a local file path or a Cosign-supported key provider
       --signing-key-pass string     Password to the private key used for signing packages
       --skip-sbom                   Skip generating SBOM for this package

site/src/content/docs/commands/zarf_package_deploy.md

@@ -22,19 +22,20 @@ zarf package deploy [ PACKAGE_SOURCE ] [flags]
 ### Options
 
 ```
-      --adopt-existing-resources   Adopts any pre-existing K8s resources into the Helm charts managed by Zarf. ONLY use when you have existing deployments you want Zarf to takeover.
-      --components string          Comma-separated list of components to deploy.  Adding this flag will skip the prompts for selected components.  Globbing component names with '*' and deselecting 'default' components with a leading '-' are also supported.
-  -c, --confirm                    Confirms package deployment without prompting. ONLY use with packages you trust. Skips prompts to review SBOM, configure variables, select optional components and review potential breaking changes.
-  -h, --help                       help for deploy
-  -k, --key string                 Path to public key file for validating signed packages
-  -n, --namespace string           [Alpha] Override the namespace for package deployment. Requires the package to have only one distinct namespace defined.
-      --oci-concurrency int        Number of concurrent layer operations when pulling or pushing images or packages to/from OCI registries. (default 6)
-      --retries int                Number of retries to perform for Zarf operations like git/image pushes (default 3)
-      --set stringToString         Specify deployment variables to set on the command line (KEY=value) (default [])
-      --shasum string              Shasum of the package to deploy. Required if deploying a remote https package.
-      --timeout duration           Timeout for health checks and Helm operations such as installs and rollbacks (default 15m0s)
-  -v, --values strings             [alpha] Values files to use for templating and Helm overrides. Multiple files can be passed in as a comma separated list, and the flag can be provided multiple times.
-      --verify                     Verify the Zarf package signature
+      --adopt-existing-resources       Adopts any pre-existing K8s resources into the Helm charts managed by Zarf. ONLY use when you have existing deployments you want Zarf to takeover.
+      --components string              Comma-separated list of components to deploy.  Adding this flag will skip the prompts for selected components.  Globbing component names with '*' and deselecting 'default' components with a leading '-' are also supported.
+  -c, --confirm                        Confirms package deployment without prompting. ONLY use with packages you trust. Skips prompts to review SBOM, configure variables, select optional components and review potential breaking changes.
+  -h, --help                           help for deploy
+  -k, --key string                     Path to public key file for validating signed packages
+  -n, --namespace string               [Alpha] Override the namespace for package deployment. Requires the package to have only one distinct namespace defined.
+      --oci-concurrency int            Number of concurrent layer operations when pulling or pushing images or packages to/from OCI registries. (default 6)
+      --retries int                    Number of retries to perform for Zarf operations like git/image pushes (default 3)
+      --set-values stringToString      Specify deployment package values to set on the command line (key.path=value). (default [])
+      --set-variables stringToString   Specify deployment variables to set on the command line (KEY=value) (default [])
+      --shasum string                  Shasum of the package to deploy. Required if deploying a remote https package.
+      --timeout duration               Timeout for health checks and Helm operations such as installs and rollbacks (default 15m0s)
+  -v, --values strings                 [alpha] Values files to use for templating and Helm overrides. Multiple files can be passed in as a comma separated list, and the flag can be provided multiple times.
+      --verify                         Verify the Zarf package signature
 ```
 
 ### Options inherited from parent commands

site/src/content/docs/commands/zarf_package_inspect_manifests.md

@@ -17,13 +17,13 @@ zarf package inspect manifests [ PACKAGE ] [flags]
 ### Options
 
 ```
-      --components string     comma separated list of components to show manifests for
-  -h, --help                  help for manifests
-  -k, --key string            Path to public key file for validating signed packages
-      --kube-version string   Override the default helm template KubeVersion when performing a package chart template
-      --oci-concurrency int   Number of concurrent layer operations when pulling or pushing images or packages to/from OCI registries. (default 6)
-      --set stringToString    Specify deployment variables to set on the command line (KEY=value) (default [])
-      --verify                Verify the Zarf package signature
+      --components string              comma separated list of components to show manifests for
+  -h, --help                           help for manifests
+  -k, --key string                     Path to public key file for validating signed packages
+      --kube-version string            Override the default helm template KubeVersion when performing a package chart template
+      --oci-concurrency int            Number of concurrent layer operations when pulling or pushing images or packages to/from OCI registries. (default 6)
+      --set-variables stringToString   Specify deployment variables to set on the command line (KEY=value) (default [])
+      --verify                         Verify the Zarf package signature
 ```
 
 ### Options inherited from parent commands