Terraform Best Practices
Terraform consultingTwitter @antonbabenkoTerraform Weekly
Polski (Polish)
Polski (Polish)
  • Cześć!
  • Kluczowe koncepty
  • Struktura kodu
  • Przykłady kodu
    • Terragrunt
    • Terraform
      • Mała infrastruktura z Terraform
      • Infrastruktura średniej wielkości Terraform
      • Infrastruktura wielkogabarytowa z Terraform
  • Konwencje nazewnictwa
  • Stylizacja kodu
  • FAQ
  • Źródła i dalsze materiały
  • Pisanie konfiguracji Terraform
  • Warsztaty
Powered by GitBook
On this page
  • Dokumentacja
  • Dokumentacja generowana automatycznie
  • terraform-docs
  • Źródła
Export as PDF

Stylizacja kodu

PreviousKonwencje nazewnictwaNextFAQ

Last updated 3 years ago

  • Przykłady i moduły Terraform powinny zawierać dokumentację wyjaśniającą funkcje i sposoby ich używania.

  • Wszystkie linki w plikach README.md powinny być bezwzględne, aby witryna Terraform Registry wyświetlała je poprawnie.

  • Dokumentacja może zawierać schematy stworzone za pomocą i plany stworzone za pomocą .

  • Korzystaj z , aby upewnić się, że kod jest prawidłowy, odpowiednio sformatowany i automatycznie udokumentowany przed przekazaniem go do git'a i sprawdzeniem przez innych.

Dokumentacja

Dokumentacja generowana automatycznie

to framework do zarządzania i utrzymywania różnorodnych narzędzi do sprawdzania kodu przed jego wysłaniem do zdalnego repozytorium. Jest napisanym w Pythonie potężnym narzędziem do automatyzacji żmudnych czynności na maszynie programisty, zanim kod zostanie przekazany do repozytorium git. Zwykle jest używany do uruchamiania linterów i formatowania kodu (zobacz ).

Dzięki konfiguracjom Terraform pre-commit może służyć do formatowania i sprawdzania poprawności kodu, a także do aktualizowania dokumentacji.

Sprawdź . Zapoznaj się z nim oraz istniejącym repozytoriami (np. ), w których jest ono już używane.

terraform-docs

to narzędzie, które generuje dokumentację z modułów Terraform w różnych formatach wyjściowych. Możesz uruchomić go ręcznie (bez pre-commit hooków) lub użyć , aby automatycznie zaktualizować dokumentację.

Źródła

  1. Post napisany przez :

mermaid
cloudcraft.co
pre-commit hooks dla Terraform
pre-commit
supported hooks
repozytorium pre-commit-terraform
terraform-aws-vpc
terraform-docs
pre-commit-terraform
Strona narzędzia pre-commit
Zbiór git hooków dla Terraform
Dean Wilson
pre-commit hooks and terraform - a safety net for your repositories