---------------------------------------------------------------------------------------------------------------------------------

1. 创建配置文件

.terraformrc是Terraform CLI的配置文件

plugin_cache_dir  = "$HOME/.terraform.d/terraform-plugin-cache" 
disable_checkpoint = true

• plugin_cache_dir 是插件的缓存目录（此目录需要提前创建不然init报错）
• disable_checkpoint 禁用 需要连接HashiCorp 提供的网络服务的升级和安全公告检查

mkdir -p $HOME/.terraform.d/terraform-plugin-cache

文件创建好了之后， 要通过配置TF_CLI_CONFIG_FILE变量，让TerraformCLI可以加载到配置文件。这个变量的值没有固定配置，而是取决于.terraformrc文件路径。

export TF_CLI_CONFIG_FILE=$HOME/Desktop/terraform/terraform-module-example/.terrafo
rmrc

 --------------------------------------------------------------------------------------------------------------------------------

2. 进行初始化 

插件下载方式有两种：

1. 通过 terraform init 自动下载provider 插件；
2. 登入registry.terraform.io手动到GitHub下载，并按照目录结构存放到plugin_cache_dir;

本次演示先使用terraform init进行操作， 如果手动到registry下载，需要按照目录结构存放；

terraform init
Initializing modules...
- mydns in ../../modules/dns
- myecs in ../../modules/ecs
- myssecgroup in ../../modules/secgroup
- myvpc in ../../modules/vpcInitializing the backend...Initializing provider plugins...
- Finding hashicorp/alicloud versions matching "1.164.0"...
- Installing hashicorp/alicloud v1.164.0...
- Installed hashicorp/alicloud v1.164.0 (signed by HashiCorp)Terraform has created a lock file .terraform.lock.hcl to record the provider
selections it made above. Include this file in your version control repository
so that Terraform can guarantee to make the same selections by default when
you run "terraform init" in the future.

初始化之后， 查看plugin_cache_dir中的内容：
$HOME/.terraform.d/terraform-plugin-cache/registry.terraform.io/hashicorp/alicloud/1.164.0/darwin_arm64

➜  .terraform.d pwd
/Users/lizeyang/.terraform.d➜  .terraform.d tree
.
|____checkpoint_cache
|____checkpoint_signature
|____terraform-plugin-cache
| |____registry.terraform.io
| | |____hashicorp
| | | |____alicloud
| | | | |____1.164.0
| | | | | |____darwin_arm64
| | | | | | |____terraform-provider-alicloud_v1.164.0

三 初始化

terraform init进行联网下载，或者可以进入到registry.terraform.io 手动通过github下载

可以看到在缓存目录下已经成功缓存

3. 模拟断网，离线初始化

方法1：初始化时指定plugin-dir
terraform init --plugin-dir $HOME/.terraform.d/terraform-plugin-cache/

terraform init  --plugin-dir $HOME/.terraform.d/terraform-plugin-cache/
Initializing modules...
- mydns in ../../modules/dns
- myecs in ../../modules/ecs
- myssecgroup in ../../modules/secgroup
- myvpc in ../../modules/vpcInitializing the backend...Initializing provider plugins...
- Finding hashicorp/alicloud versions matching "1.164.0"...
- Using hashicorp/alicloud v1.164.0 from the shared cache directoryTerraform has created a lock file .terraform.lock.hcl to record the provider
selections it made above. Include this file in your version control repository
so that Terraform can guarantee to make the same selections by default when
you run "terraform init" in the future.Terraform has been successfully initialized!

方法2：定义Terraform插件使用本地mirror

provider_installation {filesystem_mirror {path    = "/Users/lizeyang/.terraform.d/terraform-plugin-cache"include = ["registry.terraform.io/*/*"]}
}➜  dev terraform init
Initializing modules...Initializing the backend...Initializing provider plugins...
- Finding hashicorp/alicloud versions matching "1.164.0"...
- Using hashicorp/alicloud v1.164.0 from the shared cache directoryTerraform has created a lock file .terraform.lock.hcl to record the provider
selections it made above. Include this file in your version control repository
so that Terraform can guarantee to make the same selections by default when
you run "terraform init" in the future.Terraform has been successfully initialized!

到此就完成了terraform离线本地源的配置了， 除了这种方式外其实也可以基于terraform开放的HTTP API协议，使用Python Flask写一个registry server。

四 离线测试

4.1 制定plugin-dir

terraform init  --plugin-dir $HOME/.terraform.d/terraform-plugin-cache/

4.2 定义Terraform插件使用本地mirror

在.terraformrc 中添加filesystem_mirror

provider_installation {filesystem_mirror {path    = "/Users/xuel/.terraform.d/terraform-plugin-cache"include = ["registry.terraform.io/*/*"]}
}

$ terraform providers mirror /Users/larry/Software/terraform/plugins
terraform init -plugin-dir=/Users/larry/Software/terraform/plugins

4.3 两者的练习与区别

4.3.1 联系

前两个是相互联系的，因为它们都共享相同的底层机制：“文件系统镜像”插件安装方法。

4.3.2 区别

• 使用terraform init -plugin-dir使Terraform实际上构造了一个one-offprovider_installation块，其中只包含一个引用给定目录的filesystem_mirror块。它允许您仅在一次安装操作中获得这种效果，而不是在中心位置为将来的所有命令配置它。具体而言，如果运行terraform init -plugin-dir=/example，则在功能上等同于以下CLI配置：

provider_installation {filesystem_mirror {path    = "/Users/xuel/.terraform.d/terraform-plugin-cache"include = ["registry.terraform.io/*/*"]}
}

• 插件缓存目录不同，因为Terraform仍将访问配置的安装方法（默认情况下，每个提供商的原始注册表），但如果插件包文件已经在缓存中，则将跳过下载插件包文件（该文件实际上包含插件代码，而不是关于发布的元数据）。同样，它会将下载的任何新插件包保存到缓存中，以备将来使用。

  因此，这不会阻止Terraform尝试通过网络访问原始注册表来安装任何新插件。这只是一个避免重复使用re-downloading相同包的优化。

注意事项

• 注意环境变量TF_CLI_CONFIG_FILE，全局生效添加之.bashrc中。
• 到此就完成了terraform离线本地源的配置了， 除了这种方式外其实也可以基于terraform开放的HTTP API协议，使用Python Flask写一个registry server。
• 如果想要自己手动下载，可以到这个网址：https://releases.hashicorp.com/