Version v1.39 of the documentation is no longer actively maintained. The site that you are currently viewing is an archived snapshot. For up-to-date documentation, see the latest version.
Custom Test alpha
Custom Test allows developers to run custom commands as part of their development pipeline. The command executes in the testing phase of the Skaffold pipeline. It will run on the local machine where Skaffold is being executed and works with all supported Skaffold platforms. Users can opt out of running custom tests by using the
Some example use cases for Custom Test are below:
- Run unit tests
- Run validation and security scans on images before deploying the image to a cluster for example by running GCP Container Analysis or Anchore Grype
Custom tests are defined on a per image basis in the Skaffold config. Every time an artifact is rebuilt, Skaffold runs the associated custom tests as part of the Skaffold dev loop. Multiple testers can be defined per test. The Skaffold pipeline will be blocked on the custom test to complete or fail. Skaffold will block deployment when the first test fails. For ongoing test failures in the dev loop, Skaffold will stop the loop (not continue with the deploy) but will not exit the loop. Skaffold would surface the errors to the user and will keep the dev loop running. Skaffold will continue watching user specified test dependencies and re-trigger the loop whenever it detects another change.
CustomTester has a configurable timeout option to wait for the command to return. If no timeout is specified, Skaffold will wait indefinitely until the test command has completed execution.
Contract between Skaffold and Custom command
Skaffold will pass in the environment variable
$IMAGE to the custom command to access the image.
This variable can be set as a flag value input to the custom command
To use a custom command, add a custom field to the corresponding test in the test section of the skaffold.yaml. Supported schema for CustomTest includes:
||Required custom command to be executed. If the command exits with a non-zero return code, the test will be considered to have failed.|
||sets the wait time for skaffold for the command to complete. If unset or 0, Skaffold will wait until the command completes.|
||additional test-specific file dependencies; changes to these files will re-run this test.|
Dependencies for a Custom Test
Users can specify
dependencies for custom tests so that skaffold knows when to retest during a dev loop. Dependencies can be specified per command. Users could list out directories and/or files (for example test scripts) to watch per command. If no dependencies are specified, only the script file (if the command is a script file) will be watched as a dependency. Test dependencies cannot trigger rebuild of an image.
Supported schema for
||represents a command that skaffold executes to obtain dependencies. The output of this command must be a valid JSON array.|
||locates the file dependencies for the command relative to workspace. Paths should be set to the file dependencies for this command, so that the skaffold file watcher knows when to retest and perform file synchronization.||
||specifies the paths that should be ignored by skaffold’s file watcher. If a file exists in both
Paths and Ignore
Ignore are arrays used to list dependencies. This can be a glob. Any
Ignore will be ignored by the skaffold file watcher, even if they are also specified in
Ignore will only work in conjunction with
custom: - command: ./test.sh timeoutSeconds: 60 dependencies: paths: - "*_test.go" - "test.sh"
Command for dependencies
Sometimes users might have a command or a script that can provide the dependencies for a given test. Custom tester can ask Skaffold to execute a custom command, which Skaffold can use to get the dependencies for the test for file watching.
The command must return dependencies as a JSON array, otherwise skaffold will error out.
custom: - command: echo Hello world!! dependencies: command: echo [\"main_test.go\"]
Note: Adding a file pattern to a test dependency doesn’t automatically enable file sync on it. Refer to the
file syncdocumentation, on how to set that up separately.
STDERR from the custom command script will be redirected and displayed within skaffold logs.
Custom tests will be automatically invoked as part of the run and dev commands, but can also be run independently by using the test subcommand.
- To execute the custom command as an independent test command run:
- To execute custom command as part of the run command run:
- To execute custom command as part of the dev loop run:
This following example shows the
customTest section from a
It instructs Skaffold to run unit tests (main_test.go) located in the local folder when the main application changes:
test: - image: custom-test-example custom: - command: ./test.sh timeoutSeconds: 60 dependencies: paths: - "*_test.go" - "test.sh" - command: echo Hello world!! dependencies: command: echo [\"main_test.go\"]
test.sh file, which runs unit tests when the test changes.
#!/bin/bash set -e echo "go custom test $@" go test .