providus/tfenv

tfenv 2.2.3 Docker镜像文档

镜像概述

本镜像基于debian11-slim构建，内置tfenv 2.2.3版本，专为CI（持续集成）环境优化。tfenv是一款Terraform版本管理工具，可帮助用户轻松安装、切换和管理不同版本的Terraform，满足多项目对不同Terraform版本的需求。

核心功能与特性

• 版本管理：支持安装、卸载、切换多个Terraform版本
• 轻量级基础：基于debian11-slim，镜像体积小，启动速度快
• CI友好：适合集成到CI/CD流水线，自动化管理Terraform版本
• 兼容性：兼容tfenv 2.2.3的所有原生功能，包括版本列表查询、版本安装验证等

使用场景与适用范围

• CI/CD流水线中需要动态切换Terraform版本的场景
• 多项目并行开发，各项目依赖不同Terraform版本的环境
• 需要标准化Terraform版本管理流程的团队或个人开发者
• 自动化部署流程中对Terraform版本有严格控制要求的场景

使用方法与配置说明

基本使用（docker run示例）

bash
# 查看tfenv版本
docker run --rm tfenv:2.2.3-debian11-slim tfenv --version

# 列出可用的Terraform版本
docker run --rm tfenv:2.2.3-debian11-slim tfenv list-remote

# 安装特定版本的Terraform（例如1.6.0）
docker run --rm tfenv:2.2.3-debian11-slim tfenv install 1.6.0

# 设置全局默认Terraform版本
docker run --rm -v $(pwd):/workspace tfenv:2.2.3-debian11-slim bash -c "tfenv install 1.6.0 && tfenv use 1.6.0 && terraform --version"

在CI流水线中使用

在GitLab CI/CD中的.gitlab-ci.yml示例：

yaml
stages:
  - terraform-check

terraform-validate:
  stage: terraform-check
  image: tfenv:2.2.3-debian11-slim
  script:
    - tfenv install 1.6.0  # 安装指定版本
    - tfenv use 1.6.0      # 切换到安装的版本
    - terraform init       # 初始化Terraform项目
    - terraform validate   # 验证配置文件

数据持久化

如需在多次运行中保留已安装的Terraform版本，可挂载tfenv数据目录：

bash
docker run --rm -v /path/to/local/tfenv:/root/.tfenv tfenv:2.2.3-debian11-slim tfenv install 1.6.0

注意事项

• 首次使用时，tfenv需要从网络下载Terraform版本，确保CI环境有网络访问权限
• 挂载目录时需确保本地目录权限正确，避免权限问题导致安装失败
• 支持的Terraform版本列表可通过tfenv list-remote命令查询