registrystack / registrystack/registry-stack

Deliver a verifiable disconnected installation and upgrade workflow

Aperta
#503 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub
area:docs area:platform area:registryctl enhancement post-1.0 triage:roadmap
Lingua principale
Rust
Stelle
2
Fork
0
Merge medio
2h 55m
PR unite (30g)
130

Descrizione

## Outcome

Registry Stack can be installed, verified, upgraded, rolled back, and recovered in an environment with no network access to public source, release, transparency-log, package, or container-registry services.

Roadmap default: 1.2. Reprioritize only when a release-scoped deployment requirement mandates disconnected operation.

## Required distribution unit

Produce a versioned disconnected release set containing or closing over:

- Registryctl and required platform binaries for supported host architectures;
- exact Relay and Notary OCI images for supported runtime architectures;
- release lock, checksums, signatures, certificates or trust material, SBOMs, provenance, vulnerability evidence, schemas, and notices;
- the supported Compose deployment inputs and any required migration tooling;
- an authenticated manifest that inventories every file, image, digest, size, sensitivity, and intended consumer; and
- an explicit statement of what is not included, such as external databases, identity providers, secret stores, HSM modules, ingress, monitoring, or country integration data.

## Workflow

Document and automate:

1. Assemble and verify the release set in a connected preparation environment.
2. Transfer it through an institution-approved medium.
3. Verify trust and complete closure without network access.
4. Import images into an institution-owned registry or local OCI runtime.
5. Apply an explicit digest-preserving repository mapping.
6. Install and run the supported topology.
7. Perform a disconnected upgrade, rollback decision, and recovery exercise.
8. Export bounded verification evidence without private values.

## Security requirements

- Offline verification must not silently skip a transparency, certificate, provenance, or signature check that was required online.
- Trust bootstrap and trust rotation must be explicit and independently reviewable.
- Repository remapping must preserve exact image identity.
- The release set must contain no credentials, private keys, project secrets, source data, or environment-specific endpoints.
- Missing, extra, replaced, downgraded, expired, or wrong-architecture artifacts fail closed before activation.

## Definition of Done

- [ ] CI builds the complete release set from one immutable candidate and validates its authenticated closure.
- [ ] An isolated no-network test machine verifies, imports, installs, starts, exercises, stops, upgrades, and recovers the supported topology without undeclared downloads.
- [ ] Negative tests cover omission, substitution, downgrade, stale trust, wrong architecture, altered image mapping, and partial transfer.
- [ ] The procedure supports at least one authenticated private registry and a registry-free local import path where the supported deployment permits it.
- [ ] Documentation distinguishes disconnected installation from offline fixture validation and from runtime source connectivity.
- [ ] Release evidence records exact inputs, outputs, digests, verification steps, and limitations.
- [ ] The support matrix states which disconnected topology, transfer model, trust model, and upgrade hops are supported.

## Non-goals

- Operating an institutional artifact repository or transfer process.
- Bundling external infrastructure products.
- Automatic access to a deployment environment.
- Treating a local registry alone as complete disconnected-install support.

## Related work

- #122
- #484
- #499

Guida per i contributori

Apri la guida per i contributori

Direzione di ricerca

Inizia esaminando le issue correlate #122, #484 e #499, quindi individua la CI esistente, gli input di deployment di Compose supportati, gli strumenti di release e la matrice di supporto. Esegui il workflow isolato senza rete su un candidato immutabile e sul relativo set di release. Il lavoro è completo quando installazione, verifica, upgrade, rollback, recovery e i test negativi elencati vengono completati senza download non dichiarati, con evidenze circoscritte registrate.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Valutazione

Stack tecnologico
docker, docker-compose, rust
Ambito
devops, infrastructure, release, security, testing
Tipo di issue
Funzionalità
Difficoltà
5/5
Tempo stimato
Più di una settimana
Stato di attività
Tranquilla
Chiarezza
Abbastanza chiara
Idoneità per principianti
25/100

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.