feat(templates): ministack AWS-emulation engine (provides: aws) - #92
Merged
Conversation
Add the ministack (LocalStack-compatible AWS emulator) shared engine template, mirroring the localstack template shape. provides: aws, exports host/port/endpoint/region, defaultPort 4566. Uses the ministack readiness probe (/_ministack/ready) and PERSIST_STATE/STATE_DIR persistence into a named volume. Wired into the go:embed set with a rendered golden.yaml and resolver/lint tests. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Adds a new built-in shared-service template for ministack (https://ministack.org), a LocalStack-compatible AWS emulator, mirroring the
localstacktemplate shape exactly.schemaVersion: 1,provides: aws,exports: [host, port, endpoint, region],defaultPort: 4566.image(defaultministackorg/ministack:latest),services(defaults3,sqs,snsfor light startup →SERVICES),region(defaultus-east-1).restart: unless-stopped; envSERVICES/AWS_DEFAULT_REGION/PERSIST_STATE=1/STATE_DIR=/var/lib/ministack; a named volume mounted at/var/lib/ministack; healthcheckcurl -sf http://localhost:4566/_ministack/ready(the ministack readiness endpoint: 200 ready / 503 starting) with interval 10s / timeout 5s / retries 8 / start_period 20s.templates/embed.gogo:embedset.templates/ministack/golden.yamlsotemplate testpasses.Why
Second AWS-emulation engine option alongside localstack under spec 28. Resolves through the already-generic
endpoint/regionsharedAttr cases ininternal/generate/resolver.go— no resolver code changes needed.Image-tag caveat
The default
ministackorg/ministack:latestfloats across majors. Because shared instances are keyed by(engine, major)in the ledger, users should pin a tag (e.g.ministackorg/ministack:1) via theimageparam for stable ledger keying; this is noted in the param description.How tested
template lint templates/ministack+template test templates/ministackboth pass (golden byte-matches).ministackcase toTestCloudEngineTemplatesLint(asserts provides=aws, port=4566,_ministack/readysurvives into compose) and extendedTestSharedAttr_EndpointAndRegionto cover ministack's endpoint/region export.CGO_ENABLED=0 go build ./...,CGO_ENABLED=1 go test ./internal/...,gofmt -l(clean),go vet ./..., andmake determinismall green (existing built-ins untouched).🤖 Generated with Claude Code