Skip to main content

Managing Repositories

A repository is an abstract folder you create within CCR, often so you can organize your images per team, business function, or deployment environment.

Creating a Standard Repository​

crusoe registry repositories create \
  --name my-nginx-repo \
  --location us-east1-a \
  --mode standard

Creating a Pull-Through Cache​

A read-only cache for an upstream registry. When you pull an image, it is fetched from the upstream source, stored in your CCR repository, and then served.

crusoe registry repositories create \
  --name my-dockerhub-cache \
  --location us-east1-a \
  --mode pull-through-cache \
  --upstream-registry \
      url=registry-1.docker.io,provider=docker-registry,username=myuser,password=mypass

To see all supported upstream registry providers, use crusoe registry supported providers.

Listing and Getting Repository Details​

List repositories in your project:

crusoe registry repositories list

Get details, including URL, for a specific repository:

crusoe registry repositories get my-app-repo --location us-east1-a

Deleting a Repository​

crusoe registry repositories delete my-app-repo --location us-east1-a

Repository URL Structure​

CCR repository URLs follow a standard format of:

registry.<location>.ccr.crusoecloudcompute.com/<repository-name>.<first-8-digits-of-project-id>