用于配置Freebox xDSL/FTTH调制解调器的Terraform提供程序
项目描述
警告:此项目处于早期阶段;你可能不应该使用它。
terraform-provider-freebox 是一个 Terraform (0.12) 提供程序,用于配置 Freeboxes(法国ISP Free 提供的 xDSL/FTTH 调制解调器)。
此调制解调器提供了用于 NAT 配置、端口转发、静态 DHCP 租赁等的 配置GUI,以及具有相同功能的 配置API(GUI使用API)。
此提供程序使用相同的API,让您可以通过Terraform的 IaC 方法配置您的Freebox。
它根据 MIT许可证 许可。它可在 Python包索引 上找到。其 文档 和其 源代码 在GitHub上。
有疑问?意见?错误?想贡献? 打开问题!
快速入门
安装
从PyPI安装
$ pip install terraform-provider-freebox
配置
Freebox提供的配置API使用一个 令牌 进行身份验证。
您首先需要获取一个令牌(您只需这样做一次)。运行以下命令并遵循其说明。您需要点击Freebox的触摸显示屏。
$ terraform-provider-freebox create-token
创建令牌后,它将为您提供一个 提供者 部分,您可以将其复制粘贴到 Terraform 配置文件中。它应该看起来像
provider freebox { app_id = "terraform" app_token = "9m2KFLflttfuk1h52aiQvna@LWwk%02qPN4Ah3euZpT7YjP!lekb1MmfWR9qL50r" }
您负责保持此令牌的安全。如果您丢失了它,您将不得不创建一个新的。
您负责保持此令牌的秘密。心怀恶意的人可能会用它来黑客您的网络和设备。
权限设置
@todo 解释为什么必须手动添加权限。@todo 描述如何添加权限。@todo 列出必须为每个数据源和资源添加的权限。
第一次测试:获取您的公共IP地址
将以下内容添加到您的 Terraform 配置中
data freebox_connection_status connection_status {} output connection_ipv4 { value = data.freebox_connection_status.connection_status.ipv4 }
然后运行 terraform init
和 terraform plan
。后者应显示类似以下内容
Apply complete! Resources: 0 added, 0 changed, 0 destroyed. Outputs: connection_ipv4 = 82.65.16.120
数据源
freebox_connection_status
调用 GET /api/v4/connection/
并返回在 ConnectionStatus 中描述的属性。
项目详情
terraform-provider-freebox-0.0.2.tar.gz 的哈希
算法 | 哈希摘要 | |
---|---|---|
SHA256 | 2bbe4b92ca4714ab1dc7b8080b160bcebde1362bc1fc376a4d3cc3275ec476ed |
|
MD5 | 6f0b952465348192a9f2527a4b0eaa0c |
|
BLAKE2b-256 | a6c5fe6820213e792dd819d8fffae51e3dfdf6ce1fdc12da1915a10a8cde1b90 |