v1alpha1

Standard object's metadata.

Configuration spec.

Standard object's metadata.

Test spec.

Standard object's metadata.

TestStep spec.

Timeout for the operation. Overrides the global timeout set in the Configuration.

FileRefOrResource provides a reference to the resources to be applied.

DryRun determines whether the file should be applied in dry run mode.

Expect defines a list of matched checks to validate the operation outcome.

Timeout for the operation. Overrides the global timeout set in the Configuration.

FileRefOrAssert provides a reference to the assertion.

Description contains a description of the operation.

PodLogs determines the pod logs collector to execute.

Events determines the events collector to execute.

Command defines a command to run.

Script defines a script to run.

Sleep defines zzzz.

Timeout for the operation. Overrides the global timeout set in the Configuration.

Entrypoint is the command entry point to run.

Args is the command arguments.

SkipLogOutput removes the output from the command. Useful for sensitive logs or to reduce noise.

Check is an assertion tree to validate the operation outcome.

Global timeouts configuration. Applies to all tests/test steps if not overridden.

If set, do not delete the resources after running the tests (implies SkipClusterDelete).

FailFast determines whether the test should stop upon encountering the first failure.

The maximum number of tests to run at once.

ReportFormat determines test report format (JSON

ReportName defines the name of report to create. It defaults to "chainsaw-report".

Namespace defines the namespace to use for tests. If not specified, every test will execute in a random ephemeral namespace unless the namespace is overridden in a the test spec.

FullName makes use of the full test case folder path instead of the folder name.

ExcludeTestRegex is used to exclude tests based on a regular expression.

IncludeTestRegex is used to include tests based on a regular expression.

RepeatCount indicates how many times the tests should be executed.

TestFile is the name of the file containing the test to run.

ForceTerminationGracePeriod forces the termination grace period on pods, statefulsets, daemonsets and deployments.

DelayBeforeCleanup adds a delay between the time a test ends and the time cleanup starts.

Timeout for the operation. Overrides the global timeout set in the Configuration.

FileRefOrResource provides a reference to the file containing the resources to be created.

DryRun determines whether the file should be applied in dry run mode.

Expect defines a list of matched checks to validate the operation outcome.

Timeout for the operation. Overrides the global timeout set in the Configuration.

ObjectReference determines objects to be deleted.

Expect defines a list of matched checks to validate the operation outcome.

Timeout for the operation. Overrides the global timeout set in the Configuration.

FileRefOrAssert provides a reference to the expected error.

Timeout for the operation. Overrides the global timeout set in the Configuration.

Namespace of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/

Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

Selector defines labels selector.

Match defines the matching statement.

Match defines the matching statement.

File is the path to the referenced file. This can be a direct path to a file or an expression that matches multiple files, such as "manifest/*.yaml" for all YAML files within the "manifest" directory.

FileRef provides a reference to the file containing the resources to be applied.

Resource provides a check used in assertions.

FileRef provides a reference to the file containing the resources to be applied.

Resource provides a resource to be applied.

Description contains a description of the operation.

PodLogs determines the pod logs collector to execute.

Events determines the events collector to execute.

Command defines a command to run.

Script defines a script to run.

Sleep defines zzzz.

ObjectSelector determines the selection process of referenced objects.

API version of the referent.

Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

Namespace of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/

Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

Label selector to match objects to delete

Description contains a description of the operation.

ContinueOnError determines whether a test should continue or not in case the operation was not successful. Even if the test continues executing, it will still be reported as failed.

Apply represents resources that should be applied for this test step. This can include things like configuration settings or any other resources that need to be available during the test.

Assert represents an assertion to be made. It checks whether the conditions specified in the assertion hold true.

Command defines a command to run.

Create represents a creation operation.

Delete represents a creation operation.

Error represents the expected errors for this test step. If any of these errors occur, the test will consider them as expected; otherwise, they will be treated as test failures.

Script defines a script to run.

Sleep defines zzzz.

Timeout for the operation. Overrides the global timeout set in the Configuration.

Namespace of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/

Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

Selector defines labels selector.

Container in pod to get logs from else --all-containers is used.

Tail is the number of last lines to collect from pods. If omitted or zero, then the default is 10 if you use a selector, or -1 (all) if you use a pod name. This matches default behavior of kubectl logs.

Timeout for the operation. Overrides the global timeout set in the Configuration.

Content defines a shell script (run with "sh -c ...").

SkipLogOutput removes the output from the command. Useful for sensitive logs or to reduce noise.

Check is an assertion tree to validate the operation outcome.

Duration is the delay used for sleeping.

Description contains a description of the test.

Timeouts for the test. Overrides the global timeouts set in the Configuration on a per operation basis.

Skip determines whether the test should skipped.

Concurrent determines whether the test should run concurrently with other tests.

SkipDelete determines whether the resources created by the test should be deleted after the test is executed.

Namespace determines whether the test should run in a random ephemeral namespace or not.

Steps defining the test.

ForceTerminationGracePeriod forces the termination grace period on pods, statefulsets, daemonsets and deployments.

DelayBeforeCleanup adds a delay between the time a test ends and the time cleanup starts.

Name of the step.

TestStepSpec of the step.

Description contains a description of the test step.

Timeouts for the test step. Overrides the global timeouts set in the Configuration and the timeouts eventually set in the Test.

SkipDelete determines whether the resources created by the step should be deleted after the test step is executed.

Try defines what the step will try to execute.

Catch defines what the step will execute when an error happens.

Finally defines what the step will execute after the step is terminated.

Apply defines the timeout for the apply operation

Assert defines the timeout for the assert operation

Cleanup defines the timeout for the cleanup operation

Delete defines the timeout for the delete operation

Error defines the timeout for the error operation

Exec defines the timeout for exec operations