文档首页/ 云容器引擎 CCE/ 最佳实践/ Terraform/ 安装Terraform并配置华为云Provider
更新时间:2026-08-17 GMT+08:00

安装Terraform并配置华为云Provider

Terraform是一个开源的基础设施即代码(IaC)工具,通过HCL(HashiCorp Configuration Language)声明式地描述云上资源的目标状态。执行后,Terraform会自动生成执行计划,确认后完成资源的创建与编排,实现标准化的自动化资源管理。

本文档介绍如何安装Terraform并配置华为云Provider,为后续通过Terraform管理CCE资源做好环境准备。

前提条件

  • 已准备一台可以连接公网的机器。
  • 已获取华为云账号AK/SK,且账号具有创建并修改CCE集群的权限,详情请参见访问密钥

操作步骤

步骤一:安装Terraform

Terraform官方网站获取安装方式。Terraform支持Linux、macOS、Windows等多个操作系统,您可以根据操作系统下载对应的安装包。本文以amd64架构Linux操作系统下安装Terraform二进制文件为例,版本号仅为示例,请根据实际需要选择对应版本。

  1. 访问Terraform,下载Terraform二进制包。

    wget https://releases.hashicorp.com/terraform/1.15.7/terraform_1.15.7_linux_amd64.zip

  2. 解压并将二进制文件添加到PATH目录下。

    unzip terraform_1.15.7_linux_amd64.zip -d ./terraform
    cp -a ./terraform/terraform /usr/local/bin/

  3. 验证安装结果。

    terraform version

    返回Terraform版本号则表示安装成功。

步骤二:创建项目目录

执行以下命令,目录名可自定义。

mkdir terraform_hw_demo
cd ./terraform_hw_demo

步骤三:导入华为云认证信息并初始化Provider

  1. 在操作系统中配置环境变量。
    # 必选配置
    export HW_ACCESS_KEY="ak"                 # AK
    export HW_SECRET_KEY="sk"                 # SK
    export HW_REGION_NAME="cn-north-4"        # 局点名称,如北京四为:cn-north-4
    
    # 可选配置
    export HW_ENTERPRISE_PROJECT_ID="eps_id"  # 企业项目ID,开通企业管理功能后默认值为"0"
    export HW_DOMAIN_NAME="domain_name"       # 账号名(跨账号操作时配置)

    涉及参数说明如下表所示。

    参数

    是否必填

    说明

    HW_ACCESS_KEY

    访问密钥ID(AK)。

    用于标识调用者身份。获取方法请参见访问密钥

    HW_SECRET_KEY

    访问密钥(SK)。

    与AK成对使用,用于请求签名与身份鉴权。获取方法请参见访问密钥

    HW_REGION_NAME

    区域(Region)。

    指定Terraform将要管理的资源所属区域。区域需与待创建资源的物理数据中心保持一致,否则将导致资源创建失败。

    HW_ENTERPRISE_PROJECT_ID

    企业项目ID。

    用于资源的企业项目管理。若账号已开通企业管理功能但未指定该参数,默认值为“0”(default企业项目)。若未开通该功能,可忽略此参数。

    HW_DOMAIN_NAME

    账号名(IAM Domain Name)。

    适用于多账号或企业联邦认证场景,用于指定IAM所属账号。普通单账号场景下通常无需配置。

  2. 在项目目录下,创建init.tf文件,指定华为云Provider的registry源和版本。
    terraform {
      required_providers {
        huaweicloud = {
          source  = "huaweicloud/huaweicloud"
          version = ">= 1.94.0"  # 加载不低于1.94.0版本的最新Provider,该配置对本地Provider仍有效
        }
      }
    }

步骤四:初始化Terraform模块

terraform init

首次执行时会下载HuaweiCloud Provider并安装,回显如下表示初始化成功。