36 lines
1.7 KiB
Markdown
36 lines
1.7 KiB
Markdown
|
# VENDORED — `@olsitec/pulumi-docker`
|
||
|
|
|
||
|
|
**Source (absolute path):** `/Users/andiolsi/work/olsicloud4/pulumi/modules/docker/`
|
||
|
|
**Copy date:** 2026-06-30
|
||
|
|
**Stage:** Stage-1 vendoring per [`documentation/000_TOPOLOGY.md` §5](../../documentation/000_TOPOLOGY.md).
|
||
|
|
|
||
|
|
## What this is
|
||
|
|
|
||
|
|
A verbatim copy of the olsicloud4 `modules/docker` Pulumi module (the
|
||
|
|
`DockerDeployments` `@pulumi/docker`-over-SSH wrapper, CONTRACT_003). At day-zero the
|
||
|
|
foundation registry does not yet exist, so `bootstrap/` consumes this module locally
|
||
|
|
through the Bun workspace (`packages/*`) instead of from a registry — this resolves the
|
||
|
|
"registry hosts the modules that build the registry" paradox (000_TOPOLOGY.md §3, ADR-005).
|
||
|
|
|
||
|
|
## What was copied
|
||
|
|
|
||
|
|
`index.ts`, `package.json`, `tsconfig.json`, `.editorconfig`, `.gitignore`.
|
||
|
|
|
||
|
|
**Not copied:** `node_modules/`, `package-lock.json` (lockfiles), `.git/`.
|
||
|
|
|
||
|
|
## Changes made vs. the source
|
||
|
|
|
||
|
|
- `package.json` `name`: `docker` → `@olsitec/pulumi-docker`; added `version` (`0.0.0`,
|
||
|
|
pre-publish placeholder) and `main`/`types` (`index.ts`) so the Bun workspace resolves it.
|
||
|
|
- **No behavioural change.** `index.ts` logic is byte-for-byte the upstream source.
|
||
|
|
|
||
|
|
## Lifecycle (000_TOPOLOGY.md §5)
|
||
|
|
|
||
|
|
- **Stage 1 — VENDOR (this commit):** copied here; consumed locally via Bun workspace.
|
||
|
|
- **Stage 2 — PUBLISH (later task):** once the foundation Forgejo npm registry is live, CI
|
||
|
|
publishes `@olsitec/pulumi-docker@<semver>` (semantic-release-monorepo, Conventional Commits).
|
||
|
|
- **Stage 3 — CONSUME (steady state):** downstream projects switch imports from
|
||
|
|
`olsicloud4/pulumi/modules/docker` to the published package; the old module is frozen then removed.
|
||
|
|
|
||
|
|
Do not refactor the vendored logic here. Behavioural changes belong upstream or in Stage-2+ work.
|