Container registry CLI Command Reference

Every dcloud ecr command. The shape is dcloud <service> <resource> <verb>; every command also takes the global flags (--json, --profile, --dry-run, …).

dcloud ecr repositories

Container image repositories

  • listList repositories
  • createCreate a repository
  • getDescribe one repository
  • updateChange visibility, tag immutability or description
  • deleteDelete a repository

dcloud ecr lifecycle-policy

Rules that expire images automatically (AWS ECR lifecycle policy JSON)

  • getRead a repository's lifecycle policy
  • putSet the lifecycle policy
  • deleteRemove the lifecycle policy
  • previewWhich images a policy would expire now
  • set-modeInherit the organization default, or let nothing expire

dcloud ecr expired-images

Images a lifecycle rule expired, restorable until purged

  • listList expired images with why, when they are purged, and whether something pulled them since
  • restoreBring an expired image back, with the tags nothing has taken since

dcloud ecr lifecycle-defaults

The organization’s default lifecycle policy for every repository that inherits it

  • getRead the default that applies, and the platform default
  • putSet the default and whether it is active, preview-only or off
  • previewWhat the default would expire across every inheriting repository, as if active

dcloud ecr images

Image manifests and tags within a repository

dcloud ecr storage

What the registry stores, and the quotas that cap it

  • getShow storage used per repository against the quotas
  • put-quotaSet the organization's storage quota
  • delete-quotaRemove the organization's storage quota

dcloud ecr registry-aliases

Send image references a workflow writes for another registry (ghcr.io/acme) to this one when CI jobs run

  • getList the registry aliases
  • putSet the registry aliases (replaces the list)

dcloud ecr pull-through-cache

Mirror Docker Hub, GHCR and other public registries into this one

  • listList the pull-through cache rules
  • createMirror an upstream registry under a prefix
  • updateSet or clear a rule's upstream login
  • deleteDelete a rule (cached repositories stay, and stop refreshing)

dcloud ecr signing

Trusted signing keys and the "only signed images deploy" policy

  • get-policyShow the signing policy and the trusted keys
  • put-policyTurn "only signed images deploy" on or off
  • delete-policyTurn the signing policy off (trusted keys stay)
  • add-keyTrust a cosign public key or a notation certificate
  • delete-keyStop trusting a signing key
  • verifyVerify an image's signatures against the trusted keys

dcloud ecr scan-results

Findings from a completed scan

  • getFetch the findings of one scan

dcloud ecr auth

Registry credentials

Generated from the API description, the same one the API checks requests against and the CLI is built from.