Skip to content

Document pushing images to remote registries - #354

Draft
chruffins wants to merge 1 commit into
hypeship/registry-push-apifrom
hypeship/registry-push-docs
Draft

Document pushing images to remote registries#354
chruffins wants to merge 1 commit into
hypeship/registry-push-apifrom
hypeship/registry-push-docs

Conversation

@chruffins

@chruffins chruffins commented Aug 5, 2026

Copy link
Copy Markdown
Contributor

Layer 4 of remote registry push support (top of the stack: #348#350#353).

Adds user-facing docs for the outbound push feature:

  • Features bullet: remote registry push with docker-style borrowed credentials
  • Usage section with the docker-aligned credential model spelled out (credentials stay on the client, borrowed per push, never stored on the server; server's own logins as fallback)
  • curl examples: creating a push with lent ECR credentials (the aws ecr get-login-password flow) and polling the job
  • digest-preservation and ready-state notes

Docs-only; no code changes.


Note

Low Risk
Documentation-only change with no runtime or security behavior changes.

Overview
Documents remote registry push for cached OCI images: a new Features bullet and a Pushing Images to Remote Registries usage section.

The new section explains docker-style borrowed credentials (client-supplied per push, not stored server-side; fallback to ~/.docker/config.json), curl examples for POST /pushes (including ECR get-login-password) and polling push job status, plus notes that only ready images can be pushed and that manifest digests are preserved.

Reviewed by Cursor Bugbot for commit e3ebc56. Bugbot is set up for automated code reviews on this repo. Configure here.

@chruffins
chruffins force-pushed the hypeship/registry-push-docs branch 2 times, most recently from 25be7fd to fdb7cd3 Compare August 5, 2026 19:18
@chruffins
chruffins force-pushed the hypeship/registry-push-docs branch from fdb7cd3 to 3821bf1 Compare August 5, 2026 19:43
@chruffins
chruffins force-pushed the hypeship/registry-push-docs branch from 3821bf1 to 72a31c9 Compare August 5, 2026 19:43
@chruffins
chruffins force-pushed the hypeship/registry-push-docs branch from 72a31c9 to a85bd7e Compare August 5, 2026 19:56
@chruffins
chruffins force-pushed the hypeship/registry-push-docs branch from a85bd7e to fd050e7 Compare August 5, 2026 20:03
@chruffins
chruffins force-pushed the hypeship/registry-push-docs branch from 8824006 to c411bbd Compare August 6, 2026 14:17
@chruffins

chruffins commented Aug 6, 2026

Copy link
Copy Markdown
Contributor Author

reviewed — accurate docs; all findings from the review are addressed in c411bbdd and 43740067 ($HYPEMAN_API_KEY in the curl examples, insecure and error-on-failure documented, ECR token hoisted, examples anchored to the real api.hostname/TLS-443 surface, and the api: config block documented).

status: all review findings addressed

@chruffins
chruffins force-pushed the hypeship/registry-push-docs branch from c411bbd to 4374006 Compare August 6, 2026 15:20
@chruffins
chruffins force-pushed the hypeship/registry-push-docs branch from 4374006 to 2a08542 Compare August 6, 2026 16:13
@chruffins
chruffins force-pushed the hypeship/registry-push-docs branch 2 times, most recently from 79b24ff to 0846452 Compare August 6, 2026 21:07
@chruffins
chruffins force-pushed the hypeship/registry-push-docs branch from 0846452 to 19d5bbe Compare August 6, 2026 21:10
@chruffins
chruffins force-pushed the hypeship/registry-push-docs branch from 19d5bbe to eae4d30 Compare August 7, 2026 13:52
@chruffins
chruffins force-pushed the hypeship/registry-push-docs branch from eae4d30 to 1e40195 Compare August 7, 2026 14:25
@chruffins
chruffins force-pushed the hypeship/registry-push-docs branch from 1e40195 to e897851 Compare August 7, 2026 14:29
@chruffins
chruffins force-pushed the hypeship/registry-push-docs branch from e897851 to 52d6fc9 Compare August 7, 2026 14:34
@chruffins
chruffins force-pushed the hypeship/registry-push-docs branch 2 times, most recently from f50b94b to 6f3864f Compare August 10, 2026 15:36
@chruffins
chruffins force-pushed the hypeship/registry-push-docs branch from 6f3864f to 1a74c0d Compare August 10, 2026 16:14
@chruffins
chruffins force-pushed the hypeship/registry-push-docs branch from 1a74c0d to e3ebc56 Compare August 10, 2026 16:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant