oliver006/drone-cloud-run

Drone Google Cloud Run 部署插件

概述

本镜像为Drone CI/CD平台的插件，旨在实现容器化应用向Google Cloud Run服务的自动化部署。通过与Drone流水线集成，可简化从构建到部署的流程，实现持续部署能力。

核心功能

• 与Drone CI/CD流水线无缝集成，支持部署步骤自动化
• 支持Google Cloud Run服务的创建与更新操作
• 内置GCP身份验证机制，支持通过服务账号密钥进行授权
• 可配置服务名称、容器镜像、部署区域等核心参数
• 支持自定义资源限制（CPU、内存）及环境变量配置

使用场景

• 持续集成流程中，在代码构建完成后自动部署到Google Cloud Run
• 多环境部署（开发、测试、生产）的自动化管理
• 需要快速迭代并部署容器化应用的开发团队
• 基于Drone构建的CI/CD流程中集成Google Cloud Run部署环节

使用方法

前提条件

• 已部署Drone CI/CD平台并配置项目
• 拥有Google Cloud Platform账号及可用项目
• 已创建具备Cloud Run部署权限的GCP服务账号（需包含roles/run.admin和roles/iam.serviceAccountUser权限）
• 服务账号密钥（JSON格式）已存储为Drone秘钥

配置参数

Drone流水线配置示例

在项目根目录的.drone.yml文件中添加部署步骤：

yaml
kind: pipeline
type: docker
name: deploy-to-cloud-run

steps:
  - name: deploy
    image: docker.xuanyuan.run/[插件镜像名称]  # 替换为实际插件镜像地址
    settings:
      gcp_project_id:
        from_secret: gcp_project_id  # 从Drone秘钥中获取
      gcp_service_key:
        from_secret: gcp_service_key  # 从Drone秘钥中获取
      service_name: my-cloud-run-service
      image: ***-gcr.xuanyuan.run/my-gcp-project/my-app:latest
      region: asia-east1
      memory: 512Mi
      cpu: 1
      port: 8080
      env_vars: "DB_HOST=mysql.example.com,LOG_LEVEL=info"
      allow_unauthenticated: true

环境变量配置方式

除通过settings字段配置外，也可通过环境变量传递参数，环境变量名称为参数名的大写形式，例如：

bash
docker run -e GCP_PROJECT_ID=my-project \
  -e GCP_SERVICE_KEY='{"type":"service_account",...}' \
  -e SERVICE_NAME=my-service \
  -e IMAGE=gcr.io/my-project/my-image:latest \
  -e REGION=us-central1 \
  [插件镜像名称]

注意事项

• 确保容器镜像已推送到GCP Container Registry或Artifact Registry，且服务账号具有访问权限
• 区域参数需与GCP项目实际可用区域匹配，可通过gcloud run regions list查看可用区域
• 若启用allow_unauthenticated，需确保服务不需要严格的访问控制
• 服务账号密钥应妥善保管，建议通过Drone秘钥管理功能存储，避免明文暴露