InterSystems Official
Steven LeBlanc · Aug 21, 2020

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 support@intersystems.com.

--------------------------------------------------------------

Using the InterSystems Container Registry

This document lists the images available in the InterSystems Container Registry (ICR), located at containers.intersystems.com, and provides instructions for using it.

Images in the ICR can be downloaded with the docker pull command, for example:

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

 

This document contains the following sections:

  • Public Images
  • Limited Access Images
  • Authenticating to the ICR
  • Listing the ICR Inventory

Public Images

The following ICR images are publicly available and can be pulled without authentication:

InterSystems IRIS

IntegratedML

2020.3

containers.intersystems.com/intersystems/iris-ml-community:2020.3.0.302.0

Community Edition

2020.3

containers.intersystems.com/intersystems/iris-community:2020.3.0.221.0

2020.3 ARM64

containers.intersystems.com/intersystems/iris-community-arm64:2020.3.0.221.0

InterSystems IRIS for Health

IntegratedML 2020.3 containers.intersystems.com/intersystems/irishealth-ml-community:2020.3.0.302.0
Community Edition

2020.3

containers.intersystems.com/intersystems/irishealth-community:2020.3.0.221.0

2020.3 ARM64

containers.intersystems.com/intersystems/irishealth-community-arm64:2020.3.0.221.0

System Alerting and Monitoring

 

1.0

containers.intersystems.com/intersystems/sam:1.0.0.115

Limited Access Images

The following ICR images are available only to authenticated users:

Arbiter

2020.1

containers.intersystems.com/intersystems/arbiter:2020.1.0.215.0

2020.2

containers.intersystems.com/intersystems/arbiter:2020.2.0.211.0

2020.3

containers.intersystems.com/intersystems/arbiter:2020.3.0.210.0

Health Connect

2020.1

containers.intersystems.com/intersystems/healthconnect:2020.1.0.215.0

InterSystems Cloud Manager (ICM)

2020.1

containers.intersystems.com/intersystems/icm:2020.1.0.215.0

2020.2

containers.intersystems.com/intersystems/icm:2020.2.0.211.0

2020.3

containers.intersystems.com/intersystems/icm:2020.3.0.221

InterSystems IRIS

2020.1

containers.intersystems.com/intersystems/iris:2020.1.0.215.0

2020.2

containers.intersystems.com/intersystems/iris:2020.2.0.211.0

2020.3

containers.intersystems.com/intersystems/iris:2020.3.0.221.0

2020.1 ARM64

containers.intersystems.com/intersystems/iris-arm64:2020.1.0.215.0

2020.2 ARM64

containers.intersystems.com/intersystems/iris-arm64:2020.2.0.211.0

2020.3 ARM64

containers.intersystems.com/intersystems/iris-arm64:2020.3.0.221.0

2020.3 IntegratedML containers.intersystems.com/intersystems/iris-ml:2020.3.0.302.0

InterSystems IRIS for Health

2020.1

containers.intersystems.com/intersystems/irishealth:2020.1.0.217.1

2020.2

containers.intersystems.com/intersystems/irishealth:2020.2.0.211.0

2020.3

containers.intersystems.com/intersystems/irishealth:2020.3.0.221.0

2020.1 ARM64

containers.intersystems.com/intersystems/irishealth-arm64:2020.1.0.217.1

2020.2 ARM64

containers.intersystems.com/intersystems/irishealth-arm64:2020.2.0.211.0

2020.3 ARM64

containers.intersystems.com/intersystems/irishealth-arm64:2020.3.0.221.0

2020.3 IntegratedML containers.intersystems.com/intersystems/irishealth-ml:2020.3.0.302.0

PasswordHash

1.0

containers.intersystems.com/intersystems/passwordhash:1.0

Web Gateway

2020.2

containers.intersystems.com/intersystems/webgateway:2020.2.0.211.0

2020.3

containers.intersystems.com/intersystems/webgateway:2020.3.0.221.0

Authenticating 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.
  2. Retrieve your Docker login token, or the full login command.
  3. 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:
docker login -u="bbinstoc" -p="provided_password" containers.intersystems.com

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.

  1. You can now pull images from the ICR, for example:
docker pull containers.intersystems.com/intersystems/iris:2020.3.0.221.0

Listing the ICR Inventory

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
  • 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

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

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:

docker-ls tags --registry https://containers.intersystems.com --user "" --password "" intersystems/irishealth-community

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

 

110
4 7 482 2

Replies

Hi, it's possible you're still logged into another registry. Can you try a 'docker logout' prior to attempting to access containers.intersystems.com?

Hi Abdullah,
We needed to link your user account with your organization.
That should be all set now, please let us know if you have any further issues.

Even after another docker logout? Please reach out to the WRC to help with your authentication issue. 

thank you a lot, it is succeeded and I would like to send you the message:

WARNING! Using --password via the CLI is insecure. Use --password-stdin.
WARNING! Your password will be stored unencrypted in /root/snap/docker/471/.docker/config.json.
Configure a credential helper to remove this warning. See
https://docs.docker.com/engine/reference/commandline/login/#credentials-...

Login Succeeded

But I have another Problem as I have done: docker-compose build:

Step 1/16 : FROM containers.intersystems.com/intersystems/webgateway:2020.2.0.211.0
ERROR: Service 'webserver' failed to build : manifest for containers.intersystems.com/intersystems/webgateway:2020.2.0.211.0 not found: manifest unknown: The named manifest is not known to the registry.