Skip to content

Using with Docker✯

This page describes how to push (push) and pull (pull) images using the docker command. The examples can also be applied to podman.

Prerequisites

Naming Convention✯

Any image hosted on the registry follows this naming format:

registry.isima.fr/<project>/<repository>:<tag>
  • <project>: the name of your project
  • <repository>: the name of your image (e.g., my-app)
  • <tag>: the version (e.g., latest, 1.0.0, dev…)

Authentication✯

Authentication is only required to push images or to pull from a private project.

docker login registry.isima.fr -u <your_login>
# Password: your CLI secret

Pushing an Image✯

1. Build or Tag the Image✯

From a Dockerfile:

docker build -t registry.isima.fr/my-project/my-app:1.0.0 .

Or re-tag an existing image for the registry:

docker tag my-app:latest registry.isima.fr/my-project/my-app:1.0.0

2. Push the Image✯

docker push registry.isima.fr/my-project/my-app:1.0.0

The image then appears in your project on the web interface, where it is automatically scanned if the option is enabled.

Image repository in a project

Pushing Multiple Tags✯

It is common to tag the same image with an explicit version and the latest tag:

docker tag registry.isima.fr/my-project/my-app:1.0.0 registry.isima.fr/my-project/my-app:latest
docker push registry.isima.fr/my-project/my-app:latest

Tagging with Git Commit Hash

To precisely track which version of the code produced an image:

docker tag registry.isima.fr/my-project/my-app:latest \
           registry.isima.fr/my-project/my-app:$(git rev-parse --short HEAD)
docker push registry.isima.fr/my-project/my-app:$(git rev-parse --short HEAD)

Pulling an Image✯

From a public project, no authentication is required:

docker pull registry.isima.fr/my-project/my-app:1.0.0

From a private project, authenticate first with docker login (see above).

Using with Docker Compose✯

The registry is used transparently in a compose.yaml. Example combining building an image and publishing it to the registry:

services:
  my-app:
    image: registry.isima.fr/my-project/my-app:latest
    build:
      context: .
      dockerfile: Dockerfile
  • Build the image: docker compose build
  • Push it to the registry: docker compose push
  • On the user side, the image is downloaded automatically: docker compose up

Deleting an Image✯

Deletion is done from the web interface (repository tab, select the tag, then DELETE), provided you have at least the Maintainer role on the project.

Checks Before Pushing