docker/ecs-secrets-sidecar

Docker Compose "Cloud Integrations"

⚠️ 退役通知

Docker Compose对ECS和ACI的集成已于2023年11月退役。目前，本仓库的主要工作集中在关键安全修复。

ECS用户可考虑使用https://github.com/docker/compose-ecs%E6%9B%BF%E4%BB%A3%E3%80%82

镜像概述和主要用途

Docker Compose "Cloud Integrations"是一款CLI工具，旨在简化通过现有Docker命令在云环境中运行Docker容器和Docker Compose应用的流程。该工具支持将应用部署至主流云容器服务，降低云环境部署门槛。

核心功能和特性

• 多云服务支持：兼容Amazon Elastic Container Service (ECS)、Microsoft Azure Container Instances (ACI)，Kubernetes支持处于开发中
• 命令兼容性：无需学习新命令，直接使用已熟悉的Docker命令操作云资源
• 无缝集成：与Docker Compose应用模型深度整合，支持现有Compose配置文件
• 跨平台支持：覆盖macOS、Windows（含WSL2）及Linux操作系统

使用场景和适用范围

适用场景

• 将本地Docker Compose应用快速迁移至AWS ECS或Azure ACI
• 通过标准化Docker命令管理云容器实例，简化多云部署流程
• 结合CI/CD流程实现云环境自动化部署（如Github Actions集成）

典型案例

• ECS：部署Wordpress应用至AWS云环境
• ACI：部署Minecraft服务器至Azure云环境
• ACI：通过Docker、Azure和Github Actions构建云部署流水线

使用方法和配置说明

系统要求

• macOS/Windows/Windows WSL2：需安装最新版Docker Desktop
• Linux：通过安装脚本部署

前置条件

• 拥有AWS账户（用于ECS集成）或Azure账户（用于ACI集成）
• 已配置云服务访问凭证（AWS Access Key/Secret或Azure Service Principal）

快速开始

1. 安装工具
   根据操作系统选择对应安装方式（Docker Desktop或Linux安装脚本）

2. 配置云凭证
   通过Docker CLI或云服务控制台配置账户访问权限，确保工具可正常调用云API

3. 部署应用
   使用现有docker compose up命令部署应用至指定云服务，工具会自动处理云资源编排

示例参考

• ECS部署示例：将Wordpress部署至云环境
• ACI部署示例：将Minecraft服务器部署至云环境
• CI/CD集成示例：使用Docker、Azure和Github Actions配置云部署

开发与贡献

构建与测试

参考BUILDING.md获取CLI工具的构建指南、测试方法（包括本地容器、ACI及ECS的端到端测试），以及版本发布流程。

贡献指南

在提交贡献前，请阅读贡献规范，了解项目代码规范及协作流程。

注意：Docker Compose v2（本地Docker Compose）代码已迁移至https://github.com/docker/compose/tree/v2%EF%BC%8C%E6%9C%AC%E4%BB%93%E5%BA%93%E4%BB%85%E7%BB%B4%E6%8A%A4%22Cloud Integrations"相关功能。