Skip to main content
← back to extensions

Container Image

@webframp/container-imagev2026.08.01.1· 4d agoMODELS
01README

Build, push, and inspect OCI container images. Registry-agnostic — works with ECR, GHCR, DockerHub, or any OCI-compliant registry. Supports docker, podman, nerdctl, and buildah. Produces typed, versioned build metadata.

02Release Notes

2026.08.01.1

Fixed: Broken model-upgrade chain. The prior version bump (to 2026.07.27.1) updated version but left the upgrades array terminating one step short, which blocks swamp extension push ("model upgrade chain errors"). That version never actually published — the registry was still serving 2026.07.18.1. This release closes the chain with a no-op upgrade entry and republishes everything that had accumulated since 2026.07.18.1.

2026.07.27.1

Fixed: deno fmt no longer inspects CLAUDE.md / AGENTS.md. Those files are gitignored and never present in CI, but deno fmt does not read .gitignore, so deno task fmt:check could fail locally on a file CI does not have.

Upgrade note: Tooling and formatting only. No model, method, schema, or behavior change — nothing to do on upgrade.

03Models1
@webframp/container-imagev2026.08.01.1container_image.ts
fn login(registry: string, username: string, password: string)
Authenticate to a container registry. Run before push for private registries.
ArgumentTypeDescription
registrystringRegistry URL (e.g. 123456789012.dkr.ecr.us-east-1.amazonaws.com)
usernamestringRegistry username
passwordstringRegistry password or token
fn build(contextPath: string, tag: string)
Build a container image from a Dockerfile. Supports multi-platform builds via buildx.
ArgumentTypeDescription
contextPathstringPath to the build context directory
tagstringImage tag (e.g. 123456789012.dkr.ecr.us-east-1.amazonaws.com/my-repo:latest)
fn push(tag: string)
Push a built image to its registry. Run login first for private registries.
ArgumentTypeDescription
tagstringImage tag to push
fn inspect(tag: string)
Inspect a local image and return its metadata.
ArgumentTypeDescription
tagstringImage tag to inspect

Resources

build(30d)— Container image build result
push(30d)— Container image push result with digest
inspect(7d)— Container image inspection metadata
04Previous Versions5
2026.07.18.1

2026.07.18.1

Added: An upgrades array entry (no-op) to container_image.ts for proper typeVersion tracking on existing instances. No schema or behavior changes.

2026.07.13.1

Changed: Upgraded the test-only dev dependency @systeminit/swamp-testing to 0.20260504.10, matching the rest of the repo. This is a test-harness change only — the published extension bundle is unchanged and no runtime behavior is affected.

2026.07.13.1

2026.07.13.1

Changed: Upgraded the test-only dev dependency @systeminit/swamp-testing to 0.20260504.10, matching the rest of the repo. This is a test-harness change only — the published extension bundle is unchanged and no runtime behavior is affected.

2026.06.23.1
2026.06.15.1
2026.06.12.1
05Stats
A
100 / 100
Downloads
4
Archive size
6.6 KB
  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types (deprecated)1/1earned
  • Dependencies pass trust audit2/2earned
  • Has description1/1earned
  • Platform support declared (or universal)2/2earned
  • License declared1/1earned
  • Verified public repository2/2earned
Repository
https://github.com/webframp/swamp-extensions
06Platforms
07Labels
#container#docker#buildah#podman#oci#build#registry