Ga naar inhoud

Naamgeving en tags

Namen die het platform aanmaakt

Onderdeel Patroon
Subscription De naam uit de spoke-aanvraag, of het naming template van het platform (bijvoorbeeld sub-<workload>-<env>)
Spoke resource group rg-canvas-<workload>-<env>-<region>-001 (kan worden overschreven in de spoke JSON)
Spoke service principal SPN-SPOKE-<workload>-<env>
VNet, subnets, NSG's De namen uit je aanvraag. De placeholders ##wlshortname##, ##environment##, ##region## worden vervangen.
Spoke-groepen Uit het naming template van het platform
Azure DevOps-repository en service connection (optioneel) Ingesteld in het azdo-blok van de spoke JSON, met dezelfde placeholders (Spoke JSON-referentie)

De korte naam van de workload (max. 6 tekens) en de omgeving maken deel uit van al deze namen en van de state van het platform. Ze kunnen daarna niet meer wijzigen (Beperkingen).

Namen voor je eigen resources

Gebruik een consistente conventie in je workload. Een veelgebruikte conventie volgt het Microsoft Cloud Adoption Framework:

<resource type>-<workload or identifier>-<environment>-<region>-<instance>, bijvoorbeeld rg-app1-prd-weu-001.

Onderdeel Betekenis Voorbeelden
Resourcetype Afkorting van het resourcetype rg, vnet, vm, log, kv, st
Workload / identifier Je applicatie of service invprt, app1
Omgeving Fase in de levenscyclus dev, tst, acc, prd
Regio Korte regiocode weu, neu
Instantie Teller 001

Belangrijke punten:

  • Namen van Key Vault en storage accounts hebben strikte limieten: maximaal 24 tekens, en storage accounts staan geen koppeltekens toe. Laat de scheidingstekens hiervoor weg (bijvoorbeeld kvinvprtprdweu001, stinvprtprdweu001).
  • Gebruik binnen één workload dezelfde conventie. Moet je afwijken, leg de reden dan vast in de workload.
  • De eigen conventie van je organisatie gaat voor. Vraag het platformteam of er een verplicht is en of een policy die afdwingt.
  • Heeft een workload een andere conventie nodig, behoud dan alle vijf de onderdelen, wijk zo weinig mogelijk af, blijf consistent binnen de workload (één conventie, niet meerdere) en leg de afwijking en de reden vast in de workload.
  • Geef afhankelijke resources de naam van hun parent, zodat ze bij elkaar blijven: een netwerkinterface nic-<vm name>, een OS-disk dsk-os-<vm name>, een datadisk dsk-data-<vm name>-<n>.
  • In Terraform kun je namen vanuit één conventie genereren met de publieke Azure naming module.

Omgevings- en regiocodes

Gebruik korte, vaste codes, zodat namen kort blijven en goed sorteren. Een veelgebruikte set:

Omgeving Code
Productie prd
Acceptatie acc
Test tst
Ontwikkeling dev
Regio Code
West Europe weu
North Europe neu

De korte namen van de regio's van het platform komen uit je configuratie (active_regions). Gebruik dezelfde codes voor je eigen resources. Sommige resources zijn niet aan een regio gebonden (een subscription bijvoorbeeld): laat de regio daarbij weg.

Naamlimieten waar je tegenaan loopt

De meest voorkomende limieten. Controleer Microsoft Learn voor de actuele regels van elk resourcetype.

Resource Lengte Tekens Gevolg
Storage account 3-24 Alleen kleine letters en cijfers Geen koppeltekens
Key Vault 3-24 Letters, cijfers en koppeltekens Laat de scheidingstekens weg bij langere namen
Container registry 5-50 Alleen letters en cijfers Geen koppeltekens
Resource group 1-90 Letters, cijfers, koppeltekens, underscores
Log Analytics workspace 4-63 Letters, cijfers, koppeltekens
Virtual network 2-64 Letters, cijfers, koppeltekens, underscores

Omdat de regiocode en het instantienummer ruimte innemen, houdt een korte workloadnaam de namen van 24 tekens haalbaar.

Tags

Tags zijn verplicht op de subscription en de platformresources, en worden gebruikt voor kostentoewijzing en eigenaarschap.

Tag Betekenis Wie stelt hem in
owner Het verantwoordelijke team Jij levert aan, het platform past toe vanuit de spoke JSON
department Verantwoordelijke afdeling Jij levert aan
workload De workload Jij levert aan
pii yes of no: persoonsgegevens Jij levert aan
costcentre Wie betaalt Jij levert aan
environment dev, tst, acc, prd Jij levert aan

Voeg ook tags toe aan je eigen resources, zodat kosten en eigenaarschap zichtbaar blijven, minimaal dezelfde set. Je platform kan een policy toevoegen die tags verplicht stelt of overerft (controleer Policy → Assignments), en sommige organisaties voegen meer tags toe (bijvoorbeeld contactadres, dataclassificatie, bedrijfskritikaliteit).

Waarom tags

Gebruik Voorbeeld
Kostentoewijzing en optimalisatie Kosten toewijzen aan een afdeling, project of kostenplaats; zien wat te optimaliseren is
Eigenaarschap en levenscyclus Weten wie verantwoordelijk is en wanneer een resource moet eindigen
Security en compliance Gevoeligheid markeren en welke eisen gelden, voor audits
Automatisering Policies en monitoringregels die op tags reageren (zie Monitoringregels)
Zoeken en rapportage Filteren in de portal, rapporten per team maken

Uitgebreide tagset (optioneel)

Sommige organisaties voegen meer tags toe. Dit zijn voorbeelden, gegroepeerd naar doel. Welke verplicht zijn en hoe ze worden afgedwongen, bepaalt de tagpolicy van je platform.

Groep Tag Betekenis
Accounting approver, budgetamount, costcentre, startdate, enddate Wie kosten goedkeurt, het budget, wie betaalt, geplande start en einde van de workload
Partnership owner, requester, stakeholders, businessowner, technicalowner, financialowner De mensen die met de workload te maken hebben of erdoor geraakt worden
Classificatie businesscriticality, serviceclass, confidentiality, integrity, availability, rpo, rto, mtpd Hoe belangrijk de workload is, welk supportniveau hij krijgt, de classificatie (Securityclassificatie)
Functioneel landingzonetype, applicationname, tier, environment Waarvoor de resource dient en waar hij draait

Gebruik een service class (bijvoorbeeld Dev, Bronze, Silver, Gold) om aan te geven welk supportniveau voor een subscription geldt. Gebruik business criticality (bijvoorbeeld Mission critical, Critical, Essential) voor de impact. Kies één set waarden voor de organisatie en leg die vast.

Tag-overerving: tags op de subscription staan niet automatisch op de resources erin. Als je organisatie tags op resources verplicht stelt, regelt een policy die ze overerft of verplicht dat (controleer Policy → Assignments).

Vraag een tagwijziging aan via Hoe wijzig je als het eigenaarschap of de kostenplaats verandert.