A few sets of arguments are common between multiple commands. These arguments are still part of the command itself and must be placed after the command name.
These arguments are available for all commands.
Global arguments: --cpu-profile string Enable CPU profiling and write the result to the given path --debug Enable debug logging --no-color Disable colored output --no-update-check Disable update check on startup
These arguments are available for all commands that are based on a Kluctl project. They control where and how to load the kluctl project and deployment project.
Project arguments: Define where and how to load the kluctl project and its components from. -a, --arg stringArray Passes a template argument in the form of name=value. Nested args can be set with the '-a my.nested.arg=value' syntax. Values are interpreted as yaml values, meaning that 'true' and 'false' will lead to boolean values and numbers will be treated as numbers. Use quotes if you want these to be treated as strings. If the value starts with @, it is treated as a file, meaning that the contents of the file will be loaded and treated as yaml. --args-from-file stringArray Loads a yaml file and makes it available as arguments, meaning that they will be available thought the global 'args' variable. --context string Overrides the context name specified in the target. If the selected target does not specify a context or the no-name target is used, --context will override the currently active context. --git-cache-update-interval duration Specify the time to wait between git cache updates. Defaults to not wait at all and always updating caches. --local-git-group-override stringArray Same as --local-git-override, but for a whole group prefix instead of a single repository. All repositories that have the given prefix will be overridden with the given local path and the repository suffix appended. For example, 'gitlab.com:some-org/sub-org=/local/path/to/my-forks' will override all repositories below 'gitlab.com:some-org/sub-org/' with the repositories found in '/local/path/to/my-forks'. It will however only perform an override if the given repository actually exists locally and otherwise revert to the actual (non-overridden) repository. --local-git-override stringArray Specify a single repository local git override in the form of 'github.com:my-org/my-repo=/local/path/to/override'. This will cause kluctl to not use git to clone for the specified repository but instead use the local directory. This is useful in case you need to test out changes in external git repositories without pushing them. -c, --project-config existingfile Location of the .kluctl.yaml config file. Defaults to $PROJECT/.kluctl.yaml --project-dir existingdir Specify the project directory. Defaults to the current working directory. -t, --target string Target name to run command for. Target must exist in .kluctl.yaml. -T, --target-name-override string Overrides the target name. If -t is used at the same time, then the target will be looked up based on -t <name> and then renamed to the value of -T. If no target is specified via -t, then the no-name target is renamed to the value of -T. --timeout duration Specify timeout for all operations, including loading of the project, all external api calls and waiting for readiness. (default 10m0s)
These arguments are available on some target based commands.
They control image versions requested by
Image arguments: Control fixed images and update behaviour. -F, --fixed-image stringArray Pin an image to a given version. Expects '--fixed-image=image<:namespace:deployment:container>=result' --fixed-images-file existingfile Use .yaml file to pin image versions. See output of list-images sub-command or read the documentation for details about the output format
These arguments are available for some target based commands. They control inclusion/exclusion based on tags and deployment item pathes.
Inclusion/Exclusion arguments: Control inclusion/exclusion. --exclude-deployment-dir stringArray Exclude deployment dir. The path must be relative to the root deployment project. Exclusion has precedence over inclusion, same as in --exclude-tag -E, --exclude-tag stringArray Exclude deployments with given tag. Exclusion has precedence over inclusion, meaning that explicitly excluded deployments will always be excluded even if an inclusion rule would match the same deployment. --include-deployment-dir stringArray Include deployment dir. The path must be relative to the root deployment project. -I, --include-tag stringArray Include deployments with given tag.
Command Results arguments
These arguments control how command results are stored.
Command Results: Configure how command results are stored. --command-result-namespace string Override the namespace to be used when writing command results. (default "kluctl-results") --force-write-command-result Force writing of command results, even if the command is run in dry-run mode. --keep-command-results-count int Configure how many old command results to keep. (default 10) --write-command-result Enable writing of command results into the cluster.