Introducing InterSystems Container Registry
I am pleased to announce the availability of InterSystems Container Registry. This provides a new distribution channel for customers to access container-based releases and previews. All Community Edition images are available in a public repository with no login required. All full released images (IRIS, IRIS for Health, Health Connect, System Alerting and Monitoring, InterSystems Cloud Manager) and utility images (such as arbiter, Web Gateway, and PasswordHash) require a login token, generated from your WRC account credentials.
The WRC Distributions site will continue to provide released images as tarballs for the time being. However, you can now configure your CI/CD pipelines to ‘docker pull’ images directly from InterSystems Container Registry.
The registry can be accessed at https://containers.intersystems.com. Please refer below or to the documentation (Using the InterSystems Container Registry) for full usage instructions. If you run into any issue or have any feedback to share please let us know in the comments below, or contact firstname.lastname@example.org.
Using the InterSystems Container Registry
This document provides instructions for using InterSystems Container Registry (ICR), located at containers.intersystems.com.
Images in the ICR can be downloaded with the docker pull command, for example:
For a full listing of all available images, please refer to Container Images Available from InterSystems
This document contains the following sections:
- Authenticating to the ICR
- Listing the ICR Inventory
To log into the ICR, take the following steps:
- Load https://containers.intersystems.com/ in your browser and log in with your InterSystems/WRC credentials.
- Retrieve your Docker login token, or the full login command.
- In your Docker interface (for example, your PowerShell window or Linux command line), authenticate to the ICR using the provided credentials. You can do this by copying and pasting the full docker login command displayed, for example:
For security reasons, however, you may want to instead enter the command docker login containers.intersystems.com, then enter your username at the Username prompt and paste your password into the Password: prompt.
Note: If you are logged into another Docker registry, the docker login command may result in an error; log out of the other registry before logging into containers.intersystems.com.
- You can now pull images from the ICR, for example:
APIs are available to list images and tags in a Docker registry. An example of an open source third-party utility that can be used to list a registry’s inventory is docker-ls, available at https://github.com/mayflower/docker-ls.
There are several ways to obtain this utility. You can:
- Download precompiled docker-ls binaries for a variety of platforms.
- Install the utility directly on some platforms, for example on Linux systems with the command
- Pull and run the image carinadigital/docker-ls:latest on Linux platforms to install the utility, for example:
Once docker-ls is installed, you can use the following command to list the repositories in the ICR:
Note: Use the --interactive-password option to be prompted for the password rather than including it on the command line.
To list only the publicly available images, provide empty strings ("") as arguments to the --user and --password options, for example, the following lists only the tags of public InterSystems IRIS for Health images:
If you wish to see the full list of non-public images, you will need to provide your username and password to this utility regardless of whether you are logged into containers.intersystems.com.
Further examples are available at https://github.com/mayflower/docker-ls