Enhancements from review by
@@ -9,11 +9,14 @@ This page discusses how to set up Skaffold to run container structure tests afte
Container structure tests are consistency checks for containers.
Skaffold relies on [container-structure-test](https://github.com/GoogleContainerTools/container-structure-test) to execute those tests, and requires its [binary](https://github.com/GoogleContainerTools/container-structure-test/releases) to be installed.
-When configured for a container image, the structure tests are run after every container build.
-If this is prohibitive, long-running tests should be moved to a different Skaffold profile.
+Container structure tests are defined per image in the Skaffold config.
+Every time an artifact is rebuilt, Skaffold runs the associated structure tests on that image.
+If the tests fail, Skaffold will not continue on to the deploy stage.
+If frequent tests are prohibitive, long-running tests should be moved to a dedicated Skaffold profile.
### Example
-The following `test` section, instructs Skaffold to run all container structure tests in the `structure-test` folder relative to the Skaffold root directory:
+This following example shows the `test` section from a `skaffold.yaml`.
+It instructs Skaffold to run all container structure tests in the `structure-test` folder relative to the Skaffold root directory:
{{% readfile file="samples/testers/test.yaml" %}}
@@ -27,4 +30,4 @@ In order to restrict the executed structure tests, a `profile` section can overr
{{% readfile file="samples/testers/testProfile.yaml" %}}
-To execute the tests once, run for example `skaffold build --profile quickcheck`.
+To execute the tests once, run `skaffold build --profile quickcheck`.
