
## 一 背景

Crossplane 和 Terraform 都是用于基础设施自动化编排的工具,使用它们可以实现可重复和可控的基础设施部署。当您同时使用 Crossplane 和 Terraform 时,可以借助 Crossplane 的云原生设计来管理跨云的基础设施资源,同时利用 Terraform 的广泛生态系统和提供者支持来管理特定于云或供应商的资源。

## 二 概述

对于基础设施管理，Crossplane 和 Terraform均有独特的应用场景，Terraform 和 Crossplane 都是强大的基础设施即代码工具，但它们的设计目标和适用场景有所不同。Terraform 适用于管理和部署各种基础设施资源，而 Crossplane 则专注于使用 Kubernetes 平台管理多个云提供商的基础设施服务。以下是它们的异同：

*   范围和生态系统：Terraform 是一个通用的基础设施编排工具，可以管理多种基础设施资源，并拥有庞大的插件生态系统。Crossplane 则专注于跨多个云提供商的云基础设施管理，基于 Kubernetes 平台进行统一的管理。

*   抽象级别：Terraform 提供了更高层次的抽象，可以通过模块化和变量来组织和管理基础设施资源。Crossplane 则更接近云提供商的原生 API，提供更细粒度的控制和定制。

*   声明式规范：Terraform 使用 HCL 或 JSON 等声明式语言来描述基础设施状态和配置。Crossplane 则使用 Kubernetes 自定义资源来定义基础设施资源的规范。

*   可观察性：Terraform 提供了一些命令和工具来查看和管理基础设施状态，但与 Kubernetes 的监控和调试能力相比较，其可观察性支持较为有限。

![](https://developer.qcloudimg.com/http-save/yehe-1137075/b014d42a4d2b7798a8d91b333a341d6b.png#?w=720\&h=867\&s=1876692\&e=png\&b=1c1c1c)

## 三 场景分析

想要利用crossplane整体管控阿里云基础设施资源编排，由于crossplane中阿里的privider对阿里基础设施资源支持有限，terraform对阿里云基础设施资源支持丰富，

*   Terraform 阿里云provider

![](https://developer.qcloudimg.com/http-save/yehe-1137075/6ba59fff6ac5cf97691b513d0c3fb6ff.png#?w=1420\&h=921\&s=207784\&e=png\&a=1\&b=fefefe)

*   crossplane providers对阿里云支持

![](https://developer.qcloudimg.com/http-save/yehe-1137075/6507118a33de597165e411e8e8c37b07.png#?w=921\&h=720\&s=2657565\&e=png\&a=1\&b=1b1b1b)

跨平面编排目标云资源，依赖于供应商，目前阿里的供应商支持NAS、OSS、REDIS、SLB、SLS。但是，单独使用此提供商无法实现对其他云资源的全面控制

![](https://developer.qcloudimg.com/http-save/yehe-1137075/0d2215737b8a620396d19b88c4e17441.png#?w=971\&h=720\&s=2801801\&e=png\&a=1\&b=0a242c)

官方文档中的示例缺乏长期维护，并且随着官方产品的发展而失效。由于没有人维护提供程序，治理变得无效。

## 四 方案



![](https://developer.qcloudimg.com/http-save/yehe-1137075/4868fe9df329094e87eb4768a7a3c171.png#?w=1460\&h=384\&s=312872\&e=png\&a=1\&b=f6f6f6)

方案概述：

*   利用Provider-alibaba管控支持的云资源

*   配合Crossplane+Provider-terraform 覆盖其他阿里云资源管理

发难特点：

*   Crossplane配合Terraform实现全流程基础设施自动化编排
*   无论云资源是否提供 Crossplane 的原生 provider，都可以通过 Provider-Terraform 实现跨云资源管理
*   使用 Terraform 模板作为中间层，统一了云资源的管理接口，简化了跨云平台的配置和操作
*   Crossplane 提供了与 Kubernetes 的集成，可以通过自定义资源进行云资源的声明和管理

需要注意的是，在某些场景中，Terraform和Crossplane可以相互补充。Terraform可用于提供和配置底层基础设施，而Crossplane可用于管理更高级别的抽象，并将基础设施资源与Kubernetes工作负载连接起来。
terraform-provider,提供程序Terraform是一个Crossplane提供程序，可以运行Terraform代码，并可以定义新的Crossplane复合资源(xr)，这些资源由“本地”Crossplane管理资源和现有的Terraform模块混合组成。
Terraform提供程序添加了对代表Terraform工作空间的工作区管理资源的支持。每个工作区的配置可以从远程源(例如git)获取，也可以简单地内联指定。

## 五 实战

### 5.1 环境准备

*   Kind
*   CVM
*   Helm
*   Kubectl
*   Kubernetes
*   阿里云账号
*   terraform

### 5.2 主机及环境准备

```shell
#!/bin/bash

# docker 部署
yum remove docker \
                  docker-client \
                  docker-client-latest \
                  docker-common \
                  docker-latest \
                  docker-latest-logrotate \
                  docker-logrotate \
                  docker-engine
                  
yum install -y yum-utils \
  device-mapper-persistent-data \
  lvm2
yum-config-manager \
    --add-repo \
    https://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo
yum install docker-ce docker-ce-cli containerd.io -y
sudo systemctl start docker
sudo systemctl enable docker

# kubectl部署
curl -LO https://storage.googleapis.com/kubernetes-release/release/v1.18.0/bin/linux/amd64/kubectl &&\
chmod +x ./kubectl &&\
mv ./kubectl /usr/bin/kubectl
kubectl version --client

# 将 k alias 写入系统
echo "alias k=kubectl" >> ~/.bashrc
source ~/.bashrc
source ~/.bashrc



# helm3 部署
curl -LO https://get.helm.sh/helm-v3.14.1-linux-amd64.tar.gz && \
tar -zxvf helm-v3.14.1-linux-amd64.tar.gz && \
mv linux-amd64/helm /usr/bin/helm
helm version


# kind部署
curl -Lo ./kind https://kind.sigs.k8s.io/dl/v0.11.1/kind-linux-amd64 && \
chmod +x ./kind && \
mv ./kind /usr/bin/kind
kind version


# k8s 集群创建
cat >kind-config.yaml<<EOF
kind: Cluster
apiVersion: kind.x-k8s.io/v1alpha4
nodes:
- role: control-plane
- role: worker
- role: worker
EOF

kind create cluster --name crossplane --config kind-config.yaml

kubectl get nodes


# crossplane 创建
helm repo add \
crossplane-stable https://charts.crossplane.io/stable
helm repo update

helm install crossplane \
crossplane-stable/crossplane \
--namespace crossplane-system \
--create-namespace
# 等待helm部署完成
sleep 30
helm list -n crossplane-system


kubectl get all -n crossplane-system
```

### 5.3 实现架构

![](https://developer.qcloudimg.com/http-save/yehe-1137075/0009524f1010304f182588ab7d46a5c6.png#?w=1280\&h=336\&s=287343\&e=png\&a=1\&b=f6f6f6)


### 5.4 provider相关配置

```shell
# terraform provider
apiVersion: pkg.crossplane.io/v1
kind: Provider
metadata:
  name: provider-terraform
spec:
  package: xpkg.upbound.io/upbound/provider-terraform:v0.14.1
  controllerConfigRef:
    name: terraform
  
apiVersion: pkg.crossplane.io/v1alpha1
kind: ControllerConfig
metadata:
  name: terraform
  labels:
    app: crossplane-provider-terraform
spec:
  args:
    - -d
    - --poll=5m
    - --max-reconcile-rate=10
    
apiVersion: tf.upbound.io/v1beta1
kind: ProviderConfig
metadata:
  name: azure-westeurope
spec:
  configuration: |
    terraform {
      required_providers {
        azurerm = {
          source = "hashicorp/azurerm"
          version = "3.78.0"
        }
      }
      required_version = ">= 1.1.0"

      backend "kubernetes" {
        secret_suffix     = "providerconfig-azure-westeurope"
        namespace         = "crossplane-system"
        in_cluster_config = true
      }
      # backend "azurerm" {
      #   resource_group_name  = "StorageAccount-ResourceGroup"
      #   storage_account_name = "abcd1234"
      #   container_name       = "tfstate"
      #   key                  = "prod.terraform.tfstate"
      #   use_msi              = true
      #   subscription_id      = "00000000-0000-0000-0000-000000000000"
      #   tenant_id            = "00000000-0000-0000-0000-000000000000"
      # }

      # backend "azurerm" {
      #   resource_group_name  = "StorageAccount-ResourceGroup"
      #   storage_account_name = "abcd1234"
      #   container_name       = "tfstate"
      #   key                  = "prod.terraform.tfstate"
      # }

    }

    variable "subscriptionId" {
      type = string
    }

    variable "tenantId" {
      type = string
    }

    variable "clientId" {
      type = string
    }

    variable "clientSecret" {
      type = string
    }

    provider "azurerm" {
      subscription_id = var.subscriptionId
      tenant_id = var.tenantId
      client_id = var.clientId
      client_secret = var.clientSecret
      features {}
    }
  credentials:
    - filename: terraform.tfvars.json
      secretRef:
        key: credentials
        name: tf-azure-secret
        namespace: crossplane-system
      source: Secret


```

![](https://developer.qcloudimg.com/http-save/yehe-1137075/dedb18fc842e740035c1eb3e3445cb1d.png#?w=2340\&h=636\&s=206746\&e=png\&a=1\&b=022028)

### 5.5 实现代码

*   ​	实现资源配置

```shell
apiVersion: tf.upbound.io/v1beta1
kind: Workspace
metadata:
  name: tf-az-rg
spec:
  forProvider:
    source: Inline
    module: >
      resource "azurerm_resource_group" "rg" {
        name     = "xuel-test-azurerm"
        location = "westus"
      }
     
  writeConnectionSecretToRef:
    name: terraform-workspace-example-random-generator
    namespace: default
```

![](https://developer.qcloudimg.com/http-save/yehe-1137075/dddf5246c7b122fea39bb6778a16cb0f.png#?w=2954\&h=776\&s=314289\&e=png\&a=1\&b=06202a)

### 5.6 排错

可以登陆进入控制器查看tf执行情况

![](https://developer.qcloudimg.com/http-save/yehe-1137075/5828f33e930adf64fa7f90ad30c83a32.png#?w=2954\&h=970\&s=445356\&e=png\&a=1\&b=022028)

![](https://developer.qcloudimg.com/http-save/yehe-1137075/14d6b285a23be20ccf202c916771cea6.png#?w=1480\&h=222\&s=58609\&e=png\&a=1\&b=08222b)

![](https://developer.qcloudimg.com/http-save/yehe-1137075/86f8c66c8617adc9391c4e7313da97dd.png#?w=1602\&h=320\&s=59325\&e=png\&a=1\&b=fdfdfd)

*   删除资源

![](https://developer.qcloudimg.com/http-save/yehe-1137075/32ce89c7fffdcb5085fe4b1996b98138.png#?w=1956\&h=452\&s=174352\&e=png\&a=1\&b=08222b)

## 六 注意事项

*   由于provider-terraform不支持持久化状态存储，需要使用kubernetes远程状态后端，以确保应用容器/tf目录不回丢失。
*   如果模块运行时间超时（默认20m），底层的terraform进程将被终止，可能丢失状态并泄漏资源，workspace lock将可能留在原地，需要手动删除。
*   providers在成功应用Terraform模块之前不会发出事件，这可能需要很长时间。
*   将——max-reconcile-rate设置为大于1的值可能会导致提供者使用最多相同数量的cpu。在ControllerConfig中添加一个资源部分，以根据需要限制CPU的使用。

## 七 总结

当需要利用crossplane管控的资源没有provider时候，Terraform和Crossplane可以相互补充。Terraform可用于提供和配置底层基础设施，而Crossplane可用于管理更高级别的抽象，并将基础设施资源与Kubernetes工作负载连接起来。当组织采用多云策略时，他们可能需要跨多个云提供商配置和管理基础设施资源。在这个用例中，Terraform可用于跨不同云提供商定义和提供底层基础设施资源，例如虚拟机、网络和存储。Terraform的与云无关的方法允许您编写一次基础架构代码，并将其应用于不同的云。

## 参考链接


*   <https://github.com/upbound/provider-terraform?tab=readme-ov-file>

*   <https://marketplace.upbound.io/providers/upbound/provider-terraform/v0.14.1/docs/configuration>


Crossplane 和 Terraform 都是用于基础设施自动化编排的工具,使用它们可以实现可重复和可控的基础设施部署。当您同时使用 Crossplane 和 Terraform 时,可以借助 Crossplane 的云原生设计来管理跨云的基础设施资源,同时利用 Terraform 的广泛生态系统和提供者支持来管理特定于云或供应商的资源。

实战基于Crossplane+Terraform基础设施自动化编排方案

Devops工程师

云计算

运维

开发工具

Crossplane与Terraform结合实现多云基础设施管理，通过Kubernetes原生方式编排云资源。Terraform提供丰富的云服务支持，Crossplane实现统一管控，两者互补构建自动化运维体系。方案支持阿里云等主流云平台，解决单一工具资源覆盖不足问题。

基础设施即代码

代码解释

Kubernetes

虚拟机

云原生

Terraform

容器

Docker

多云

JSON

2026上云采购 | AI焕新·智启新局

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

实战基于Crossplane+Terraform基础设施自动化编排方案-腾讯云开发者社区-腾讯云

实战基于Crossplane+Terraform基础设施自动化编排方案

实战基于Crossplane+Terraform基础设施自动化编排方案

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐