gardendev/garden-azure

Garden容器镜像（含Azure CLI工具）

镜像概述

本镜像为Garden开发工具的容器化版本，集成了Azure CLI（Azure命令行工具），旨在提供一个开箱即用的容器环境，让用户可同时使用Garden的开发环境管理功能和Azure云服务的命令行操作能力，无需在本地系统单独安装配置，提升开发与部署效率。

核心功能与特性

• 完整Garden工具链：包含Garden开发工具的全部核心功能，支持开发环境定义、依赖管理、服务部署等开发流程管理。
• Azure CLI集成：预装Azure CLI工具，可直接执行az命令与Azure云服务交互（如资源管理、部署操作、权限配置等）。
• 环境隔离：容器化设计确保开发环境与本地系统隔离，避免依赖冲突，支持多版本并行使用。
• 轻量级基础：基于精简基础镜像构建，体积优化，启动快速，适合本地开发及CI/CD场景。
• 跨平台兼容：支持Linux、macOS、Windows（需Docker环境）等主流操作系统的容器运行环境。

使用场景与适用范围

适用场景

• 开发环境统一：团队成员通过容器镜像获取一致的Garden+Azure CLI环境，避免"本地环境不一致"问题。
• CI/CD流程集成：在自动化流水线中作为执行环境，运行Garden部署命令及Azure资源操作脚本。
• 临时测试环境：快速启动包含完整工具链的临时容器，用于功能验证或问题排查。
• 多版本并行：可通过不同标签镜像同时运行多个Garden/Azure CLI版本，满足多项目需求。

适用人群/团队

• 使用Garden管理开发环境且依赖Azure云服务的开发团队
• 需要在隔离环境中执行Azure CLI操作的开发/运维人员
• 构建涉及Garden部署与Azure资源管理的自动化流程的工程师

使用方法与配置说明

前提条件

• 已安装Docker Engine（版本20.10+）或Docker Desktop
• （可选）Azure账号及登录凭证（用于Azure CLI操作）

镜像拉取

从容器仓库拉取镜像（假设镜像标签为latest）：

bash
docker pull garden-azure-cli:latest

基本使用方法

1. 交互式运行

启动容器并进入交互式终端，直接使用Garden和Azure CLI命令：

bash
docker run -it --rm garden-azure-cli:latest /bin/bash

在终端中可执行：

bash
# 验证Garden版本
garden --version

# 验证Azure CLI版本
az --version

2. 挂载本地文件（项目/配置）

挂载本地项目目录及Azure配置文件，实现数据持久化与本地文件联动：

bash
# 挂载项目目录（当前目录）到容器内/app，挂载Azure配置目录（~/.azure）到容器内/root/.azure
docker run -it --rm \
  -v $(pwd):/app \
  -v ~/.azure:/root/.azure \
  garden-azure-cli:latest /bin/bash

• /app：容器内默认工作目录，可通过-w /app指定为工作目录
• ~/.azure：本地Azure CLI配置目录，挂载后容器内可直接使用本地Azure登录状态

3. 直接执行命令

无需进入终端，直接在容器内执行单条命令（如Garden部署或Azure资源查询）：

bash
# 使用Garden部署项目
docker run --rm -v $(pwd):/app -w /app garden-azure-cli:latest garden deploy

# 使用Azure CLI查询资源组
docker run --rm -v ~/.azure:/root/.azure garden-azure-cli:latest az group list --output table

Docker Compose配置示例

创建docker-compose.yml文件，定义包含持久化挂载和环境变量的服务：

yaml
version: '3.8'
services:
  garden-azure:
    image: garden-azure-cli:latest
    volumes:
      - ./project:/app  # 挂载本地项目目录
      - azure-config:/root/.azure  # 持久化Azure配置（避免重复登录）
    environment:
      - GARDEN_CONFIG=/app/garden.yml  # 指定Garden配置文件路径（可选）
    stdin_open: true  # 保持标准输入打开
    tty: true  # 分配伪终端

volumes:
  azure-config:  # 命名卷，持久化Azure CLI配置

启动服务：

bash
docker-compose up -d
# 进入容器终端
docker-compose exec garden-azure /bin/bash

配置说明

环境变量

数据持久化

• 项目文件：通过-v 本地目录:/app挂载，避免容器重启后项目文件丢失
• Azure配置：通过挂载~/.azure目录或使用命名卷（如Docker Compose示例），保留Azure登录状态及配置

注意事项

• 首次使用Azure CLI需通过az login命令登录Azure账号（挂载本地配置目录可复用本地登录状态）
• Garden配置文件需确保路径可被容器访问（建议通过挂载本地文件或在容器内创建）
• 生产环境使用时建议指定具体镜像标签（如v1.2.3），避免latest标签自动更新导致兼容性问题