codeship/google-cloud-deployment

Google Cloud部署集成Docker镜像

镜像概述和主要用途

本镜像为Docker容器化的Google Cloud部署集成工具，旨在简化Google Cloud平台的应用部署流程。通过集成Google Cloud CLI（gcloud）及相关部署工具，提供标准化的部署环境，支持与Google Cloud核心服务（如Kubernetes Engine (GKE)、Cloud Run、App Engine、Cloud Functions）的无缝对接，适用于开发团队快速实现部署流程自动化与跨环境一致性管理。

核心功能和特性

• 多部署目标支持：兼容Google Cloud主流服务，包括GKE容器集群、Cloud Run无服务器容器、App Engine应用引擎及Cloud Functions函数计算。
• 完整工具链集成：内置gcloud CLI、kubectl（GKE管理）、docker-credential-gcr（容器镜像推送认证）等核心部署工具，无需额外安装。
• 部署流程自动化：支持通过配置文件（如deploy.yaml）定义部署步骤，自动完成镜像构建、推送、资源配置及服务更新。
• 环境一致性：容器化设计确保部署环境与本地开发/CI环境隔离，避免因依赖差异导致的部署异常。
• 轻量级设计：基于Alpine Linux构建，镜像体积小（约200-300MB），启动速度快，适合集成到CI/CD流水线。

使用场景和适用范围

• 开发团队日常部署：开发人员本地测试或生产环境部署，无需在本地安装完整gcloud工具链。
• CI/CD流水线集成：作为Jenkins、GitLab CI、GitHub Actions等CI/CD系统的部署步骤容器，标准化部署流程。
• 跨团队协作：为不同开发/运维团队提供统一的部署工具链，减少环境配置差异导致的协作成本。
• 多环境部署管理：支持开发、测试、生产等多环境的部署参数隔离与切换。

使用方法和配置说明

基本使用（docker run）

1. 本地测试部署（需挂载GCP认证密钥）

bash
docker run -it \
  -v /path/to/gcp-key.json:/root/gcp-key.json \  # 挂载GCP服务账号密钥文件
  -e GOOGLE_APPLICATION_CREDENTIALS=/root/gcp-key.json \  # 指定密钥路径
  -e GCP_PROJECT_ID=my-gcp-project \  # GCP项目ID
  your-image-name \
  gcloud run deploy my-service --image gcr.io/my-gcp-project/my-image:latest --region us-central1

2. 集成CI/CD流水线（以GitHub Actions为例）

在.github/workflows/deploy.yml中添加步骤：

yaml
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - name: Pull deployment image
        uses: docker/pull-action@v2
        with:
          image: your-image-name
      
      - name: Deploy to Cloud Run
        run: |
          docker run --rm \
            -v ${{ github.workspace }}:/app \  # 挂载项目代码/配置文件
            -e GOOGLE_APPLICATION_CREDENTIALS=/root/gcp-key.json \
            -e GCP_PROJECT_ID=my-gcp-project \
            -v ${{ secrets.GCP_KEY_JSON }}:/root/gcp-key.json \  # 从GitHub Secrets注入密钥
            your-image-name \
            gcloud run deploy my-service --image gcr.io/my-gcp-project/my-image:${{ github.sha }} --region us-central1

环境变量配置

自定义部署配置文件

支持通过挂载外部配置文件（如deploy.yaml）定义部署参数，示例：

yaml
# deploy.yaml
project_id: my-gcp-project
region: europe-west1
target: cloud-run  # 可选值：gke/cloud-run/app-engine/cloud-functions
service_name: my-service
image: gcr.io/my-gcp-project/my-image:latest
env_vars:
  - NAME: APP_ENV
    VALUE: production

通过容器内命令加载配置文件执行部署：

bash
docker run -v /local/deploy.yaml:/app/deploy.yaml your-image-name deploy --config /app/deploy.yaml