Przejdź do treści
Biblioteka skilli
DevOps i chmura · Budowanie i kod

terraform-module-design

/terraform-module-design

Projektuje moduły Terraform dla Azure i AWS z typowanymi wejściami, wyjściami i przypiętą wersją, bez bloku dostawcy.

Repozytorium
jstack ↗
Licencja
MIT
Ostatnia zmiana repozytorium
04.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
2
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
1
Przestarzałość

Brak sygnałów. Repozytorium zmienione 04.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Projektuje moduły Terraform dla Azure i AWS z typowanymi wejściami, wyjściami i przypiętą wersją, bez bloku dostawcy.

Oryginalny opis (EN)

Design Terraform modules for Azure and AWS. Use when you add or change a child module: typed inputs and outputs, a pinned registry or git tag, and no provider block inside the module.

Jak działa

  1. Use when
  2. Steps
  3. Safety checks
  4. Rollback
  5. Done when
Sekcje z nagłówków SKILL.md, w oryginale · 98 linii, 756 słów
Podgląd SKILL.md
---
name: terraform-module-design
description: "Design Terraform modules for Azure and AWS. Use when you add or change a child module: typed inputs and outputs, a pinned registry or git tag, and no provider block inside the module."
license: MIT
---

# Module design

Build small modules and pin every published version. The root module configures providers. A child module does not.

## Use when

- You add a module that Azure or AWS stacks will call.
- You change inputs, outputs or the version a caller pins.
- A child module contains a `provider` block or a `source` that tracks a branch.

## Steps

1. Split by concern. One module owns the network, another the data store, another the workload identity. The root module composes them. Pass outputs through the root. A network module does not call the database module.
2. Give every variable a `type` and a `description`. Add `validation` when a bad value would plan the wrong region, SKU or address space. State the meaning and the unit. Do not repeat the variable name as the description.
3. Give every output a `description` and a `value`. Set `sensitive` only when the value must stay out of logs. Do not output an access key, a storage account key or a client secret. Callers authenticate with OIDC or workload identity federation. See `principle-no-static-credentials`.
4. Show the contract in the module. Reject a variable that has no type or no description.

   ```hcl
   variable "location" {
     type        = string
     description = "Azure region for resources this module creates."

     validation {
       condition     = contains(["westeurope", "eastus"], var.location)
       error_message = "location must be westeurope or eastus."
     }
   }

   output "resource_group_id" {
     description = "Resource id of the group this module creates."
     value       = azurerm_resource_group.this.id
   }
   ```

5. Pin Terraform and the provider to the release that was reviewed. A child module includes `required_providers` and does not include a `provider` block. An AWS module uses the same block with `hashicorp/aws` and `5.84.0`. Do not use a lower-bound range. It moves on the next `terraform init`.

   ```hcl
   terraform {
     required_version = "1.10.5"

     required_providers {
       azurerm = {
         source  = "hashicorp/azurerm"
         version = "4.14.0"
       }
     }
   }
   ```

6. Put `provider` blocks only in the root module. The root turns on OIDC there. `hashicorp/azurerm` 4.x requires `subscription_id` in that block. Do not set `access_key` or `secret_key` on `aws`. Do not set a client secret on `azurerm`.

   ```hcl
   provider "azurerm" {
     features {}

     subscription_id = "00000000-0000-0000-0000-000000000000"
     use_oidc        = true
   }
   ```

7. A child that needs a second region declares `configuration_aliases` on its `required_providers` entry. The root passes that alias in the module `providers` argument. An alias that exists only inside the child is hidden. Reject it.
8. Publish to a registry or an immutable git tag. Callers pin that exact version. Never overwrite a published version. Never move a tag a caller already uses. A fix is a new version.

   ```hcl
   module "network" {
     source  = "example.com/team/network/azurerm"
     version = "1.4.2"
   }
   ```

   A git source follows the same rule: `git::https://example.com/network.git?ref=v1.4.2`. `ref=main` is not a pin.

9. Keep IAM and RBAC to the actions the module documents. Follow `principle-least-privilege`. A new grant is its own review, not a side effect of a rename.
10. Leave the backend to the root. State is remote and locked. A child that ships a backend forces every caller onto one state key.
11. When the module adds a larger SKU, a second region or a log archive, price it before callers adopt it. See `principle-cost-awareness`.

## Safety checks

- No child module contains a `provider` block, an access key, a storage account key or a client secret.
- Every variable has a type and a description. Every output has a description.
- Callers pin a registry version or a git tag, and that version is still the bytes that were reviewed.
- Pins match the reviewed release. These examples use Terraform `1.10.5`, `hashicorp/azurerm` `4.14.0` and `hashicorp/aws` `5.84.0`.
- Grants list actions and scope. See `principle-least-privilege`.
- The root uses a locked remote backend. Review a saved plan before apply. See `principle-change-safety`.
- Stop before an apply, a merge, or a grant. Follow `principle-stop-at-approval`.

## Rollback

Roll back by pinning the previous module version in the caller and applying a saved plan. Do not republish old bytes over the new version. Follow `principle-rollback-first` before that pin reaches production. If the new version has already been applied, the reverse plan is the previous pin.

## Done when

- Inputs and outputs are typed and described, and validation rejects values that would plan the wrong thing.
- The published version is immutable, and every caller pins it.
- No child module configures a provider or hides an alias.
- A saved plan for a caller shows only the composition change you intended.
Pliki w paczce (2)
  • SKILL.md 5 KB
  • tests/prompts.md 1 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · JayCommit/jstack100MIT
curiositech/windags-skills100Apache-2.0

Migawka bazy z 13.11.2026 · wersja paczki 9bb42a63eefd (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100terraform-registry
    Przeszukuje Terraform Registry przez API JSON: wyszukuje moduły, czyta wejścia, wyjścia i wersje oraz atrybuty zasobów dostawców.
  • 100fai-terraform-module-scaffold
    Tworzy szkielety modułów Terraform ze zmiennymi, wyjściami, regułami walidacji i automatycznymi testami, do infrastruktury wielokrotnego użytku w Azure, AWS lub środowiskach wielochmurowych.
  • 100terraform-aws-modules
    Pomaga tworzyć moduły Terraform dla AWS: moduły wielokrotnego użytku, zarządzanie stanem i dobre praktyki HCL, przy budowie lub przeglądzie infrastruktury.
  • 100terraform-aws-modules
    Pomaga tworzyć moduły Terraform dla AWS: moduły wielokrotnego użytku, zarządzanie stanem i dobre praktyki HCL, przy budowie lub przeglądzie infrastruktury.
  • 100terraform-engineer
    Wdraża infrastrukturę jako kod w Terraform na AWS, Azure lub GCP: moduły, migracje stanu, dostawców i środowiska.
  • 100terraform-module-library
    Buduje wielokrotnego użytku moduły Terraform dla AWS, Azure i GCP, ujednolicając udostępnianie infrastruktury zgodnie z dobrymi praktykami IaC.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.