KEkernel

Push an image to a remote registry

Changed on

Creates a push job that exports a hypeman image from the local OCI cache to a remote registry (e.g. AWS ECR, Docker Hub). Only images in the ready state can be pushed.

post/pushes

Request

  • Base URL
    http://localhost:4973
  • URL
    http://localhost:4973/pushes
  • Auth
    HTTP bearer

Request body

imagestring required

Hypeman image name to push (tag or digest form)

targetstring required

Full remote reference to push to

insecureboolean

Allow pushing to plain-HTTP registries

Example request

{
  "image": "docker.io/library/alpine:latest",
  "target": "123456789.dkr.ecr.us-east-1.amazonaws.com/myapp:v1"
}

Response

Push job created

idstring required

Push job identifier

imagestring required

Hypeman image name (normalized ref)

digeststring required

Cached manifest digest being pushed

targetstring required

Remote reference the image is pushed to

status'queued' | 'pushing' | 'pushed' | 'failed' required
queue_positioninteger nullable

Position in the push queue

errorstring nullable

Error message

layersinteger

Number of layers pushed

bytesinteger

Total compressed layer bytes pushed

created_atstring date-time required
completed_atstring date-time nullable

Changes