sacloud/terraform

Terraform Provider for SakuraCloud镜像概述

本镜像包含Terraform的SakuraCloud提供商组件，用于通过Terraform工具以代码化方式定义、配置和管理SakuraCloud的云资源，助力用户实现基础设施即代码（IaC）的高效管理。

核心功能

• 支持SakuraCloud服务器、磁盘、网络接口等核心资源的配置与管理
• 采用HCL语法定义基础设施，实现版本控制与自动化部署
• 提供多认证方式（如profile配置），保障资源访问安全
• 支持资源生命周期管理（创建、更新、删除）及状态跟踪

使用场景

• 自动化部署SakuraCloud上的应用环境，确保环境一致性
• 团队协作中共享基础设施配置，提升协作效率
• 快速复制或迁移云环境，降低运维成本

配置说明

1. 认证配置：通过profile参数指定认证信息（需提前在本地配置SakuraCloud凭证）
2. 版本固定：建议在provider配置中指定固定版本，避免兼容性问题
3. 资源定义：使用HCL语法描述资源属性，如服务器规格、磁盘来源等

部署示例

Docker运行命令

bash
# 初始化Terraform配置（映射本地工作目录）
docker run --rm -v $(pwd):/workspace -w /workspace docker.xuanyuan.run/sacloud/terraform init

# 生成执行计划
docker run --rm -v $(pwd):/workspace -w /workspace docker.xuanyuan.run/sacloud/terraform plan

# 应用配置（需确认执行）
docker run --rm -v $(pwd):/workspace -w /workspace docker.xuanyuan.run/sacloud/terraform apply

HCL配置示例

hcl
# 配置SakuraCloud Provider
provider "sakuracloud" {
  version = "=2.1.0" # 固定提供商版本
  # profile = "your-sakuracloud-profile" # 可选：指定本地认证profile
}

variable "server_password" {}

# 获取Ubuntu系统镜像
data "sakuracloud_archive" "ubuntu" {
  os_type = "ubuntu"
}

# 创建磁盘资源
resource "sakuracloud_disk" "web_disk" {
  name              = "web-server-disk"
  source_archive_id = data.sakuracloud_archive.ubuntu.id
}

# 创建服务器资源
resource "sakuracloud_server" "web_server" {
  name        = "web-server"
  disks       = [sakuracloud_disk.web_disk.id]
  core        = 1
  memory      = 2
  description = "Web应用服务器"
  tags        = ["app=web", "env=staging"]

  network_interface {
    upstream = "shared"
  }

  disk_edit_parameter {
    hostname = "web-server"
    password = var.server_password
  }
}

许可证

本项目基于Apache 2.0许可证发布，详情请参见LICENSE文件。 ===END===