Pull access denied for microsoft/aspnet, repository does not exist or may require 'docker login'

Issue

When trying to build a docker image using the docker file and powershell scripts provided with Kofax TotalAgility, the docker build command results in the error: pull access denied for microsoft/aspnet, repository does not exist or may require 'docker login'.

Cause

The sample docker file provided with the product points to the old location that Microsoft used on Docker Hub.  Microsoft has completed the process of Deprecating the Distribution of Microsoft Container Images via Docker Hub (details from Microsoft Tech Community).  This means that the location used by the scripts no longer exists and causes this error.

Solution

As stated by Microsoft: "you must update docker pull commands, FROM statements in Dockerfiles, and other references to microsoft/ container images to explicitly reference the mcr.microsoft.com registry."

With regards to the sample files provided with the product, this means opening [Install source]\Utilities\Docker\Dockerfile, then changing the first line from:

FROM microsoft/aspnet

to the updated line:

FROM mcr.microsoft.com/dotnet/framework/aspnet:4.8

After that change the docker build command will be able to pull Microsoft's aspnet image from the newer repository without this error occurring.

Level of Complexity 

Moderate

Applies to  

References

Deprecating the Distribution of Microsoft Container Images via Docker Hub - Microsoft Tech Community

​