# GoogleContainerTools/container-structure-test

validate the structure of your container images

Repository: https://github.com/GoogleContainerTools/container-structure-test
Canonical: https://ross.abutalabs.com/products/container-structure-test
Language: Go
License: Apache-2.0
License Family: permissive
Last push: 2026-07-20T05:52:43+00:00

## Health v2 (maintenance only)
Score: 83/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 93, release rhythm 61, longevity 100
- inputs: {"age_days": 3236, "days_push": 44, "days_rel": 260, "gap_med": 21.0, "n_releases_24m": 7}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2495, forks 211 (observed 2026-08-28T04:06:56.668491+00:00)

## What it is
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
- artifact type: cli-tool
- maturity: maintenance
- function: testing, cli, developer-tools
- domain: developer-tools, testing
- platform: windows, cli, go
- tags: container-images, docker, yaml-config, ci-cd, image-validation, containers, devops, linux, macos

## Member repositories
- GoogleContainerTools/container-structure-test (main) score 83

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:56.668491+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:27:12.821450+00:00, confidence not recorded.
  - readme: https://github.com/GoogleContainerTools/container-structure-test (fetched 2026-08-28T04:06:56.668491+00:00, sha a4deee051f16)
- Data as of 2026-08-30T08:39:29.467469+00:00.