workleap/azure-cli-credentials-proxy

Azure CLI开发者凭证代理Docker镜像

该轻量级容器化应用作为代理，允许其他容器化应用访问Azure开发者凭证，无需在每个容器中单独安装Azure CLI。仅适用于本地开发环境。

概述

本镜像旨在解决本地Docker开发环境中容器化应用访问Azure资源的凭证问题。通过运行一个集中式代理容器，避免在每个业务容器中安装Azure CLI，减少镜像体积并保持Dockerfile的生产就绪状态。

核心功能与特性

• 凭证代理：集中管理Azure CLI凭证，供其他容器访问
• 轻量级集成：无需修改业务容器Dockerfile，仅需添加环境变量
• 跨平台支持：兼容Linux和Windows WSL环境
• 安全隔离：仅在本地开发环境使用，避免生产环境引入Azure CLI依赖

使用场景

• 本地Docker开发环境中，多个容器化服务需要使用Azure资源
• 希望保持业务容器精简，避免安装Azure CLI导致镜像体积增大
• 需要在本地容器中模拟Azure托管身份(Managed Identity)认证流程

快速开始

1. 添加到docker-compose.yml

将以下配置添加到您的docker-compose.yml文件，根据操作系统挂载相应的.azure目录：

yaml
version: "3"

services:
  azclicredsproxy:
    image: workleap/azure-cli-credentials-proxy:latest
    ports:
      - "8080:8080"
    volumes:
      - "\\\\wsl$\\<DISTRONAME>\\home\\<USERNAME>\\.azure\\:/app/.azure/" # Windows WSL环境
      - "/home/<USERNAME>/.azure:/app/.azure/" # Linux环境

2. 配置业务容器

为使用DefaultAzureCredential或ManagedIdentityCredential的业务容器添加环境变量：

yaml
version: "3"

services:
  # azclicredsproxy配置如上...
  
  myservice:
    build: .
    depends_on:
      - azclicredsproxy
    environment:
      - "IDENTITY_ENDPOINT=http://azclicredsproxy:8080/token"
      - "IMDS_ENDPOINT=dummy_required_value"
      # 如果服务中使用"az login --identity"，添加以下变量
      - "MSI_ENDPOINT=http://azclicredsproxy:8080/token"

工作原理

背景问题

开发人员在本地运行服务时，通过az login命令将Azure个人凭证缓存到~/.azure/目录，DefaultAzureCredential会使用这些凭证访问Azure资源。但在Docker容器中：

• 业务容器通常不包含Azure CLI
• 直接挂载Windows的~/.azure/目录会因DPAPI加密问题无法使用
• 为每个容器安装Azure CLI会增加约1GB镜像体积

解决方案架构

通过运行一个专用代理容器：

1. 代理容器是唯一包含Azure CLI的容器
2. 挂载本地~/.azure/目录获取凭证
3. 暴露/token端点提供凭证访问
4. 业务容器通过环境变量指向代理端点

!解决方案架构

配置说明

环境变量

卷挂载

注意事项

• Windows用户注意：不能直接挂载Windows系统的~/.azure/目录到Linux容器，因为Windows使用DPAPI加密凭证文件，Linux容器无法解密。需在WSL中执行az login，然后挂载WSL的.azure目录。
• 仅用于开发：本代理专为本地开发环境设计，不建议在生产环境使用。
• 依赖Azure CLI：代理容器依赖Azure CLI获取凭证，确保本地已通过az login成功登录。

许可证

版权所有 © 2023 Workleap Inc.。本代码采用Apache License 2.0许可。您可以在https://github.com/workleap/gsoft-license/blob/master/LICENSE%E8%8E%B7%E5%8F%96%E8%AE%B8%E5%8F%AF%E5%89%AF%E6%9C%AC%E3%80%82