woodjme/autoscaling-ec2-gitlab-runners-fargate

基于Fargate的自动扩展EC2 GitLab Runner

镜像概述

本镜像对应的CloudFormation模板可创建Fargate服务，用于管理并自动扩展EC2实例作为GitLab CI执行器。它帮助用户实现私有GitLab Runner，无需手动管理、补丁或维护服务器。

核心功能

• 自动扩展EC2实例作为GitLab CI执行器
• 支持私有GitLab Runner部署
• 无需手动维护服务器（由Fargate管理）
• 利用S3存储作业缓存
• 通过CloudWatch日志监控服务运行状态

使用场景

• 需要私有GitLab Runner但不想管理服务器的团队
• 需要Docker-in-Docker功能（Fargate执行器不支持特权模式）的CI/CD流程
• 需要自动扩展CI执行资源以应对峰值需求的场景

配置说明

参数列表

• VpcId：选择允许实例访问互联网的VPC
• SubnetID：选择VPC内的子网
• GitLabURL：GitLab地址（自托管时需修改）
• GitLabRegistrationToken：GitLab Runner注册令牌
• RunnerRequestConcurrency：并发EC2实例数量（默认12）
• RunnerTagList：Runner标签（示例："docker,aws"）
• AdditionalRegisterParams：gitlab-runner register的额外参数
• RunnerVersion：GitLab Runner版本
• InstanceType：Runner实例类型
• RootVolumeSize：Runner根卷大小
• CacheExpirationInDays：S3缓存过期天数
• CPU：Spawner的CPU数量（1CPU=1024单位）
• Memory：Spawner的内存大小（KB）
• DockerImage：默认Docker镜像（未在gitlab-ci.yml指定时使用）

部署示例

通过CloudFormation控制台部署

点击以下按钮启动CloudFormation堆栈：
https://s3.amazonaws.com/cloudformation-examples/cloudformation-launch-stack.png](https://console.aws.amazon.com/cloudformation/home?region=region#/stacks/new?stackName=stack_name&templateURL=https://autoscaling-ec2-gitlab-runners-fargate.s3-eu-west-1.amazonaws.com/master/gitlab-runner-template.yml)

通过AWS CLI部署

bash
aws cloudformation create-stack \
  --stack-name my-gitlab-runner-stack \
  --template-url https://autoscaling-ec2-gitlab-runners-fargate.s3-eu-west-1.amazonaws.com/master/gitlab-runner-template.yml \
  --parameters \
    ParameterKey=VpcId,ParameterValue=vpc-xxxxxx \
    ParameterKey=SubnetID,ParameterValue=subnet-xxxxxx \
    ParameterKey=GitLabURL,ParameterValue=https://gitlab.com \
    ParameterKey=GitLabRegistrationToken,ParameterValue=your_token \
  --capabilities CAPABILITY_IAM

资源创建

部署后将生成以下AWS资源：

• IAM用户（用于连接S3）
• ECS相关IAM角色
• S3桶（用于Runner缓存）
• ECS集群、服务及任务定义
• CloudWatch日志组（用于Spawner日志流）