Стиль коду
- Приклади та модулі Terraform повинні містити документацію, яка пояснює функції та як їх використовувати.
- Усі по силання у файлах README.md мають бути абсолютними, щоб веб-сайт Terraform Registry відображав їх правильно.
- Документація може включати схеми, створені за допомогою mermaid і креслення, створені за допомогою cloudcraft.co.
- Використовуйте Terraform pre-commit hooks щоб переконатися, що код валідний, правильно відформатований і автоматично задокументований, перш ніж запушати його на git і надати для подальшого код рев'ю.
pre-commit - це фреймворк для керування та підтримки багатомовних pre-commit хуків. Він написаний на Python і є потужним інструментом для автоматичного виконання завдань на машині розробника до того, як код буде передано в репозиторій git. Зазвичай він використовується для запуску лінтерів і форматування коду (дивіться підтримувані хуки).
З конфігураціями Terraform
pre-commit
можна використовувати для форматування та п еревірки коду, а також для оновлення документації.Перегляньте pre-commit-terraform repository, щоб ознайомитися з ним та існуючими репозиторіями (наприклад, terraform-aws-vpc), де це вже використовується.
terraform-docs - це інструмент, який створює документацію з модулів Terraform у різних вихідних форматах. Ви можете запускати його вручну (без pre-commit хуків, або ж використовувати pre-commit-terraform hooks, щоб документація оновлювалася автоматично).
@todo: Document module versions, release, GH actions
Last modified 1yr ago