Skapa ett funktionsnamnutrymme

För att skapa ett funktionsnamnutrymme behöver du functions/write i resursgruppen; rollerna Owner, Contributor och Functions Operator har den.

Öppna guiden

Öppna Funktioner i sidomenyn i portalen på https://portal.example.com. Sidan listar dina Funktionsnamnutrymmen; välj Skapa Funktionsnamnutrymmen. Guiden Skapa ett nytt funktionsnamnutrymme har fem steg.

Grundkonfiguration

• Namn på funktionsnamnutrymme — 3 till 253 tecken: gemener, siffror och bindestreck, och det får inte börja eller sluta med bindestreck. Håll det till högst 55 tecken. Plattformen döper namnutrymmets proxy till fnproxy-<name>, och Kubernetes avvisar det namnet när det är längre än 63 tecken: ett längre namn på namnutrymmet godtas och namnutrymmet visar till och med Ready, men det får ingen proxy och ingen av dess funktioner går att nå.
• Namnet är också första delen av namnutrymmets värdnamn, <name>.fn.apps.example.com. Inget annat funktionsnamnutrymme i samma kluster får använda det värdnamnet; gör något det avvisas namnutrymmet när du skapar det.
• Boundary, Cluster och Resource group — var namnutrymmet ska ligga. Alla funktioner du lägger till i det körs i samma kluster.

Namnet kan inte ändras senare.

Beräkningsplan

Välj en av funktionernas beräkningsplaner, från Nano (0.1 CPU, 128 MB RAM) till 2XL (8 CPU, 8.0 GB RAM). Standard är förvald. Planer som din boundarys policy inte tillåter visas men går inte att välja.

Viktigt

Planen tillämpas inte i dag. Den sparas inte med namnutrymmet — Översikt visar ingen beräkningsplan — och varje funktion får 0,25 CPU och 256 MiB minne oavsett vilken plan du väljer. För att ge en funktion mer, se Skalning och resurser.

Skalning

• Minsta replikor — 0 till 20. 0, som är standard, låter funktioner skalas ned till noll när de är overksamma.
• Maximala replikor — 1 till 50, och minst lika många som minimum. Standard är 10.
• Avkylningsperiod (sekunder) — 30 till 3600: hur länge en overksam funktion fortsätter att köras innan den skalas ned till noll. Standard är 300.

Viktigt

Värdena sparas som namnutrymmets standardvärden och visas på dess Översikt, men funktionerna använder dem inte i dag: varje ny funktion börjar med minst 0 och högst 10 replikor och en avkylningsperiod på 300 sekunder. Se Skalning och resurser.

Miljövariabler

Lägg till de variabler som alla funktioner i namnutrymmet får. Skriv nyckel och värde under Lägg till ny miljövariabel och välj lägg till-knappen.

• En nyckel är 1 till 100 tecken: versaler, siffror och understreck, och börjar med en bokstav eller ett understreck. Det du skriver görs om till versaler.
• Ett värde är högst 500 tecken.
• En funktions egen variabel med samma namn vinner över namnutrymmets.
• STACKSHIP_AUTH_ENABLED, STACKSHIP_OIDC_ISSUER och STACKSHIP_OIDC_AUDIENCE är reserverade av plattformen och når aldrig en funktion.

Lägg inte autentiseringsuppgifter i miljövariabler: referera till hemligheter i ett valv på funktionen i stället — se Hemligheter och managed identity.

Granska & Skapa

Granska & Skapa sammanfattar namnet, resursgruppen, klustret, beräkningsplanen, skalningen, resursgränserna och miljövariablerna. Skapa namnutrymmet; det dyker upp i listan och är klart när statusen är Ready.

Vad namnutrymmet får

• Värdnamnet <name>.fn.apps.example.com, som betjänas över HTTPS.
• En egen proxy, fnproxy-<name>: en replik som begär 0,1 CPU och 128 MiB minne, oavsett om namnutrymmet har funktioner eller inte. Se Hur en förfrågan når en funktion.
• En managed identity, som delas av alla dess funktioner och ännu inte har några roller — se Hemligheter och managed identity.
• En sida med flikarna Översikt — status, resursgrupp, boundary, kluster, skalningens standardvärden och listan Funktioner — Konfiguration, Operations, Aktivitet och Riskzon. Sidan har ingen flik Access Control: ge personer roller på resursgruppen eller boundaryn — se Behörigheter.

Ändra eller ta bort namnutrymmet

• Konfiguration → Miljövariabler ändrar variablerna som alla funktioner får. Funktioner som körs får ändringen inom ungefär en minut; en funktion som vilar får den nästa gång den distribueras eller någon av dess inställningar sparas.
• Konfiguration → Skalning och Konfiguration → Autentisering innehåller standardvärden som funktionerna inte använder i dag — se Skalning och resurser och Namnutrymmets standardvärden.
• Riskzon tar bort namnutrymmet tillsammans med alla dess funktioner, dess proxy och dess managed identity. Rolltilldelningar som nämnde identiteten tas inte bort med den.

Med CLI:t

stsh functions ns list -g my-resource-group
stsh functions ns get my-namespace -g my-resource-group -o json
stsh functions ns delete my-namespace -g my-resource-group

Nästa steg

• Skapa en funktion