dandersonacro/gitlabci-awscli

gitlabci-awscli

镜像概述

gitlabci-awscli是一个适用于在GitLab CI作业中运行AWS CLI命令的Docker镜像，旨在简化CI/CD流程中与AWS服务的交互操作。

核心功能与特性

• 集成AWS CLI工具，可直接在GitLab CI环境中执行AWS命令
• 专为GitLab CI流水线设计，无需额外配置即可作为作业运行环境
• 轻量级镜像，减少CI作业启动时间

使用场景与适用范围

适用于GitLab CI/CD流水线中需要与AWS服务交互的各类场景，包括但不限于：

• 部署应用至AWS服务（如EC2、S3、ECS、Lambda等）
• 管理AWS资源（创建、更新、删除AWS资源）
• 执行AWS相关自动化脚本（如备份、日志收集、资源监控等）
• 在CI流程中验证AWS资源配置

使用方法与配置说明

在GitLab CI配置中使用

在.gitlab-ci.yml文件中指定该镜像作为作业运行环境：

yaml
aws_deploy_job:
  image: dandersonacro/gitlabci-awscli
  stage: deploy
  script:
    - aws --version  # 验证AWS CLI版本
    - aws configure list  # 查看配置信息
    - aws s3 sync ./dist s3://your-bucket-name  # 示例：同步文件至S3存储桶

配置AWS凭证

为使AWS CLI能正常访问AWS服务，需配置AWS凭证，推荐通过GitLab CI环境变量传递：

1. 在GitLab项目中添加CI变量：

   • 进入项目 设置 > CI/CD > 变量
   • 添加变量 AWS_ACCESS_KEY_ID（AWS访问密钥ID）
   • 添加变量 AWS_SECRET_ACCESS_KEY（AWS密钥）
   • （可选）添加变量 AWS_REGION（指定AWS区域，如 us-east-1）

2. AWS CLI会自动读取上述环境变量完成身份验证，无需额外配置

本地测试（Docker run）

如需本地验证镜像功能，可使用以下命令运行容器：

bash
docker run -e AWS_ACCESS_KEY_ID="your_access_key" \
           -e AWS_SECRET_ACCESS_KEY="your_secret_key" \
           -e AWS_REGION="us-east-1" \
           dandersonacro/gitlabci-awscli \
           aws s3 ls  # 示例命令：列出S3存储桶

源代码与更新

镜像源代码及更新说明请参见：https://github.com/dandersonacro-dockerhub