Container Registry

Emulates a managed container registry — the ECR, ACR, or Artifact Registry you push images to before a deploy. You create named repositories, put image manifests into them under tags or digests, and manage their lifecycle; each repository tracks its images the way the real registries do, down to tag mutability and scan-on-push settings.

Reach for it in tests when your code creates repositories, pushes or lists images, or depends on lifecycle cleanup or scan results — so you can exercise those paths without a real registry or real image layers. You store a manifest (digest, tags, size), not actual bytes, which is all a test double needs.

Create repositories#

A repository is the container your images live in — the equivalent of an ECR repository or an Artifact Registry repo. ImageScanOnPush and ImageTagMutability mirror the real create-time knobs, so a test can assert your provisioning sets them:

import crdriver "github.com/stackshy/cloudemu/v2/services/containerregistry/driver"

aws.ECR.CreateRepository(ctx, crdriver.RepositoryConfig{
    Name:            "my-app",
    ImageScanOnPush: true,
    Tags:            map[string]string{"team": "platform"},
})

repos, _ := aws.ECR.ListRepositories(ctx)

Push and list images#

PutImage records a manifest — digest, tag, size, and layers — against a repository, the way docker push registers an image without you shipping real bytes. ListImages returns everything in the repo so a test can assert what landed:

aws.ECR.PutImage(ctx, &crdriver.ImageManifest{
    Repository: "my-app",
    Tag:        "v1.0.0",
    Digest:     "sha256:abc123...",
    SizeBytes:  10 << 20,
})

images, _ := aws.ECR.ListImages(ctx, "my-app")

Configure lifecycle policies#

Lifecycle policies model the automatic cleanup real registries run — expiring untagged or over-quota images. PutLifecyclePolicy stores the rules, and EvaluateLifecyclePolicy returns the image references that would be expired, so a test can assert the policy prunes what you expect without waiting on a background sweep:

aws.ECR.PutLifecyclePolicy(ctx, "my-app", crdriver.LifecyclePolicy{
    Rules: []crdriver.LifecycleRule{{
        Priority:   1,
        TagStatus:  "untagged",
        CountType:  "imageCountMoreThan",
        CountValue: 10,
        Action:     "expire",
    }},
})

expired, _ := aws.ECR.EvaluateLifecyclePolicy(ctx, "my-app")

Scan images#

StartImageScan kicks off a vulnerability scan and GetImageScanResults reads it back — the same scan-on-push / scan-on-demand flow ECR exposes. The result carries a status and per-severity finding counts, so your code can gate a deploy on scan output:

aws.ECR.StartImageScan(ctx, "my-app", "v1.0.0")

result, _ := aws.ECR.GetImageScanResults(ctx, "my-app", "v1.0.0")
fmt.Println(result.Status, result.FindingCounts["CRITICAL"])

Behavior & fidelity#

SDK-compat — Live#

Real aws-sdk-go-v2/service/ecr, armcontainerregistry, and Artifact Registry clients drive the repository, image, and tag operations end-to-end. See SDK-Compat for the full operation list.