GoogleContainerTools/container-structure-test

Health v2 · maintenance only

Adoption not part of the score

2495 stars · 211 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

A CLI framework by Google for validating the structure of container images via YAML or JSON test configs. It supports command tests, file existence/content tests, and metadata checks, run through a standalone binary or Docker image.

Use cases

• validate container image structure in CI
• check that files exist inside a docker image
• test command output in a container image
• verify image metadata and filesystem contents
• assert container image contents before publishing

When to choose

• you want declarative YAML/JSON tests for image contents and command output
• you need to gate container image releases in a CI pipeline
• you prefer a standalone binary over writing custom test scripts

When to avoid

• you need actively developed features - the project is in maintenance mode
• you want full integration testing of running containers rather than image structure
• container-based builds are needed, since container builds are not updated with new releases

Facets

cli-tool · maturity maintenance

testing cli developer-tools developer-tools testing windows cli go container-images docker yaml-config ci-cd image-validation containers devops linux macos

Member repositories

For agents

markdown · JSON · MCP: product_card(name="GoogleContainerTools/container-structure-test")