Elasticache Datastore Bootstrap
One-shot bootstrap for @webframp/valkey-datastore targeting AWS ElastiCache Serverless (Valkey). Creates a serverless cache, a VPC security group for access, and a least-privilege IAM managed policy, then switches the current swamp repository to the Valkey datastore.
Prerequisites
- AWS credentials with permissions to create ElastiCache serverless caches, EC2 security groups, and IAM managed policies
- A VPC with at least one subnet (the cache is deployed into the default VPC unless overridden)
What it does
provisioncreates an ElastiCache Serverless cache (Valkey engine, TLS enabled), a security group allowing inbound on port 6379 from the caller's VPC CIDR, and a scoped IAM managed policy.- A final
command/shellstep runsswamp datastore setup extension @webframp/valkey-datastore --config ...to flip the repo's datastore to Valkey.
Running
swamp extension pull @webframp/elasticache-datastore-bootstrap
swamp model create @webframp/elasticache-datastore-bootstrap/provisioner \
swamp-valkey-provisioner
swamp model create command/shell swamp-valkey-setup
swamp workflow run @webframp/bootstrap-elasticache-datastore \
--input region=us-east-1
swamp datastore statusSee the bundled README for optional inputs (cache_name, vpc_id,
subnet_ids, policy_name) and the exact IAM policy produced.
2026.08.28.1
Changed: Normalized the extension license to Apache-2.0 and corrected the copyright holder to "Sean Escriva". Extensions that previously shipped an MIT LICENSE.md are now Apache-2.0, consistent with the repository root and every other extension. No code or behavioral changes.
Upgrade note: License text only. No API, schema, or runtime behavior changed.
2026.08.27.1
Changed: Test suite now builds its method context from the shared
createModelTestContext factory in @systeminit/swamp-testing instead of a
hand-rolled context, wrapping writeResource to preserve the existing assertion
API. No behavioral, schema, or method changes — the published provisioner is
unchanged. The deno.json gains a dev-only @systeminit/swamp-testing
import-map entry and its check task now type-checks the test file.
2026.08.26.3
Fixed: Restored inline npm:zod@4.4.3 import specifiers so the registry
quality scorer can resolve dependencies and score the extension. An earlier
release used a bare "zod" import-map specifier, which published but scored as
unscored.
Changed: Retained explicit compilerOptions.strict in deno.json. No
behavioral or schema changes.
Resources
Provision an ElastiCache Serverless (Valkey) cache, security group, and IAM managed policy for @webframp/valkey-datastore, then switch the current repo to use Valkey. After completion the repo is configured. Verify with `swamp datastore status`.
2026.08.27.1
Changed: Test suite now builds its method context from the shared
createModelTestContext factory in @systeminit/swamp-testing instead of a
hand-rolled context, wrapping writeResource to preserve the existing assertion
API. No behavioral, schema, or method changes — the published provisioner is
unchanged. The deno.json gains a dev-only @systeminit/swamp-testing
import-map entry and its check task now type-checks the test file.
2026.08.26.3
Fixed: Restored inline npm:zod@4.4.3 import specifiers so the registry
quality scorer can resolve dependencies and score the extension. An earlier
release used a bare "zod" import-map specifier, which published but scored as
unscored.
Changed: Retained explicit compilerOptions.strict in deno.json. No
behavioral or schema changes.
2026.08.26.3
Fixed: Restored inline npm:zod@4.4.3 import specifiers so the registry
quality scorer can resolve dependencies and score the extension. An earlier
release used a bare "zod" import-map specifier, which published but scored as
unscored.
Changed: Retained explicit compilerOptions.strict in deno.json. No
behavioral or schema changes.
2026.08.26.1
Changed: Normalized deno.json configuration for repo-wide consistency:
added explicit compilerOptions.strict and migrated zod dependency to the
import map (bare "zod" specifier instead of inline npm:zod@4.4.3). No
behavioral changes — runtime resolution is identical.
2026.08.24.1
Added: Output metadata attributes for observability.
durationMs: Method execution duration in milliseconds.collectedBy: Extension name that produced the data.fetchedAt: ISO 8601 timestamp when data was fetched (added to resources that previously lacked it).
2026.08.23.1
Fixed: README's Development section referenced a nonexistent
valkey-datastore-bootstrap directory; corrected to
elasticache-datastore-bootstrap.
Changed: Documentation only — no code changes otherwise. Added a
## Troubleshooting section covering the multiple-default-VPC error, the
create-failed/deleting/deleted terminal-state branches in
waitForCacheAvailable, the self-healing ingress-rule check in
ensureSecurityGroup that silently reopens port 6379 to the VPC CIDR on re-run,
and divergent securityGroupId reporting when reusing a cache created with a
different security group.
2026.08.02.1
Fixed: The configure job in @webframp/bootstrap-elasticache-datastore
failed with Invalid expression: No such key: attributes. The workflow queried
data.latest("swamp-valkey-provisioner", "state"), but the provisioner writes
its resource under the instance name "main" (via
writeResource("state", "main", ...)) — data.latest()'s second argument
matches the resource's instance name, not its spec name. The configure job now
queries data.latest("swamp-valkey-provisioner", "main"), which resolves
correctly.
Changed: The run-setup step now passes the provisioner's datastoreConfig
through a DATASTORE_CONFIG environment variable instead of interpolating it
directly into a single-quoted shell string. The prior pattern could allow a
config value containing a single quote to break out of shell quoting.
Upgrade note: No action needed beyond swamp extension pull — the workflow
file is re-pulled with the extension.
2026.07.27.1
Fixed: The fmt task ran deno fmt --check, so deno task fmt verified
formatting instead of applying it and there was no way to format the extension
through its own task. fmt now formats and a new fmt:check verifies, matching
every other extension in the repository.
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.
2026.07.23.1
Added: Initial release of @webframp/elasticache-datastore-bootstrap —
one-shot provisioner for AWS ElastiCache Serverless (Valkey engine) targeting
@webframp/valkey-datastore.
Creates an ElastiCache Serverless cache with TLS, a VPC security group (TCP/6379 from VPC CIDR), and a least-privilege IAM managed policy, then configures the swamp repo datastore via a two-job workflow.
Fixed:
- Subnet IDs from user input are validated per-element against
/^subnet-[a-f0-9]+$/after split, preventing CLI argument injection key_prefixconstrained to max 64 chars and safe characters only ([a-zA-Z0-9_\-:.]) — prevents shell injection via workflow template--policy-documentvalues are redacted from AWS CLI error messages to avoid leaking ARNs and account IDs in logswaitForCacheAvailablethrows immediately when cache returns null (deleted mid-wait) or entersdeleting/deletedterminal stategetDefaultVpcIdthrows if multiple default VPCs found, requiring explicitvpc_id- Idempotency path waits for cache availability when re-running against a cache
in
creatingstate, preventing broken endpoint URLs describeServerlessCacheonly swallowsServerlessCacheNotFoundFault— other errors propagate correctlyensureSecurityGroupverifies port 6379/tcp ingress on reused security groups and adds it if missinggetSubnetIdsvalidates filtered subnet IDs are non-emptysecurity_group_nameschema rejects commas to prevent tag argument injection- Empty cache ARN or endpoint address throws immediately instead of producing malformed output
- 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