Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/alflag-team/terraform-dns


https://github.com/alflag-team/terraform-dns

cloudflare cloudflare-dns dns terraform

Last synced: about 1 month ago
JSON representation

Awesome Lists containing this project

README

        

# dns

DNS に関する Terraform のコードを管理するリポジトリです。

## ディレクトリ構成

```plain
-- README.md
-- main.tf
-- provider.tf
-- variables.tf
-- versions.tf
-- modules/
--
-- .terraform-docs.yml
-- header.md
-- main.tf
-- outputs.tf
-- variables.tf
-- versions.tf
-- ...
```

## terraform ドキュメントの生成

terraform-docs を使ってドキュメントを生成しています。

モジュールを作る場合、以下のファイルを作成する必要があります。

- `zones//header.md`: ヘッダーに表示する情報

```markdown
# Title

This zone is ...
```

- `zones//.terraform-docs.yml`: ドキュメントの設定ファイル

```yaml
formatter: markdown table
header-from: header.md
output:
file: README.md
mode: inject
template: |-

{{ .Content }}

```

### ドキュメントの生成

以下のコマンドでドキュメントを生成できます。

```bash
terraform-docs zones//
```