Skip to content

This is a wrapper for Docker Credential helpers created by Azure Container Registry (ACR) team. This tool allows Azure Active Directory (AAD) based login

License

Notifications You must be signed in to change notification settings

kengou/acr-docker-credential-helper

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

21 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ACR Docker Credential Helper

The ACR Docker Credential Helper allows users to sign-in to the Azure Container Registry service using their Azure Active Directory (AAD) credentials. This credential helper is in charge of ensuring that the stored credentials are valid, and when required it also renews the credentials for a repository.

For now, this credential helper works in tandem with the Azure CLI, which is required in order to initiate the credential flow. Once you've successfully logged in to your container registry with the Azure CLI, the credential helper administers the life cycle of your locally stored credential.

Prerequisites

Installation

For Windows, run the powershell installation script in administrator mode:

iex ([System.Text.Encoding]::UTF8.GetString((Invoke-WebRequest -Uri https://aka.ms/acr/installaad/win).Content))

For Linux and macOS, run the bash installation script:

curl -L https://aka.ms/acr/installaad/bash | /bin/bash

Usage

After installing the ACR Docker Credential Helper, login to an Azure Container Registry using the Azure CLI:

az acr login -n <registry name>

After that, you will be able to use docker normally. This credential helper will help maintaining your credentials.

Developer Guide:

To manually build and launch this credential helper:

  • Invoke build.sh to build and launch a docker container and perform a cross-platform build.
  • Find the appropriate docker-credential-acr-<osname>-<arch> archive in the artifacts directory. Extract the appropriate archive for your os and place the docker-credential-acr-<osname> executable file to any directory under your PATH.
  • Add the following entry to your docker config.json
    {
        "credsStore": "acr-<osname>"
    }
    

Troubleshooting

Getting 401 (authentication required)

If you have not called az acr login -n <registry> to log in to your registry for an extended period of time and you get a 401 error, please log in again. If you find yourself having to log in every hour or so, make sure your computer clock is set to the correct time.

About

This is a wrapper for Docker Credential helpers created by Azure Container Registry (ACR) team. This tool allows Azure Active Directory (AAD) based login

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Go 68.5%
  • Shell 21.3%
  • PowerShell 8.7%
  • Makefile 1.5%