pasonpower/circleci-python

镜像概述

该镜像专为CircleCI持续集成/持续部署(CI/CD)流程设计，基于官方Python镜像构建，预安装docker-compose和awscli工具。旨在简化CI环境中Python应用开发、容器编排及AWS云服务交互的流程，提供一站式的开发与部署环境。

核心功能与特性

• 内置Python运行环境：支持多种Python版本（具体版本通过镜像标签指定），满足不同项目的Python依赖需求
• 集成docker-compose：可直接在CI环境中执行容器编排命令，管理多容器应用的构建、启动和测试流程
• 预装awscli：支持与AWS服务直接交互，便于在CI/CD流程中执行AWS资源管理、应用部署等操作
• CircleCI兼容性优化：镜像配置符合CircleCI运行环境要求，可直接作为CI任务的执行环境，减少环境配置开销

使用场景

• Python应用自动化测试：在CircleCI中利用内置Python环境执行单元测试、集成测试等任务
• 容器化应用CI/CD：通过docker-compose在CI环境中构建、测试多容器应用，验证容器化部署流程
• AWS云服务部署：使用awscli在CI流程中自动化部署应用至AWS服务（如ECS、S3、Lambda等）
• 混合开发环境需求：同时需要Python运行环境、容器编排工具和AWS命令行工具的CI任务场景

使用方法

基础使用（docker run）

bash
# 验证镜像基本信息
docker run --rm -it circleci/python-with-docker-compose-awscli:latest python --version
docker run --rm -it circleci/python-with-docker-compose-awscli:latest docker-compose --version
docker run --rm -it circleci/python-with-docker-compose-awscli:latest aws --version

在CircleCI配置中使用

在.circleci/config.yml中指定该镜像作为执行环境：

yaml
version: 2.1
jobs:
  build-test-deploy:
    docker:
      - image: circleci/python-with-docker-compose-awscli:3.9  # 指定Python 3.9版本
    steps:
      - checkout  # 拉取代码
      - run: 
          name: 验证环境
          command: |
            python --version
            docker-compose --version
            aws --version
      - run: 
          name: 安装项目依赖
          command: pip install -r requirements.txt
      - run: 
          name: 执行单元测试
          command: python -m pytest tests/
      - run: 
          name: 构建并启动容器服务
          command: docker-compose up -d --build
      - run: 
          name: 部署至AWS S3
          command: aws s3 cp ./dist s3://my-deployment-bucket/ --recursive

环境变量配置

通过环境变量配置awscli认证信息及运行参数：

• AWS_ACCESS_KEY_ID: AWS访问密钥ID（用于AWS服务认证）
• AWS_SECRET_ACCESS_KEY: AWS密钥（用于AWS服务认证）
• AWS_DEFAULT_REGION: 默认AWS区域（如us-east-1、eu-west-1等）

示例配置AWS认证：

bash
docker run -e AWS_ACCESS_KEY_ID=AKIAEXAMPLE \
           -e AWS_SECRET_ACCESS_KEY=secretExample \
           -e AWS_DEFAULT_REGION=us-east-1 \
           --rm circleci/python-with-docker-compose-awscli:latest \
           aws s3 ls  # 列出S3存储桶

版本选择

镜像标签格式为circleci/python-with-docker-compose-awscli:<python-version>，支持的Python版本包括：

• 3.8
• 3.9
• 3.10
• 3.11

选择与项目Python版本匹配的镜像标签，例如使用Python 3.10：

yaml
# 在CircleCI配置中指定Python 3.10版本
docker:
  - image: circleci/python-with-docker-compose-awscli:3.10