Harmony Container Registry
Early Access: The Harmony Container Registry is currently an early-access service. Features, quotas, and procedures may change as the service is developed.
The Harmony Container Registry is available at https://registry.harmonyhpc.io.
What Is Harbor?
The Harmony Container Registry uses Harbor, an open-source registry for storing, managing, and sharing container images and other OCI-compatible artifacts.
Harbor organizes content into projects and repositories and provides features such as:
- Public and private projects
- Role-based access control
- Storage quotas
- Vulnerability scanning
- Support for Docker and OCI-compatible artifacts
- A web interface for viewing repositories, tags, artifacts, and scan results
Harmony’s Harbor service automatically scans supported container images for known vulnerabilities. Scan results and severity information are available through the web interface.
Vulnerability-scanning support depends on the artifact type. Docker and OCI container images can be scanned, but an Apptainer SIF file stored through ORAS may not support the same vulnerability-scanning capabilities.
Use Cases
You can use the Harmony Container Registry to:
- Store Docker and OCI container images.
- Store Apptainer SIF containers using ORAS.
- Share containers with collaborators.
- Publish containers that should be broadly accessible.
- Store private containers for individual or research-group use.
- Pull containers for use on the Unity HPC cluster.
- Maintain tagged versions of applications and research environments.
- Review vulnerability reports for supported container images.
Register for the Service
To register:
- Navigate to
https://registry.harmonyhpc.io. - Select Log in with Harmony then Log in with Unity.
- Use institutional single sign-on to log in with your institution’s credentials.
This completes the registration process. You will be logged in immediately, and your projects will normally be created within 10 minutes.
Automatically Created Projects
After registration, two projects will be created for you:
| Project | Visibility | Quota | Intended use |
|---|---|---|---|
<username>-pub | Public | 100 GB | Containers that you want to share |
<username>-priv | Private | 100 GB | Containers with restricted access |
The quotas are separate, providing up to 100 GB in each project.
Artifacts in the public project can be pulled by other users. Artifacts in the private project can be pulled only by authorized project members.
Replace <username> in the examples below with your Unity username.
Obtain Your CLI Secret
Your institutional credentials are used to log in through the web interface. However, Docker and Apptainer use your Harbor CLI secret.
To obtain the secret:
- Log in to
https://registry.harmonyhpc.io. - Select your username in the upper-right corner.
- Select Preferences.
- Copy the value labeled CLI secret.
Use the CLI secret as <password> in the commands below.
Treat the CLI secret like a password. Do not include it in scripts, source-code repositories, support requests, or other shared files.
Log In with Docker
Use the following command:
docker login -u <username> registry.harmonyhpc.io
When prompted for the password, paste your CLI secret.
Push a Docker Image
Docker image names stored in Harbor follow this pattern:
registry.harmonyhpc.io/<project>/<repository>:<tag>
For example, tag a local image for your private project:
docker tag my-image:latest \
registry.harmonyhpc.io/<username>-priv/my-image:latest
Push the tagged image:
docker push \
registry.harmonyhpc.io/<username>-priv/my-image:latest
To publish the image in your public project instead:
docker tag my-image:latest \
registry.harmonyhpc.io/<username>-pub/my-image:latest
docker push \
registry.harmonyhpc.io/<username>-pub/my-image:latest
Pull a Docker Image
Pull an image from your private project:
docker pull \
registry.harmonyhpc.io/<username>-priv/my-image:latest
Pull an image from a public project:
docker pull \
registry.harmonyhpc.io/<username>-pub/my-image:latest
Authentication is required for private projects.
Log In with Apptainer
Apptainer uses the ORAS protocol to store and retrieve SIF files from Harbor.
Log in with:
apptainer registry login \
-u <username> \
oras://registry.harmonyhpc.io
Push an Apptainer SIF Container
Push a SIF container to your private project:
apptainer push my-container.sif \
oras://registry.harmonyhpc.io/<username>-priv/my-container:latest
Push a SIF container to your public project:
apptainer push my-container.sif \
oras://registry.harmonyhpc.io/<username>-pub/my-container:latest
The portion after the project name is the repository name. The final portion after the colon is the tag.
For example:
oras://registry.harmonyhpc.io/jdoe_school_edu-priv/analysis-environment:1.0
In this example:
jdoe_school_eduis the Unity usernamejdoe_school_edu-privis the Harbor project.analysis-environmentis the repository.1.0is the tag.
Pull an Apptainer SIF Container
Pull a SIF container from your private project:
apptainer pull my-container.sif \
oras://registry.harmonyhpc.io/<username>-priv/my-container:latest
Pull a SIF container from a public project:
apptainer pull my-container.sif \
oras://registry.harmonyhpc.io/<username>-pub/my-container:latest
The first argument specifies the name of the local SIF file that Apptainer will create.
View Repositories and Vulnerability Results
To inspect an uploaded container:
- Log in to
https://registry.harmonyhpc.io. - Open the appropriate public or private project.
- Select Repositories.
- Select the repository and artifact tag.
For supported container images, the artifact page displays the vulnerability-scan status and detected vulnerabilities. Scan results may include severity levels such as low, medium, high, and critical.
A vulnerability report indicates that known vulnerabilities were detected in the software contained in an image. It does not necessarily mean that a vulnerability is exploitable in your specific application. Users remain responsible for evaluating results, updating dependencies, and rebuilding images when appropriate.
Log Out
Log out with Docker:
docker logout registry.harmonyhpc.io
Log out with Apptainer:
apptainer registry logout oras://registry.harmonyhpc.io