Op deze pagina

Alle elementen

Een compleet overzicht van alle opmaakelementen die je kunt gebruiken in artikelen — van koppen en tabellen tot diagrammen, callouts en code tabs.

Koppen

Kop 2 gebruik je voor hoofdsecties. Elke h2 verschijnt automatisch in de inhoudsopgave rechts. Hover over een kop om de anchor-link te kopiëren.

Kop 3 — Subonderdelen

Kop 3 groepeert verwante onderwerpen binnen een sectie.

Kop 4 — Extra detail

Gebruik kop 4 spaarzaam, alleen voor extra detailniveau.


Tekst & nadruk

Normale paragraaftekst heeft een regelafstand van 1,75. Vetgedrukte tekst gebruik je voor sleutelbegrippen en termen. Cursieve tekst voor benamingen, titels of lichte nadruk. Inline code voor variabelen, commando’s en bestandsnamen.

Doorgestreepte tekst wordt zo geschreven: verouderde waarde.


Lijsten

Ongesorteerd:

  • Azure Resource Groups

  • Storage Accounts

  • Virtual Networks

    • Subnets
    • Network Security Groups
    • Route Tables

Gesorteerd:

  1. terraform init — haalt providers en modules op
  2. terraform plan — toont wat er gaat veranderen
  3. terraform apply — voert de wijzigingen door

Citaten

Infrastructure as Code betekent dat je infrastructuur net zo behandelt als applicatiecode: versiebeheer, peer reviews en geautomatiseerde deployment.

— HashiCorp


Tabellen

ResourceTypeLocatieSKU
rg-webapp-prodResource GroupWest Europe
st-webapp-prodStorage AccountWest EuropeStandard_LRS
vnet-webapp-prodVirtual NetworkWest Europe
nsg-webapp-prodNSGWest Europe

Code blokken

# Resource group aanmaken
az group create \
  --name rg-webapp-prod \
  --location westeurope

# Overzicht bekijken
az group list --output table
resource "azurerm_resource_group" "example" {
  name     = "rg-webapp-prod"
  location = "West Europe"

  tags = {
    environment = "production"
    project     = "webapp"
  }
}
name: Deploy to Azure
on:
  push:
    branches: [main]

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Azure Login
        uses: azure/login@v1
        with:
          creds: ${{ secrets.AZURE_CREDENTIALS }}
{
  "name": "webapp",
  "version": "1.0.0",
  "scripts": {
    "build": "tsc && vite build",
    "preview": "vite preview"
  }
}

Code tabs

Gebruik tabs als je hetzelfde onderwerp in meerdere talen of tools wilt tonen.

```hcl resource "azurerm_resource_group" "rg" { name = "rg-webapp-prod" location = "West Europe" } ```
```bicep resource rg 'Microsoft.Resources/resourceGroups@2021-04-01' = { name: 'rg-webapp-prod' location: 'westeurope' } ```
```bash az group create \ --name rg-webapp-prod \ --location westeurope ```

Callouts

Er zijn vijf typen callouts beschikbaar.

Tip Gebruik een remote backend voor Terraform state zodat je veilig in een team kunt werken. Azure Blob Storage is de meest gebruikte optie.
Info Terraform slaat de huidige staat van je infrastructuur op in een terraform.tfstate bestand. Dit bestand bevat gevoelige informatie — bewaar het nooit in een publieke repository.
Notitie De volgorde van resources in je .tf bestanden maakt niet uit. Terraform bepaalt zelf de juiste volgorde op basis van afhankelijkheden.
Waarschuwing Sla nooit secrets op in je Terraform-bestanden of git-repository. Gebruik Azure Key Vault of omgevingsvariabelen via een CI/CD-pipeline.
Let op terraform destroy verwijdert alle resources in je state. Voer dit nooit uit in een productie-omgeving zonder expliciete goedkeuring.


Mermaid diagrammen

Diagrammen maak je met de mermaid shortcode. Flowcharts, sequence diagrams en meer worden ondersteund.

flowchart TD
  code\["📝 Code\n(.tf bestanden)"] --> init\["terraform init"]
  init --> plan\["terraform plan"]
  plan --> review{"Review\ngoedgekeurd?"}
  review -->|ja| apply\["terraform apply"]
  review -->|nee| code
  apply --> state\["State opgeslagen\n(Azure Blob)"]
  apply --> infra\["☁️ Azure\nInfrastructuur"]