4.0 KiB

Raw Permalink Blame History

Terraform Consul Provider 集成指南

本指南说明如何使用Terraform Consul Provider直接从Consul获取Oracle Cloud配置，无需手动保存私钥到临时文件。

集成概述

我们已经将Terraform Consul Provider集成到现有的Terraform配置中，实现了以下功能：

直接从Consul获取Oracle Cloud配置（包括tenancy_ocid、user_ocid、fingerprint和private_key）
自动将从Consul获取的私钥保存到临时文件
使用从Consul获取的配置初始化OCI Provider
支持多个区域（韩国和美国）的配置

配置结构

1. Consul中的配置存储

Oracle Cloud配置存储在Consul的以下路径中：

韩国区域：config/dev/oracle/kr/
- tenancy_ocid
- user_ocid
- fingerprint
- private_key
美国区域：config/dev/oracle/us/
- tenancy_ocid
- user_ocid
- fingerprint
- private_key

2. Terraform配置

Provider配置

# Consul Provider配置
provider "consul" {
  address    = "localhost:8500"
  scheme     = "http"
  datacenter = "dc1"
}

数据源配置

# 从Consul获取Oracle Cloud配置
data "consul_keys" "oracle_config" {
  key {
    name = "tenancy_ocid"
    path = "config/dev/oracle/kr/tenancy_ocid"
  }
  key {
    name = "user_ocid"
    path = "config/dev/oracle/kr/user_ocid"
  }
  key {
    name = "fingerprint"
    path = "config/dev/oracle/kr/fingerprint"
  }
  key {
    name = "private_key"
    path = "config/dev/oracle/kr/private_key"
  }
}

OCI Provider配置

# 使用从Consul获取的配置的OCI Provider
provider "oci" {
  tenancy_ocid     = data.consul_keys.oracle_config.var.tenancy_ocid
  user_ocid        = data.consul_keys.oracle_config.var.user_ocid
  fingerprint      = data.consul_keys.oracle_config.var.fingerprint
  private_key      = file(var.oci_config.private_key_path)
  region           = "ap-chuncheon-1"
}

使用方法

1. 确保Consul正在运行

# 检查Consul是否运行
pgrep consul

2. 确保Oracle Cloud配置已存储在Consul中

# 检查韩国区域配置
consul kv get config/dev/oracle/kr/tenancy_ocid
consul kv get config/dev/oracle/kr/user_ocid
consul kv get config/dev/oracle/kr/fingerprint
consul kv get config/dev/oracle/kr/private_key

# 检查美国区域配置
consul kv get config/dev/oracle/us/tenancy_ocid
consul kv get config/dev/oracle/us/user_ocid
consul kv get config/dev/oracle/us/fingerprint
consul kv get config/dev/oracle/us/private_key

3. 初始化Terraform

cd /root/mgmt/tofu/environments/dev
terraform init -upgrade

4. 运行测试脚本

# 从项目根目录运行
/root/mgmt/test_consul_provider.sh

5. 使用Consul配置运行Terraform

cd /root/mgmt/tofu/environments/dev
terraform plan -var-file=consul.tfvars
terraform apply -var-file=consul.tfvars

优势

使用Consul Provider直接从Consul获取配置有以下优势：

更高的安全性：私钥不再需要存储在磁盘上的临时文件中，而是直接从Consul获取并在内存中使用
更简洁的配置：无需手动创建临时文件，Terraform直接处理私钥内容
声明式风格：完全符合Terraform的声明式配置风格
更好的维护性：配置集中存储在Consul中，便于管理和更新
多环境支持：可以轻松支持多个环境（dev、staging、production）的配置

故障排除

1. Consul连接问题

如果无法连接到Consul，请检查：

Consul服务是否正在运行
Consul地址和端口是否正确（默认为localhost:8500）
网络连接是否正常

2. 配置获取问题

如果无法从Consul获取配置，请检查：

配置是否已正确存储在Consul中
路径是否正确
权限是否足够

3. Terraform初始化问题

如果Terraform初始化失败，请检查：

Terraform版本是否符合要求（>=1.6）
网络连接是否正常
Provider源是否可访问

版本信息

Terraform: >=1.6
Consul Provider: ~2.22.0
OCI Provider: ~5.0

4.0 KiB Raw Permalink Blame History Unescape Escape