MicroK8s 配置 ECR 私有镜像仓库认证指南

背景介绍

在 Kubernetes 集群中使用 Amazon ECR (Elastic Container Registry) 私有镜像仓库时，需要正确配置认证机制。MicroK8s 作为轻量级 Kubernetes 发行版，同样需要针对 ECR 进行特殊配置才能顺利拉取私有镜像。

核心问题分析

当用户在 MicroK8s 中配置 ECR 凭证提供程序时，可能会遇到凭证提供程序已注册但无法实际拉取镜像的情况。这通常是由于路径配置不当或执行环境问题导致的。

解决方案详解

1. 准备凭证提供程序二进制文件

首先需要获取 ECR 凭证提供程序的二进制文件。可以从 Kubernetes 官方资源获取适用于 Linux AMD64 架构的预编译版本。

2. 配置凭证提供程序

创建配置文件 /var/snap/microk8s/common/credential-provider-config.yaml，内容如下：

apiVersion: kubelet.config.k8s.io/v1
kind: CredentialProviderConfig
providers:
  - name: ecr-credential-provider
    apiVersion: credentialprovider.kubelet.k8s.io/v1
    matchImages:
      - "*.dkr.ecr.*.amazonaws.com"
    defaultCacheDuration: 12h

3. 修改 Kubelet 配置

编辑 /var/snap/microk8s/current/args/kubelet 文件，添加以下参数：

--image-credential-provider-config=${SNAP_COMMON}/credential-provider-config.yaml
--image-credential-provider-bin-dir=${SNAP_COMMON}/bin

4. 安装凭证提供程序

将 ECR 凭证提供程序二进制文件安装到 MicroK8s 的公共目录中：

sudo mkdir -p /var/snap/microk8s/common/bin
sudo cp ecr-credential-provider /var/snap/microk8s/common/bin/
sudo chmod +x /var/snap/microk8s/common/bin/ecr-credential-provider

5. 重启 MicroK8s 服务

应用配置变更：

sudo snap restart microk8s

验证配置

可以通过以下命令测试凭证提供程序是否正常工作：

sudo snap run --shell microk8s.daemon-kubelite

echo '{
  "apiVersion": "credentialprovider.kubelet.k8s.io/v1",
  "kind": "CredentialProviderRequest",
  "image": "YOUR_ECR_REPO.dkr.ecr.YOUR_REGION.amazonaws.com/repository/image"
}' | $SNAP_COMMON/bin/ecr-credential-provider

认证方式支持

MicroK8s 的 ECR 凭证提供程序支持两种 AWS 认证方式：

1. IAM 实例配置文件（推荐用于生产环境）
2. AWS 访问密钥和秘密密钥

注意事项

1. 确保凭证提供程序二进制文件具有可执行权限
2. 配置文件路径必须使用 MicroK8s 的 SNAP_COMMON 目录
3. 重启服务后配置才会生效
4. 检查 AWS 权限是否足够拉取 ECR 镜像

通过以上步骤，MicroK8s 集群将能够顺利地从 AWS ECR 私有仓库拉取容器镜像，为混合云环境下的容器部署提供了便利。