docker/aci-hostnames-sidecar

Docker Compose "云集成"工具

⚠️ 退役通知

Docker Compose对ECS和ACI的集成已于2023年11月退役。目前，本仓库的主要工作优先级为关键安全修复。ECS用户可考虑使用https://github.com/docker/compose-ecs%E6%9B%BF%E4%BB%A3%E3%80%82

镜像概述和主要用途

Docker Compose "云集成"工具（Compose CLI）旨在简化通过现有Docker命令在云端运行Docker容器和Docker Compose应用的流程。该工具支持通过统一的Docker命令集，将容器应用部署至以下云服务：

• Amazon Elastic Container Service（ECS）
• Microsoft Azure Container Instances（ACI）
• Kubernetes（开发中）

核心功能和特性

核心功能

• 多云服务支持：原生集成AWS ECS和Azure ACI（已退役，当前仅维护安全修复），即将支持Kubernetes
• 命令兼容性：无需学习新命令，直接使用现有Docker/Compose命令（如docker compose up）操作云端资源
• 跨平台兼容：支持macOS、Windows（含WSL2）及Linux系统
• 账户集成：与AWS、Azure账户系统对接，直接使用云服务商认证体系

关键特性

• 无缝迁移：本地Docker Compose配置文件可直接用于云端部署
• 简化部署：自动处理云资源编排（如网络、存储、负载均衡配置）
• Docker生态集成：与Docker Desktop深度整合（macOS/Windows），Linux系统提供独立安装脚本

使用场景和适用范围

适用场景

• 快速云部署：通过熟悉的Docker命令将本地容器应用一键部署至ECS或ACI
• 多环境一致性：确保开发、测试、生产环境使用相同的Compose配置
• CI/CD集成：结合GitHub Actions等工具实现云端部署自动化

典型用例

• ECS场景：部署WordPress等Web应用至AWS云环境（参考官方教程）
• ACI场景：部署Minecraft服务器至Azure容器实例（参考官方教程）
• 自动化部署：通过Docker、Azure和GitHub Actions构建云部署流水线（参考官方教程）

适用用户

• 需要通过Docker命令管理云端容器的开发/运维人员
• 依赖Docker Compose进行应用编排，且需扩展至AWS/Azure的团队
• 追求本地与云端部署流程一致性的技术团队

安装与配置说明

环境要求

• 操作系统：
  • macOS/Windows/WSL2：需安装最新版Docker Desktop
  • Linux：需通过安装脚本部署
• 云账户：需拥有AWS或Azure账户（用于云资源访问授权）

安装步骤

1. macOS/Windows/WSL2用户：
   安装Docker Desktop后，云集成功能默认包含，无需额外配置。

2. Linux用户：
   执行官方安装脚本：

   bash
   # 参考INSTALL.md获取最新安装命令
   curl -fsSL https://raw.githubusercontent.com/docker/compose-cli/main/INSTALL.md | sh
   

3. 云账户配置：
   需通过AWS CLI或Azure CLI完成账户认证：

   • AWS：执行aws configure配置Access Key和区域
   • Azure：执行az login完成账户登录

使用方法

基本工作流程

1. 编写标准Docker Compose配置文件（docker-compose.yml）
2. 通过docker compose命令指定云端目标平台部署：

   bash
   # 部署至ECS（需提前配置AWS账户）
   docker compose up --project-name my-app --context aws
   
   # 部署至ACI（需提前配置Azure账户）
   docker compose up --project-name my-app --context azure
   

核心命令

示例与参考

官方示例文档

• ECS：部署WordPress至云端
• ACI：部署Minecraft服务器至云端
• ACI：使用Docker、Azure和GitHub Actions构建云部署流水线

开发与贡献

开发指南

构建CLI及运行测试（含本地容器、ACI、ECS的端到端测试）的详细步骤见BUILDING.md，该文档同时包含CLI发布流程说明。

贡献规范

贡献前请阅读贡献指南，其中包含项目代码规范及协作流程。

反馈与支持

如需反馈或报告问题，请通过https://github.com/docker/compose-cli/issues%E6%8F%90%E4%BA%A4%E3%80%82