跳转到主要内容

用于配置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上。

有疑问?意见?错误?想贡献? 打开问题

https://img.shields.io/github/workflow/status/jacquev6/terraform-provider-freebox/Continuous%20Integration?label=CI&logo=github PyPI PyPI

快速入门

安装

从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 initterraform 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 (7.2 kB 查看哈希)

上传时间

由以下支持