cycloid/composer

PHP Composer 集成镜像（含Git和AWS CLI）

镜像概述

本镜像基于官方 composer/composer 构建，集成了 PHP Composer、Git 版本控制工具及 AWS CLI（Amazon Web Services 命令行工具），提供一站式 PHP 项目开发与部署环境，简化依赖管理、代码版本控制及与 AWS 云服务的交互流程。

核心功能与特性

• Composer 支持：内置稳定版 Composer，可直接执行 composer install、composer update 等命令，管理 PHP 项目依赖。
• Git 集成：包含完整 Git 工具链，支持代码克隆、提交、分支管理等版本控制操作，便于从代码仓库拉取项目或提交变更。
• AWS CLI 支持：预装 AWS CLI，可通过命令行配置 AWS 凭证、管理 S3 存储、EC2 实例等 AWS 服务，适合云环境部署场景。
• 轻量级基础：基于官方 Composer 镜像，在保持精简体积的同时提供完整功能，适合开发与 CI/CD 环境使用。

使用场景与适用范围

• PHP 项目开发：本地开发环境中快速安装依赖、管理代码版本。
• CI/CD 流程：在持续集成/部署管道中，用于依赖安装、代码拉取及 AWS 资源部署。
• AWS 云部署：直接在容器中执行 AWS CLI 命令，实现 PHP 应用向 AWS 服务（如 Elastic Beanstalk、ECS）的部署。
• 多环境一致性：确保开发、测试、生产环境中依赖管理工具、版本控制及云服务交互工具的一致性。

使用方法与配置说明

基本使用（Docker Run）

bash
docker run --rm -v $(pwd):/app -w /app docker.xuanyuan.run/composer-git-awscli:latest composer install

参数说明：

• -v $(pwd):/app：将当前目录挂载到容器内的 /app 目录，实现项目文件共享。
• -w /app：设置工作目录为 /app，即项目根目录。
• composer install：执行 Composer 安装依赖命令。

执行 Git 命令

bash
docker run --rm -v $(pwd):/app -w /app docker.xuanyuan.run/composer-git-awscli:latest git clone https://github.com/example/php-project.git

配置 AWS CLI 并执行命令

1. 交互式配置 AWS 凭证（首次使用）：

bash
docker run --rm -it -v $(pwd):/app -w /app docker.xuanyuan.run/composer-git-awscli:latest aws configure

根据提示输入 AWS Access Key ID、Secret Access Key、默认区域（如 us-east-1）及输出格式（如 json）。

2. 执行 AWS 命令（如列出 S3 存储桶）：

bash
docker run --rm -v $(pwd):/app -w /app docker.xuanyuan.run/composer-git-awscli:latest aws s3 ls

Docker Compose 配置示例

yaml
version: '3'
services:
  php-composer:
    image: docker.xuanyuan.run/composer-git-awscli:latest
    volumes:
      - ./:/app
    working_dir: /app
    environment:
      - AWS_ACCESS_KEY_ID=your_aws_access_key
      - AWS_SECRET_ACCESS_KEY=your_aws_secret_key
      - AWS_DEFAULT_REGION=us-east-1

环境变量说明：

• AWS_ACCESS_KEY_ID：AWS 访问密钥 ID（非交互式配置凭证）。
• AWS_SECRET_ACCESS_KEY：AWS 密钥（非交互式配置凭证）。
• AWS_DEFAULT_REGION：默认 AWS 区域。

注意事项

• 挂载目录时确保本地项目目录权限正确，避免容器内操作权限问题。
• AWS 凭证建议通过环境变量或外部配置文件挂载传递，避免硬编码。
• 可通过 composer --version、git --version、aws --version 命令验证工具版本。