vlaszaty/gitlab-ci-kops-tf

gitlab-ci-kops-tf镜像说明

镜像概述

本镜像基于Alpine 3.7系统构建，集成Kops、Kubectl、Terraform和awscli等工具，旨在通过Gitlab CI流水线自动化向AWS云平台部署Kubernetes集群。目前自动化构建版本可访问https://hub.docker.com/r/vlaszaty/gitlab-ci-kops-tf-build/%EF%BC%8C%E6%9C%AA%E6%9D%A5%E6%9B%B4%E6%96%B0%E5%B0%86%E5%9C%A8%E6%AD%A4%E5%9C%B0%E5%9D%80%E5%8F%91%E5%B8%83%E3%80%82

核心功能

• 基础系统：Alpine 3.7（轻量级，镜像体积小）
• 集成工具版本：
  • Kops：1.9.0（git-cccd71e67）
  • Kubectl：v1.10.0
  • Terraform：v0.11.7
  • awscli：1.15.4
• 支持从Gitlab CI触发AWS上Kubernetes集群的创建与管理
• 可结合Terraform完成AWS基础设施前置配置

使用场景

• Gitlab CI流水线中自动化部署Kubernetes集群到AWS
• 需要在CI环境中同时使用Terraform管理AWS资源和Kops创建K8s集群的场景
• 团队协作中标准化云原生集群部署流程

配置说明

1. AWS凭证配置：需在CI环境注入AWS_ACCESS_KEY_ID和AWS_SECRET_ACCESS_KEY，可通过Gitlab CI项目变量设置。
2. 状态存储配置：Kops集群状态需存储在AWS S3桶，需提前创建并配置权限。
3. 集群参数配置：根据需求调整Kops集群的区域、节点数量、实例规格等参数。

部署示例

Gitlab CI流水线示例（.gitlab-ci.yml片段）

yaml
deploy_k8s_cluster:
  image: vlaszaty/gitlab-ci-kops-tf
  stage: deploy
  variables:
    AWS_REGION: us-east-1
    CLUSTER_NAME: my-k8s-cluster.example.com
    S3_STATE_BUCKET: my-kops-state-bucket
  script:
    # 配置AWS凭证
    - aws configure set aws_access_key_id $AWS_ACCESS_KEY_ID
    - aws configure set aws_secret_access_key $AWS_SECRET_ACCESS_KEY
    - aws configure set region $AWS_REGION
    # Terraform前置资源配置
    - cd terraform && terraform init && terraform apply -auto-approve
    # Kops创建集群
    - kops create cluster --name=$CLUSTER_NAME --state=s3://$S3_STATE_BUCKET --zones=${AWS_REGION}a --node-count=2 --node-size=t2.micro --master-size=t2.micro
    - kops update cluster --name=$CLUSTER_NAME --state=s3://$S3_STATE_BUCKET --yes
    # 验证集群状态
    - kops validate cluster --name=$CLUSTER_NAME --state=s3://$S3_STATE_BUCKET

Docker Run示例

bash
docker run --rm \
  -e AWS_ACCESS_KEY_ID=your_aws_key \
  -e AWS_SECRET_ACCESS_KEY=your_aws_secret \
  -e AWS_REGION=us-east-1 \
  vlaszaty/gitlab-ci-kops-tf \
  kops create cluster --name=my-cluster.example.com --state=s3://my-kops-state-bucket --zones=us-east-1a --node-count=2