crossplane/stack-gcp

Crossplane GCP Stack 镜像文档

概述

Crossplane GCP Stack是基于Crossplane的扩展组件，提供对Google Cloud Platform (GCP)资源的声明式管理能力。通过Kubernetes API定义和管理GCP服务（如Compute Engine、Cloud SQL、GKE等），实现基础设施即代码(IaC)与云原生工作流的无缝集成。

核心特性

• 多GCP服务支持：覆盖计算、存储、数据库、网络等核心GCP服务资源的生命周期管理。
• 声明式API：使用Kubernetes自定义资源(CRD)定义GCP资源，支持版本控制、审计和合规检查。
• 自动调和：持续监控资源状态，自动修复配置漂移，确保实际状态与期望状态一致。
• Kubernetes原生集成：与Kubernetes集群深度整合，支持资源依赖管理、污点/容忍和节点亲和性配置。
• 凭证管理：通过Kubernetes Secrets安全管理GCP服务账号凭证，支持细粒度权限控制。

使用场景

• 多云基础设施管理：作为Crossplane生态的一部分，与AWS、Azure等其他云Stack协同，实现统一的多云资源管控。
• 云原生应用部署：在Kubernetes集群内直接定义应用依赖的GCP资源，简化应用与基础设施的协同部署。
• 合规与审计：通过Kubernetes API服务器的审计日志，跟踪GCP资源变更，满足合规性要求。

Docker部署方案示例

前提条件

• 运行中的Kubernetes集群（1.21+版本）
• 已安装Crossplane核心组件（v1.10+）
• GCP服务账号密钥（具备目标资源管理权限）

部署步骤

1. 拉取镜像

   bash
   docker pull crossplane/provider-gcp:v0.37.0  # 替换为目标版本
   

2. 配置GCP凭证 将GCP服务账号密钥创建为Kubernetes Secret：

   bash
   kubectl create secret generic gcp-creds -n crossplane-system \
     --from-file=creds=./gcp-service-account-key.json
   

3. 部署ProviderConfig 创建ProviderConfig资源以关联凭证：

   yaml
   apiVersion: gcp.crossplane.io/v1beta1
   kind: ProviderConfig
   metadata:
     name: default
   spec:
     credentials:
       source: Secret
       secretRef:
         namespace: crossplane-system
         name: gcp-creds
         key: creds
   

4. 部署GCP资源示例 创建Compute Engine实例：

   yaml
   apiVersion: compute.gcp.crossplane.io/v1beta1
   kind: Instance
   metadata:
     name: example-vm
   spec:
     forProvider:
       machineType: n1-standard-1
       zone: us-central1-a
       disks:
         - boot: true
           initializeParams:
             sourceImage: projects/debian-cloud/global/images/debian-11-bullseye-v20230509
       networkInterfaces:
         - network: default
           accessConfig:
             - name: External NAT
     providerConfigRef:
       name: default
   

注意事项

• 镜像版本需与Crossplane核心版本兼容（参考Crossplane官方兼容性矩阵）。
• GCP服务账号需具备目标资源的管理权限（如compute.instances.admin等）。
• 生产环境建议使用私有镜像仓库存储自定义构建的Stack镜像。