Using the InterSystems Container Registry

Copy link to this sectionContainer Images Available from InterSystems

The following sections list the public and limited access images available from the ICR, which is located at https://containers.intersystems.com/. The full identifier, including registry, repository, name, and tag is provided for each image so you can copy it and paste it into your command or file.

Copy link to this sectionAuthenticating to the ICR

To log into the ICR, take the following steps:

1. Load https://containers.intersystems.com/ in your browser and log in with your InterSystems/WRC credentials. The Credentials for [User] page displays with your Docker login credentials for the ICR.

2. 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 on the Credentials page, for example:

   docker login -u="<username>" -p="<provided-password>" containers.intersystems.com

   Copy code to clipboard

   To avoid exposing your password on the command line, 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.

3. You can now pull images from the ICR, for example:

   docker pull containers.intersystems.com/intersystems/iris:2020.3.0.221.0

   Copy code to clipboard

Copy link to this sectionListing the ICR Inventory

Various 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

  sudo snap install docker-ls

  Copy code to clipboard

• Pull and run the image carinadigital/docker-ls:latest on Linux platforms to install the utility, for example:

  docker run --rm carinadigital/docker-ls:latest

  Copy code to clipboard

Once docker-ls is installed, you can use the following command to list the repositories in the ICR:

docker-ls repositories --registry https://containers.intersystems.com 
  --user <username> --password <password>

Copy code to clipboard

If you want to list limited access images, you must include your credentials in the docker-ls repositories command regardless of whether you are logged into containers.intersystems.com, for example

$ docker-ls repositories --registry https://containers.intersystems.com 
    -u "<username>" --interactive-password
Password:
requesting list . done
repositories:
- intersystems/arbiter
- intersystems/arbiter-arm64
- intersystems/healthalthconn
- intersystems/healthalthconn-arm64
- intersystems/icm
- intersystems/icm-arm64
- intersystems/iris
- intersystems/iris-aa-community
- intersystems/iris-arm64
- intersystems/iris-community
- intersystems/iris-community-arm64
- intersystems/irishealth
- intersystems/irishealth-arm64
- intersystems/irishealth-community
- intersystems/irishealth-community-arm64
- intersystems/passwordhash
- intersystems/sam
- intersystems/webgateway
- intersystems/webgateway-arm64

Copy code to clipboard

To list the tags of all the images in a specific repository within the registry, you can use the docker-ls tags command. For example, to list the publicly available InterSystems IRIS for Health images without logging into the registry, use the following command:

$ docker-ls tags --registry https://containers.intersystems.com
    intersystems/irishealth-community
requesting list . done
repository: intersystems/irishealth-community
tags:
- 2020.1.0.217.1
- 2020.2.0.211.0
- 2020.3.0.200.0

Copy code to clipboard

Further examples are available at https://github.com/mayflower/docker-ls.