Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Bicep-resourcedefinitie
Het resourcetype sessionPools kan worden geïmplementeerd met bewerkingen die zijn gericht op:
- Resourcegroepen - Zie opdrachten voor de implementatie van resourcegroepen
Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.
Resource-indeling
Als u een Microsoft.App/sessionPools resource wilt maken, voegt u de volgende Bicep toe aan uw sjabloon.
resource symbolicname 'Microsoft.App/sessionPools@2025-02-02-preview' = {
identity: {
type: 'string'
userAssignedIdentities: {
{customized property}: {}
}
}
location: 'string'
name: 'string'
properties: {
containerType: 'string'
customContainerTemplate: {
containers: [
{
args: [
'string'
]
command: [
'string'
]
env: [
{
name: 'string'
secretRef: 'string'
value: 'string'
}
]
image: 'string'
name: 'string'
probes: [
{
failureThreshold: int
httpGet: {
host: 'string'
httpHeaders: [
{
name: 'string'
value: 'string'
}
]
path: 'string'
port: int
scheme: 'string'
}
initialDelaySeconds: int
periodSeconds: int
successThreshold: int
tcpSocket: {
host: 'string'
port: int
}
terminationGracePeriodSeconds: int
timeoutSeconds: int
type: 'string'
}
]
resources: {
cpu: int
memory: 'string'
}
}
]
ingress: {
targetPort: int
}
registryCredentials: {
identity: 'string'
passwordSecretRef: 'string'
server: 'string'
username: 'string'
}
}
dynamicPoolConfiguration: {
lifecycleConfiguration: {
cooldownPeriodInSeconds: int
lifecycleType: 'string'
maxAlivePeriodInSeconds: int
}
}
environmentId: 'string'
managedIdentitySettings: [
{
identity: 'string'
lifecycle: 'string'
}
]
poolManagementType: 'string'
scaleConfiguration: {
maxConcurrentSessions: int
readySessionInstances: int
}
secrets: [
{
name: 'string'
value: 'string'
}
]
sessionNetworkConfiguration: {
status: 'string'
}
}
tags: {
{customized property}: 'string'
}
}
Eigenschapswaarden
CustomContainerTemplate
| Naam | Beschrijving | Waarde |
|---|---|---|
| Containers | Lijst met containerdefinities voor de sessies van de sessiegroep. | SessionContainer |
| toegang | Configuratie van toegangsbeheerobject voor sessiegroepen. | SessieIngress |
| registerReferenties | Referenties voor privécontainerregisters voor containers die worden gebruikt door de sessies van de sessiegroep. | SessionRegistryCredentials |
DynamicPoolConfiguration
| Naam | Beschrijving | Waarde |
|---|---|---|
| levenscyclusConfiguratie | De levenscyclusconfiguratie van een sessie in de dynamische sessiegroep | LifecycleConfiguration- |
Omgevingsvariabele
| Naam | Beschrijving | Waarde |
|---|---|---|
| naam | Naam van omgevingsvariabele. | touw |
| geheimRef | Naam van het container-app-geheim waaruit de waarde van de omgevingsvariabele moet worden opgehaald. | touw |
| waarde | Niet-geheime omgevingsvariabelewaarde. | touw |
LevenscyclusConfiguratie
| Naam | Beschrijving | Waarde |
|---|---|---|
| afkoelperiodeInseconden | De afkoelperiode van een sessie in seconden wanneer het levenscyclustype 'Getimed' is. | int (integer) |
| levenscyclusType | Het levenscyclustype van de sessiegroep. | 'OnContainerExit' 'Getimed' |
| maxAlivePeriodInSeconds | De maximale levensduur van een sessie in seconden wanneer het levenscyclustype 'OnContainerExit' is. | int (integer) |
Beheerde identiteit instellen
| Naam | Beschrijving | Waarde |
|---|---|---|
| identiteit | De resource-id van een door de gebruiker toegewezen beheerde identiteit die is toegewezen aan de sessiegroep of 'systeem' voor door het systeem toegewezen identiteit. | tekenreeks (vereist) |
| levenscyclus | Gebruik deze optie om de levenscyclusfasen van een sessiegroep te selecteren waarin de beheerde identiteit beschikbaar moet zijn. | 'Alles' 'Init' 'Hoofd' 'Geen' |
Beheerde ServiceIdentity
| Naam | Beschrijving | Waarde |
|---|---|---|
| soort | Type beheerde service-identiteit (waarbij zowel SystemAssigned- als UserAssigned-typen zijn toegestaan). | 'Geen' 'Systeem toegewezen' 'SystemAssigned, UserAssigned' UserAssigned (vereist) |
| gebruikers-toegewezen identiteiten | De set door de gebruiker toegewezen identiteiten die aan de resource zijn gekoppeld. De woordenlijstsleutels userAssignedIdentities zijn ARM-resource-id's in de vorm: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. De waarden van de woordenlijst kunnen lege objecten ({}) zijn in aanvragen. | UserAssignedId-entiteiten |
Microsoft.App/sessionPools
| Naam | Beschrijving | Waarde |
|---|---|---|
| identiteit | Beheerde identiteiten die nodig zijn voor een sessiegroep om te communiceren met andere Azure-services om geen geheimen of referenties in code te onderhouden. | ManagedServiceIdentity- |
| locatie | De geografische locatie waar de resource zich bevindt | tekenreeks (vereist) |
| naam | De resourcenaam | snaar Beperkingen: Minimale lengte = 3 Maximale lengte = 63 Patroon = ^[a-z][a-z0-9]*$ (vereist) |
| eigenschappen | Resourcespecifieke eigenschappen van container-app-sessiegroep | SessionPoolProperties- |
| etiketten | Resourcetags | Woordenlijst met tagnamen en -waarden. Zie Tags in sjablonen |
Schaal Configuratie
| Naam | Beschrijving | Waarde |
|---|---|---|
| maxConcurrentSessions | Het maximumaantal sessies tegelijk. | int (integer) |
| readySessionInstances | Het minimumaantal gereede sessie-exemplaren. | int (integer) |
SessionContainer
| Naam | Beschrijving | Waarde |
|---|---|---|
| Args | Opdrachtargumenten voor het starten van de container. | Snaar[] |
| opdracht | Startopdracht container. | Snaar[] |
| Env | Omgevingsvariabelen voor containers. | MilieuVar |
| afbeelding | Tag containerinstallatiekopieën. | touw |
| naam | Aangepaste containernaam. | touw |
| Sondes | Lijst met tests voor de container. | Sessiesonde |
| hulpmiddelen | Vereisten voor containerresources. | SessionContainerResources |
SessionContainerResources
| Naam | Beschrijving | Waarde |
|---|---|---|
| CPU | Vereiste CPU in kernen, bijvoorbeeld 0,5 | int (integer) |
| geheugen | Vereist geheugen, bijvoorbeeld '250 Mb' | touw |
SessieIngress
| Naam | Beschrijving | Waarde |
|---|---|---|
| Doelpoort | Doelpoort in containers voor verkeer van inkomend verkeer | int (integer) |
SessionNetworkConfiguration
| Naam | Beschrijving | Waarde |
|---|---|---|
| stand van zaken | Netwerkstatus voor de sessies. | 'Uitgaand uitgeschakeld' 'Uitgaand ingeschakeld' |
SessionPoolEigenschappen
| Naam | Beschrijving | Waarde |
|---|---|---|
| container Type | Het containertype van de sessies. | 'Aangepaste container' 'PythonLTS' |
| aangepasteContainerSjabloon | De configuratie van de aangepaste container als het containerType CustomContainer is. | CustomContainerTemplate- |
| dynamicPoolConfiguration | De poolconfiguratie als het poolManagementType dynamisch is. | DynamicPoolConfiguration- |
| omgeving | Resource-id van de omgeving van de sessiegroep. | touw |
| beheerdeIdentiteitInstellingen | Optionele instellingen voor een beheerde identiteit die is toegewezen aan de sessiegroep. | Beheerde identiteit instelling |
| poolManagementType | Het groepsbeheertype van de sessiegroep. | 'Dynamisch' 'Handmatig' |
| schaalConfiguratie | De schaalconfiguratie van de sessiegroep. | ScaleConfiguration- |
| geheimen | De geheimen van de sessiegroep. | SessionPoolSecret |
| sessionNetworkConfiguration | De netwerkconfiguratie van de sessies in de sessiegroep. | SessionNetworkConfiguration- |
SessionPoolSecret
| Naam | Beschrijving | Waarde |
|---|---|---|
| naam | Geheime naam. | touw |
| waarde | Geheime waarde. | snaar Beperkingen: Gevoelige waarde. Doorgeven als een beveiligde parameter. |
SessieProbe
| Naam | Beschrijving | Waarde |
|---|---|---|
| failureThreshold | Minimale opeenvolgende fouten voor de test die als mislukt worden beschouwd nadat de test is geslaagd. Standaardwaarde is 3. Minimumwaarde is 1. De maximumwaarde is 10. | int (integer) |
| httpOphalen | HTTPGet geeft de http-aanvraag op die moet worden uitgevoerd. | SessionProbeHttpGet |
| initialDelaySeconds | Aantal seconden nadat de container is gestart voordat de liveness-tests worden gestart. Minimumwaarde is 1. De maximumwaarde is 60. | int (integer) |
| periodSeconden | Hoe vaak (in seconden) de test moet worden uitgevoerd. De standaardwaarde is 10 seconden. Minimumwaarde is 1. De maximumwaarde is 240. | int (integer) |
| succesDrempel | Minimale opeenvolgende successen voor de test die als geslaagd worden beschouwd nadat deze is mislukt. De standaardwaarde is 1. Moet 1 zijn voor leven en opstarten. Minimumwaarde is 1. De maximumwaarde is 10. | int (integer) |
| tcpStopcontact | TCPSocket geeft een actie op die betrekking heeft op een TCP-poort. TCP-hooks worden nog niet ondersteund. | SessieProbeTcpSocket |
| beëindigingGracePeriodSeconds | Optionele duur in seconden dat de pod probleemloos moet worden beëindigd bij een testfout. De respijtperiode is de duur in seconden nadat de processen die in de pod worden uitgevoerd, een beëindigingssignaal worden verzonden en de tijd waarop de processen geforceerd worden gestopt met een kill-signaal. Stel deze waarde langer in dan de verwachte opschoontijd voor uw proces. Als deze waarde nil is, wordt de beëindigingGracePeriodSeconds van de pod gebruikt. Anders overschrijft deze waarde de waarde die is opgegeven door de podspecificatie. De waarde moet een niet-negatief geheel getal zijn. De waarde nul geeft aan dat stop onmiddellijk via het kill-signaal (geen kans om af te sluiten) aangeeft. Dit is een alfaveld en vereist het inschakelen van de functiepoort ProbeTerminationGracePeriod. Maximumwaarde is 3600 seconden (1 uur) | int (integer) |
| time-outSeconden | Aantal seconden waarna er een time-out optreedt voor de test. De standaardwaarde is 1 seconde. Minimumwaarde is 1. De maximumwaarde is 240. | int (integer) |
| soort | Geeft het type sonde aan. Kan Liveness of Startup zijn, gereedheidstest wordt niet ondersteund in sessies. Het type moet uniek zijn voor elke sonde binnen de context van een lijst met sondes (SessionProbes). | 'Levendheid' 'Opstarten' |
SessionProbeHttpGet
| Naam | Beschrijving | Waarde |
|---|---|---|
| gastheer | Hostnaam waarmee verbinding moet worden gemaakt, wordt standaard ingesteld op het IP-adres van de pod. U wilt in plaats daarvan 'Host' instellen in httpHeaders. | touw |
| httpHeaders | Aangepaste headers die moeten worden ingesteld in de aanvraag. HTTP staat herhaalde headers toe. | SessionProbeHttpGetHttpHeadersItem |
| pad | Pad naar toegang op de HTTP-server. | touw |
| poort/haven | Naam of nummer van de poort voor toegang tot de container. Getal moet tussen 1 en 65535 liggen. De naam moet een IANA_SVC_NAME zijn. | int (vereist) |
| plan | Schema dat moet worden gebruikt om verbinding te maken met de host. Standaard ingesteld op HTTP. | 'HTTP' 'HTTPS' |
SessionProbeHttpGetHttpHeadersItem
| Naam | Beschrijving | Waarde |
|---|---|---|
| naam | De veldnaam van de koptekst | tekenreeks (vereist) |
| waarde | De waarde van het veld voor de koptekst | tekenreeks (vereist) |
SessieProbeTcpSocket
| Naam | Beschrijving | Waarde |
|---|---|---|
| gastheer | Optioneel: hostnaam waarmee verbinding moet worden gemaakt, wordt standaard ingesteld op het IP-adres van de pod. | touw |
| poort/haven | Nummer of naam van de poort voor toegang tot de container. Getal moet tussen 1 en 65535 liggen. De naam moet een IANA_SVC_NAME zijn. | int (vereist) |
SessionRegistryCredentials
| Naam | Beschrijving | Waarde |
|---|---|---|
| identiteit | Een beheerde identiteit die moet worden gebruikt voor verificatie met Azure Container Registry. Voor door de gebruiker toegewezen identiteiten gebruikt u de volledige door de gebruiker toegewezen id-resource-id. Gebruik 'systeem' voor door het systeem toegewezen identiteiten | touw |
| wachtwoordSecretRef | De naam van het geheim dat het aanmeldingswachtwoord voor het register bevat | touw |
| bedieningscomputer | Container registry-server. | touw |
| gebruikersnaam | Gebruikersnaam van containerregister. | touw |
Gevolgde brontags
| Naam | Beschrijving | Waarde |
|---|
UserAssignedIdentities
| Naam | Beschrijving | Waarde |
|---|
GebruikerstoewijzendeIdentiteit
| Naam | Beschrijving | Waarde |
|---|
Gebruiksvoorbeelden
Geverifieerde Azure-modules
De volgende azure-geverifieerde modules kunnen worden gebruikt om dit resourcetype te implementeren.
Resourcedefinitie van ARM-sjabloon
Het resourcetype sessionPools kan worden geïmplementeerd met bewerkingen die zijn gericht op:
- Resourcegroepen - Zie opdrachten voor de implementatie van resourcegroepen
Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.
Resource-indeling
Als u een Microsoft.App/sessionPools-resource wilt maken, voegt u de volgende JSON toe aan uw sjabloon.
{
"type": "Microsoft.App/sessionPools",
"apiVersion": "2025-02-02-preview",
"name": "string",
"identity": {
"type": "string",
"userAssignedIdentities": {
"{customized property}": {
}
}
},
"location": "string",
"properties": {
"containerType": "string",
"customContainerTemplate": {
"containers": [
{
"args": [ "string" ],
"command": [ "string" ],
"env": [
{
"name": "string",
"secretRef": "string",
"value": "string"
}
],
"image": "string",
"name": "string",
"probes": [
{
"failureThreshold": "int",
"httpGet": {
"host": "string",
"httpHeaders": [
{
"name": "string",
"value": "string"
}
],
"path": "string",
"port": "int",
"scheme": "string"
},
"initialDelaySeconds": "int",
"periodSeconds": "int",
"successThreshold": "int",
"tcpSocket": {
"host": "string",
"port": "int"
},
"terminationGracePeriodSeconds": "int",
"timeoutSeconds": "int",
"type": "string"
}
],
"resources": {
"cpu": "int",
"memory": "string"
}
}
],
"ingress": {
"targetPort": "int"
},
"registryCredentials": {
"identity": "string",
"passwordSecretRef": "string",
"server": "string",
"username": "string"
}
},
"dynamicPoolConfiguration": {
"lifecycleConfiguration": {
"cooldownPeriodInSeconds": "int",
"lifecycleType": "string",
"maxAlivePeriodInSeconds": "int"
}
},
"environmentId": "string",
"managedIdentitySettings": [
{
"identity": "string",
"lifecycle": "string"
}
],
"poolManagementType": "string",
"scaleConfiguration": {
"maxConcurrentSessions": "int",
"readySessionInstances": "int"
},
"secrets": [
{
"name": "string",
"value": "string"
}
],
"sessionNetworkConfiguration": {
"status": "string"
}
},
"tags": {
"{customized property}": "string"
}
}
Eigenschapswaarden
CustomContainerTemplate
| Naam | Beschrijving | Waarde |
|---|---|---|
| Containers | Lijst met containerdefinities voor de sessies van de sessiegroep. | SessionContainer |
| toegang | Configuratie van toegangsbeheerobject voor sessiegroepen. | SessieIngress |
| registerReferenties | Referenties voor privécontainerregisters voor containers die worden gebruikt door de sessies van de sessiegroep. | SessionRegistryCredentials |
DynamicPoolConfiguration
| Naam | Beschrijving | Waarde |
|---|---|---|
| levenscyclusConfiguratie | De levenscyclusconfiguratie van een sessie in de dynamische sessiegroep | LifecycleConfiguration- |
Omgevingsvariabele
| Naam | Beschrijving | Waarde |
|---|---|---|
| naam | Naam van omgevingsvariabele. | touw |
| geheimRef | Naam van het container-app-geheim waaruit de waarde van de omgevingsvariabele moet worden opgehaald. | touw |
| waarde | Niet-geheime omgevingsvariabelewaarde. | touw |
LevenscyclusConfiguratie
| Naam | Beschrijving | Waarde |
|---|---|---|
| afkoelperiodeInseconden | De afkoelperiode van een sessie in seconden wanneer het levenscyclustype 'Getimed' is. | int (integer) |
| levenscyclusType | Het levenscyclustype van de sessiegroep. | 'OnContainerExit' 'Getimed' |
| maxAlivePeriodInSeconds | De maximale levensduur van een sessie in seconden wanneer het levenscyclustype 'OnContainerExit' is. | int (integer) |
Beheerde identiteit instellen
| Naam | Beschrijving | Waarde |
|---|---|---|
| identiteit | De resource-id van een door de gebruiker toegewezen beheerde identiteit die is toegewezen aan de sessiegroep of 'systeem' voor door het systeem toegewezen identiteit. | tekenreeks (vereist) |
| levenscyclus | Gebruik deze optie om de levenscyclusfasen van een sessiegroep te selecteren waarin de beheerde identiteit beschikbaar moet zijn. | 'Alles' 'Init' 'Hoofd' 'Geen' |
Beheerde ServiceIdentity
| Naam | Beschrijving | Waarde |
|---|---|---|
| soort | Type beheerde service-identiteit (waarbij zowel SystemAssigned- als UserAssigned-typen zijn toegestaan). | 'Geen' 'Systeem toegewezen' 'SystemAssigned, UserAssigned' UserAssigned (vereist) |
| gebruikers-toegewezen identiteiten | De set door de gebruiker toegewezen identiteiten die aan de resource zijn gekoppeld. De woordenlijstsleutels userAssignedIdentities zijn ARM-resource-id's in de vorm: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. De waarden van de woordenlijst kunnen lege objecten ({}) zijn in aanvragen. | UserAssignedId-entiteiten |
Microsoft.App/sessionPools
| Naam | Beschrijving | Waarde |
|---|---|---|
| apiVersion | De API-versie | '2025-02-02-voorbeschouwing' |
| identiteit | Beheerde identiteiten die nodig zijn voor een sessiegroep om te communiceren met andere Azure-services om geen geheimen of referenties in code te onderhouden. | ManagedServiceIdentity- |
| locatie | De geografische locatie waar de resource zich bevindt | tekenreeks (vereist) |
| naam | De resourcenaam | snaar Beperkingen: Minimale lengte = 3 Maximale lengte = 63 Patroon = ^[a-z][a-z0-9]*$ (vereist) |
| eigenschappen | Resourcespecifieke eigenschappen van container-app-sessiegroep | SessionPoolProperties- |
| etiketten | Resourcetags | Woordenlijst met tagnamen en -waarden. Zie Tags in sjablonen |
| soort | Het brontype | 'Microsoft.App/sessionPools' |
Schaal Configuratie
| Naam | Beschrijving | Waarde |
|---|---|---|
| maxConcurrentSessions | Het maximumaantal sessies tegelijk. | int (integer) |
| readySessionInstances | Het minimumaantal gereede sessie-exemplaren. | int (integer) |
SessionContainer
| Naam | Beschrijving | Waarde |
|---|---|---|
| Args | Opdrachtargumenten voor het starten van de container. | Snaar[] |
| opdracht | Startopdracht container. | Snaar[] |
| Env | Omgevingsvariabelen voor containers. | MilieuVar |
| afbeelding | Tag containerinstallatiekopieën. | touw |
| naam | Aangepaste containernaam. | touw |
| Sondes | Lijst met tests voor de container. | Sessiesonde |
| hulpmiddelen | Vereisten voor containerresources. | SessionContainerResources |
SessionContainerResources
| Naam | Beschrijving | Waarde |
|---|---|---|
| CPU | Vereiste CPU in kernen, bijvoorbeeld 0,5 | int (integer) |
| geheugen | Vereist geheugen, bijvoorbeeld '250 Mb' | touw |
SessieIngress
| Naam | Beschrijving | Waarde |
|---|---|---|
| Doelpoort | Doelpoort in containers voor verkeer van inkomend verkeer | int (integer) |
SessionNetworkConfiguration
| Naam | Beschrijving | Waarde |
|---|---|---|
| stand van zaken | Netwerkstatus voor de sessies. | 'Uitgaand uitgeschakeld' 'Uitgaand ingeschakeld' |
SessionPoolEigenschappen
| Naam | Beschrijving | Waarde |
|---|---|---|
| container Type | Het containertype van de sessies. | 'Aangepaste container' 'PythonLTS' |
| aangepasteContainerSjabloon | De configuratie van de aangepaste container als het containerType CustomContainer is. | CustomContainerTemplate- |
| dynamicPoolConfiguration | De poolconfiguratie als het poolManagementType dynamisch is. | DynamicPoolConfiguration- |
| omgeving | Resource-id van de omgeving van de sessiegroep. | touw |
| beheerdeIdentiteitInstellingen | Optionele instellingen voor een beheerde identiteit die is toegewezen aan de sessiegroep. | Beheerde identiteit instelling |
| poolManagementType | Het groepsbeheertype van de sessiegroep. | 'Dynamisch' 'Handmatig' |
| schaalConfiguratie | De schaalconfiguratie van de sessiegroep. | ScaleConfiguration- |
| geheimen | De geheimen van de sessiegroep. | SessionPoolSecret |
| sessionNetworkConfiguration | De netwerkconfiguratie van de sessies in de sessiegroep. | SessionNetworkConfiguration- |
SessionPoolSecret
| Naam | Beschrijving | Waarde |
|---|---|---|
| naam | Geheime naam. | touw |
| waarde | Geheime waarde. | snaar Beperkingen: Gevoelige waarde. Doorgeven als een beveiligde parameter. |
SessieProbe
| Naam | Beschrijving | Waarde |
|---|---|---|
| failureThreshold | Minimale opeenvolgende fouten voor de test die als mislukt worden beschouwd nadat de test is geslaagd. Standaardwaarde is 3. Minimumwaarde is 1. De maximumwaarde is 10. | int (integer) |
| httpOphalen | HTTPGet geeft de http-aanvraag op die moet worden uitgevoerd. | SessionProbeHttpGet |
| initialDelaySeconds | Aantal seconden nadat de container is gestart voordat de liveness-tests worden gestart. Minimumwaarde is 1. De maximumwaarde is 60. | int (integer) |
| periodSeconden | Hoe vaak (in seconden) de test moet worden uitgevoerd. De standaardwaarde is 10 seconden. Minimumwaarde is 1. De maximumwaarde is 240. | int (integer) |
| succesDrempel | Minimale opeenvolgende successen voor de test die als geslaagd worden beschouwd nadat deze is mislukt. De standaardwaarde is 1. Moet 1 zijn voor leven en opstarten. Minimumwaarde is 1. De maximumwaarde is 10. | int (integer) |
| tcpStopcontact | TCPSocket geeft een actie op die betrekking heeft op een TCP-poort. TCP-hooks worden nog niet ondersteund. | SessieProbeTcpSocket |
| beëindigingGracePeriodSeconds | Optionele duur in seconden dat de pod probleemloos moet worden beëindigd bij een testfout. De respijtperiode is de duur in seconden nadat de processen die in de pod worden uitgevoerd, een beëindigingssignaal worden verzonden en de tijd waarop de processen geforceerd worden gestopt met een kill-signaal. Stel deze waarde langer in dan de verwachte opschoontijd voor uw proces. Als deze waarde nil is, wordt de beëindigingGracePeriodSeconds van de pod gebruikt. Anders overschrijft deze waarde de waarde die is opgegeven door de podspecificatie. De waarde moet een niet-negatief geheel getal zijn. De waarde nul geeft aan dat stop onmiddellijk via het kill-signaal (geen kans om af te sluiten) aangeeft. Dit is een alfaveld en vereist het inschakelen van de functiepoort ProbeTerminationGracePeriod. Maximumwaarde is 3600 seconden (1 uur) | int (integer) |
| time-outSeconden | Aantal seconden waarna er een time-out optreedt voor de test. De standaardwaarde is 1 seconde. Minimumwaarde is 1. De maximumwaarde is 240. | int (integer) |
| soort | Geeft het type sonde aan. Kan Liveness of Startup zijn, gereedheidstest wordt niet ondersteund in sessies. Het type moet uniek zijn voor elke sonde binnen de context van een lijst met sondes (SessionProbes). | 'Levendheid' 'Opstarten' |
SessionProbeHttpGet
| Naam | Beschrijving | Waarde |
|---|---|---|
| gastheer | Hostnaam waarmee verbinding moet worden gemaakt, wordt standaard ingesteld op het IP-adres van de pod. U wilt in plaats daarvan 'Host' instellen in httpHeaders. | touw |
| httpHeaders | Aangepaste headers die moeten worden ingesteld in de aanvraag. HTTP staat herhaalde headers toe. | SessionProbeHttpGetHttpHeadersItem |
| pad | Pad naar toegang op de HTTP-server. | touw |
| poort/haven | Naam of nummer van de poort voor toegang tot de container. Getal moet tussen 1 en 65535 liggen. De naam moet een IANA_SVC_NAME zijn. | int (vereist) |
| plan | Schema dat moet worden gebruikt om verbinding te maken met de host. Standaard ingesteld op HTTP. | 'HTTP' 'HTTPS' |
SessionProbeHttpGetHttpHeadersItem
| Naam | Beschrijving | Waarde |
|---|---|---|
| naam | De veldnaam van de koptekst | tekenreeks (vereist) |
| waarde | De waarde van het veld voor de koptekst | tekenreeks (vereist) |
SessieProbeTcpSocket
| Naam | Beschrijving | Waarde |
|---|---|---|
| gastheer | Optioneel: hostnaam waarmee verbinding moet worden gemaakt, wordt standaard ingesteld op het IP-adres van de pod. | touw |
| poort/haven | Nummer of naam van de poort voor toegang tot de container. Getal moet tussen 1 en 65535 liggen. De naam moet een IANA_SVC_NAME zijn. | int (vereist) |
SessionRegistryCredentials
| Naam | Beschrijving | Waarde |
|---|---|---|
| identiteit | Een beheerde identiteit die moet worden gebruikt voor verificatie met Azure Container Registry. Voor door de gebruiker toegewezen identiteiten gebruikt u de volledige door de gebruiker toegewezen id-resource-id. Gebruik 'systeem' voor door het systeem toegewezen identiteiten | touw |
| wachtwoordSecretRef | De naam van het geheim dat het aanmeldingswachtwoord voor het register bevat | touw |
| bedieningscomputer | Container registry-server. | touw |
| gebruikersnaam | Gebruikersnaam van containerregister. | touw |
Gevolgde brontags
| Naam | Beschrijving | Waarde |
|---|
UserAssignedIdentities
| Naam | Beschrijving | Waarde |
|---|
GebruikerstoewijzendeIdentiteit
| Naam | Beschrijving | Waarde |
|---|
Gebruiksvoorbeelden
Resourcedefinitie van Terraform (AzAPI-provider)
Het resourcetype sessionPools kan worden geïmplementeerd met bewerkingen die zijn gericht op:
- Resourcegroepen
Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.
Resource-indeling
Als u een Microsoft.App/sessionPools-resource wilt maken, voegt u de volgende Terraform toe aan uw sjabloon.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.App/sessionPools@2025-02-02-preview"
name = "string"
parent_id = "string"
identity {
type = "string"
identity_ids = [
"string"
]
}
location = "string"
tags = {
{customized property} = "string"
}
body = {
properties = {
containerType = "string"
customContainerTemplate = {
containers = [
{
args = [
"string"
]
command = [
"string"
]
env = [
{
name = "string"
secretRef = "string"
value = "string"
}
]
image = "string"
name = "string"
probes = [
{
failureThreshold = int
httpGet = {
host = "string"
httpHeaders = [
{
name = "string"
value = "string"
}
]
path = "string"
port = int
scheme = "string"
}
initialDelaySeconds = int
periodSeconds = int
successThreshold = int
tcpSocket = {
host = "string"
port = int
}
terminationGracePeriodSeconds = int
timeoutSeconds = int
type = "string"
}
]
resources = {
cpu = int
memory = "string"
}
}
]
ingress = {
targetPort = int
}
registryCredentials = {
identity = "string"
passwordSecretRef = "string"
server = "string"
username = "string"
}
}
dynamicPoolConfiguration = {
lifecycleConfiguration = {
cooldownPeriodInSeconds = int
lifecycleType = "string"
maxAlivePeriodInSeconds = int
}
}
environmentId = "string"
managedIdentitySettings = [
{
identity = "string"
lifecycle = "string"
}
]
poolManagementType = "string"
scaleConfiguration = {
maxConcurrentSessions = int
readySessionInstances = int
}
secrets = [
{
name = "string"
value = "string"
}
]
sessionNetworkConfiguration = {
status = "string"
}
}
}
}
Eigenschapswaarden
CustomContainerTemplate
| Naam | Beschrijving | Waarde |
|---|---|---|
| Containers | Lijst met containerdefinities voor de sessies van de sessiegroep. | SessionContainer |
| toegang | Configuratie van toegangsbeheerobject voor sessiegroepen. | SessieIngress |
| registerReferenties | Referenties voor privécontainerregisters voor containers die worden gebruikt door de sessies van de sessiegroep. | SessionRegistryCredentials |
DynamicPoolConfiguration
| Naam | Beschrijving | Waarde |
|---|---|---|
| levenscyclusConfiguratie | De levenscyclusconfiguratie van een sessie in de dynamische sessiegroep | LifecycleConfiguration- |
Omgevingsvariabele
| Naam | Beschrijving | Waarde |
|---|---|---|
| naam | Naam van omgevingsvariabele. | touw |
| geheimRef | Naam van het container-app-geheim waaruit de waarde van de omgevingsvariabele moet worden opgehaald. | touw |
| waarde | Niet-geheime omgevingsvariabelewaarde. | touw |
LevenscyclusConfiguratie
| Naam | Beschrijving | Waarde |
|---|---|---|
| afkoelperiodeInseconden | De afkoelperiode van een sessie in seconden wanneer het levenscyclustype 'Getimed' is. | int (integer) |
| levenscyclusType | Het levenscyclustype van de sessiegroep. | 'OnContainerExit' 'Getimed' |
| maxAlivePeriodInSeconds | De maximale levensduur van een sessie in seconden wanneer het levenscyclustype 'OnContainerExit' is. | int (integer) |
Beheerde identiteit instellen
| Naam | Beschrijving | Waarde |
|---|---|---|
| identiteit | De resource-id van een door de gebruiker toegewezen beheerde identiteit die is toegewezen aan de sessiegroep of 'systeem' voor door het systeem toegewezen identiteit. | tekenreeks (vereist) |
| levenscyclus | Gebruik deze optie om de levenscyclusfasen van een sessiegroep te selecteren waarin de beheerde identiteit beschikbaar moet zijn. | 'Alles' 'Init' 'Hoofd' 'Geen' |
Beheerde ServiceIdentity
| Naam | Beschrijving | Waarde |
|---|---|---|
| soort | Type beheerde service-identiteit (waarbij zowel SystemAssigned- als UserAssigned-typen zijn toegestaan). | 'Geen' 'Systeem toegewezen' 'SystemAssigned, UserAssigned' UserAssigned (vereist) |
| gebruikers-toegewezen identiteiten | De set door de gebruiker toegewezen identiteiten die aan de resource zijn gekoppeld. De woordenlijstsleutels userAssignedIdentities zijn ARM-resource-id's in de vorm: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. De waarden van de woordenlijst kunnen lege objecten ({}) zijn in aanvragen. | UserAssignedId-entiteiten |
Microsoft.App/sessionPools
| Naam | Beschrijving | Waarde |
|---|---|---|
| identiteit | Beheerde identiteiten die nodig zijn voor een sessiegroep om te communiceren met andere Azure-services om geen geheimen of referenties in code te onderhouden. | ManagedServiceIdentity- |
| locatie | De geografische locatie waar de resource zich bevindt | tekenreeks (vereist) |
| naam | De resourcenaam | snaar Beperkingen: Minimale lengte = 3 Maximale lengte = 63 Patroon = ^[a-z][a-z0-9]*$ (vereist) |
| eigenschappen | Resourcespecifieke eigenschappen van container-app-sessiegroep | SessionPoolProperties- |
| etiketten | Resourcetags | Woordenlijst met tagnamen en -waarden. |
| soort | Het brontype | "Microsoft.App/sessionPools@2025-02-02-preview" |
Schaal Configuratie
| Naam | Beschrijving | Waarde |
|---|---|---|
| maxConcurrentSessions | Het maximumaantal sessies tegelijk. | int (integer) |
| readySessionInstances | Het minimumaantal gereede sessie-exemplaren. | int (integer) |
SessionContainer
| Naam | Beschrijving | Waarde |
|---|---|---|
| Args | Opdrachtargumenten voor het starten van de container. | Snaar[] |
| opdracht | Startopdracht container. | Snaar[] |
| Env | Omgevingsvariabelen voor containers. | MilieuVar |
| afbeelding | Tag containerinstallatiekopieën. | touw |
| naam | Aangepaste containernaam. | touw |
| Sondes | Lijst met tests voor de container. | Sessiesonde |
| hulpmiddelen | Vereisten voor containerresources. | SessionContainerResources |
SessionContainerResources
| Naam | Beschrijving | Waarde |
|---|---|---|
| CPU | Vereiste CPU in kernen, bijvoorbeeld 0,5 | int (integer) |
| geheugen | Vereist geheugen, bijvoorbeeld '250 Mb' | touw |
SessieIngress
| Naam | Beschrijving | Waarde |
|---|---|---|
| Doelpoort | Doelpoort in containers voor verkeer van inkomend verkeer | int (integer) |
SessionNetworkConfiguration
| Naam | Beschrijving | Waarde |
|---|---|---|
| stand van zaken | Netwerkstatus voor de sessies. | 'Uitgaand uitgeschakeld' 'Uitgaand ingeschakeld' |
SessionPoolEigenschappen
| Naam | Beschrijving | Waarde |
|---|---|---|
| container Type | Het containertype van de sessies. | 'Aangepaste container' 'PythonLTS' |
| aangepasteContainerSjabloon | De configuratie van de aangepaste container als het containerType CustomContainer is. | CustomContainerTemplate- |
| dynamicPoolConfiguration | De poolconfiguratie als het poolManagementType dynamisch is. | DynamicPoolConfiguration- |
| omgeving | Resource-id van de omgeving van de sessiegroep. | touw |
| beheerdeIdentiteitInstellingen | Optionele instellingen voor een beheerde identiteit die is toegewezen aan de sessiegroep. | Beheerde identiteit instelling |
| poolManagementType | Het groepsbeheertype van de sessiegroep. | 'Dynamisch' 'Handmatig' |
| schaalConfiguratie | De schaalconfiguratie van de sessiegroep. | ScaleConfiguration- |
| geheimen | De geheimen van de sessiegroep. | SessionPoolSecret |
| sessionNetworkConfiguration | De netwerkconfiguratie van de sessies in de sessiegroep. | SessionNetworkConfiguration- |
SessionPoolSecret
| Naam | Beschrijving | Waarde |
|---|---|---|
| naam | Geheime naam. | touw |
| waarde | Geheime waarde. | snaar Beperkingen: Gevoelige waarde. Doorgeven als een beveiligde parameter. |
SessieProbe
| Naam | Beschrijving | Waarde |
|---|---|---|
| failureThreshold | Minimale opeenvolgende fouten voor de test die als mislukt worden beschouwd nadat de test is geslaagd. Standaardwaarde is 3. Minimumwaarde is 1. De maximumwaarde is 10. | int (integer) |
| httpOphalen | HTTPGet geeft de http-aanvraag op die moet worden uitgevoerd. | SessionProbeHttpGet |
| initialDelaySeconds | Aantal seconden nadat de container is gestart voordat de liveness-tests worden gestart. Minimumwaarde is 1. De maximumwaarde is 60. | int (integer) |
| periodSeconden | Hoe vaak (in seconden) de test moet worden uitgevoerd. De standaardwaarde is 10 seconden. Minimumwaarde is 1. De maximumwaarde is 240. | int (integer) |
| succesDrempel | Minimale opeenvolgende successen voor de test die als geslaagd worden beschouwd nadat deze is mislukt. De standaardwaarde is 1. Moet 1 zijn voor leven en opstarten. Minimumwaarde is 1. De maximumwaarde is 10. | int (integer) |
| tcpStopcontact | TCPSocket geeft een actie op die betrekking heeft op een TCP-poort. TCP-hooks worden nog niet ondersteund. | SessieProbeTcpSocket |
| beëindigingGracePeriodSeconds | Optionele duur in seconden dat de pod probleemloos moet worden beëindigd bij een testfout. De respijtperiode is de duur in seconden nadat de processen die in de pod worden uitgevoerd, een beëindigingssignaal worden verzonden en de tijd waarop de processen geforceerd worden gestopt met een kill-signaal. Stel deze waarde langer in dan de verwachte opschoontijd voor uw proces. Als deze waarde nil is, wordt de beëindigingGracePeriodSeconds van de pod gebruikt. Anders overschrijft deze waarde de waarde die is opgegeven door de podspecificatie. De waarde moet een niet-negatief geheel getal zijn. De waarde nul geeft aan dat stop onmiddellijk via het kill-signaal (geen kans om af te sluiten) aangeeft. Dit is een alfaveld en vereist het inschakelen van de functiepoort ProbeTerminationGracePeriod. Maximumwaarde is 3600 seconden (1 uur) | int (integer) |
| time-outSeconden | Aantal seconden waarna er een time-out optreedt voor de test. De standaardwaarde is 1 seconde. Minimumwaarde is 1. De maximumwaarde is 240. | int (integer) |
| soort | Geeft het type sonde aan. Kan Liveness of Startup zijn, gereedheidstest wordt niet ondersteund in sessies. Het type moet uniek zijn voor elke sonde binnen de context van een lijst met sondes (SessionProbes). | 'Levendheid' 'Opstarten' |
SessionProbeHttpGet
| Naam | Beschrijving | Waarde |
|---|---|---|
| gastheer | Hostnaam waarmee verbinding moet worden gemaakt, wordt standaard ingesteld op het IP-adres van de pod. U wilt in plaats daarvan 'Host' instellen in httpHeaders. | touw |
| httpHeaders | Aangepaste headers die moeten worden ingesteld in de aanvraag. HTTP staat herhaalde headers toe. | SessionProbeHttpGetHttpHeadersItem |
| pad | Pad naar toegang op de HTTP-server. | touw |
| poort/haven | Naam of nummer van de poort voor toegang tot de container. Getal moet tussen 1 en 65535 liggen. De naam moet een IANA_SVC_NAME zijn. | int (vereist) |
| plan | Schema dat moet worden gebruikt om verbinding te maken met de host. Standaard ingesteld op HTTP. | 'HTTP' 'HTTPS' |
SessionProbeHttpGetHttpHeadersItem
| Naam | Beschrijving | Waarde |
|---|---|---|
| naam | De veldnaam van de koptekst | tekenreeks (vereist) |
| waarde | De waarde van het veld voor de koptekst | tekenreeks (vereist) |
SessieProbeTcpSocket
| Naam | Beschrijving | Waarde |
|---|---|---|
| gastheer | Optioneel: hostnaam waarmee verbinding moet worden gemaakt, wordt standaard ingesteld op het IP-adres van de pod. | touw |
| poort/haven | Nummer of naam van de poort voor toegang tot de container. Getal moet tussen 1 en 65535 liggen. De naam moet een IANA_SVC_NAME zijn. | int (vereist) |
SessionRegistryCredentials
| Naam | Beschrijving | Waarde |
|---|---|---|
| identiteit | Een beheerde identiteit die moet worden gebruikt voor verificatie met Azure Container Registry. Voor door de gebruiker toegewezen identiteiten gebruikt u de volledige door de gebruiker toegewezen id-resource-id. Gebruik 'systeem' voor door het systeem toegewezen identiteiten | touw |
| wachtwoordSecretRef | De naam van het geheim dat het aanmeldingswachtwoord voor het register bevat | touw |
| bedieningscomputer | Container registry-server. | touw |
| gebruikersnaam | Gebruikersnaam van containerregister. | touw |
Gevolgde brontags
| Naam | Beschrijving | Waarde |
|---|
UserAssignedIdentities
| Naam | Beschrijving | Waarde |
|---|
GebruikerstoewijzendeIdentiteit
| Naam | Beschrijving | Waarde |
|---|