You can use the aliyun-acr-credential-helper component to pull private images without a password from instances of Container Registry Enterprise Edition and Personal Edition. This topic describes the features, usage notes, and release notes for aliyun-acr-credential-helper.

Introduction

aliyun-acr-credential-helper retrieves the required information from the acr-configuration ConfigMap that is created in the kube-system namespace and then pulls private images. The following features are supported:
  • You can use aliyun-acr-credential-helper to pull private images from instances of Container Registry Enterprise Edition and Personal Edition.
  • You can use aliyun-acr-credential-helper to pull private images from your Container Registry instances. You can also pull private images from other accounts after authorization or by using an AccessKey ID and the corresponding AccessKey secret.
  • You can use aliyun-acr-credential-helper to pull private images from Container Registry instances that are deployed in different regions.

Usage notes

For more information about how to use aliyun-acr-credential-helper, see Use the aliyun-acr-credential-helper component to pull images without secrets or Pull images without a password in a self-managed Kubernetes cluster .

Release notes

March 2023

VersionImage addressRelease dateDescriptionImpact
v23.02.06.1-74e2172-aliyunregistry.cn-hangzhou.aliyuncs.com/acs/aliyun-acr-credential-helper:v23.02.06.1-74e2172-aliyun2023-03-15
  • Some known issues are fixed.
  • The RAM Roles for Service Accounts (RRSA) feature is supported for permission management.
  • Service accounts are ready for use after creation when Helm charts are used to install the component.
  • The Intelligent O&M feature can be used to diagnose the aliyun-acr-credential-helper component.
No impact on workloads

March 2022

VersionImage addressRelease dateDescriptionImpact
v22.03.25.1-efe240e-aliyunregistry.cn-hangzhou.aliyuncs.com/acs/aliyun-acr-credential-helper:v22.03.25.1-efe240e-aliyun2022-03-25
  • The version conflict that occurs when multiple controllers update a Secret at the same time is fixed.
  • Auto scaling is supported by default node pools.
This update has no negative impact on workloads.

January 2022

VersionImage addressRelease dateDescriptionImpact
v22.01.04.0-f637776-aliyunregistry.cn-hangzhou.aliyuncs.com/acs/aliyun-acr-credential-helper:v22.01.04.0-f637776-aliyun2022-01-04
  • The Advanced RISC Machine (ARM) architecture is supported.
  • aliyun-acr-credential-helper is no longer automatically installed when you create a cluster. You must manually install aliyun-acr-credential-helper after you create a cluster.
  • The performance of aliyun-acr-credential-helper is improved.
This update has no negative impact on workloads.

November 2021

VersionImage addressRelease dateDescriptionImpact
v21.11.15.0-19d8bc1-aliyunregistry.cn-hangzhou.aliyuncs.com/acs/aliyun-acr-credential-helper:v21.11.15.0-5d5867b-aliyun2021-11-15The API version of ClusterRoles is updated. This update has no negative impact on workloads.

September 2021

VersionImage addressRelease dateDescriptionImpact
v21.09.22.0-450db22-aliyunregistry.cn-hangzhou.aliyuncs.com/acs/aliyun-acr-credential-helper:v21.09.22.0-450db22-aliyun2021-09-22A cluster event is generated when an error occurs on the component. This update has no negative impact on workloads.

January 2021

VersionImage addressRelease dateDescriptionImpact
v21.01.26.0-9ac7d9b-aliyunregistry.cn-hangzhou.aliyuncs.com/acs/aliyun-acr-credential-helper:v21.01.26.0-9ac7d9b-aliyun2021-01-26The authentication methods are optimized. This update has no negative impact on workloads.

August 2020

VersionImage addressRelease dateDescriptionImpact
v20.08.20.0-c2da10b-aliyunregistry.cn-hangzhou.aliyuncs.com/acs/aliyun-acr-credential-helper:v20.08.20.0-c2da10b-aliyun2020-08-24The issue that private images fail to be pulled because the token is expired is fixed. This update has no negative impact on workloads.

July 2020

VersionImage addressRelease dateDescriptionImpact
v20.07.13.0-2866ccd-aliyunregistry.cn-hangzhou.aliyuncs.com/acs/aliyun-acr-credential-helper:v20.07.13.0-2866ccd-aliyun2020-07-13

New features:

  • API operations can be called over internal networks.
  • Images can be pulled by using a Secret that contains an AccessKey ID and an AccessKey secret.

Optimization: The required number of API calls to pull an image is reduced.

This update has no negative impact on workloads.

March 2020

VersionImage addressRelease dateDescriptionImpact
v20.03.16.0-36d5d7e-aliyunregistry.cn-hangzhou.aliyuncs.com/acs/aliyun-acr-credential-helper:v20.03.16.0-36d5d7e-aliyun2020-03-16New features: Private images can be pulled from a different account. This update has no negative impact on workloads.