Freigeben über


Microsoft.App managedEnvironments 2025-01-01

Bicep-Ressourcendefinition

Der Ressourcentyp "managedEnvironments" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.App/managedEnvironments-Ressource zu erstellen, fügen Sie der Vorlage die folgende Bicep hinzu.

resource symbolicname 'Microsoft.App/managedEnvironments@2025-01-01' = {
  scope: resourceSymbolicName or scope
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  kind: 'string'
  location: 'string'
  name: 'string'
  properties: {
    appLogsConfiguration: {
      destination: 'string'
      logAnalyticsConfiguration: {
        customerId: 'string'
        sharedKey: 'string'
      }
    }
    customDomainConfiguration: {
      certificateKeyVaultProperties: {
        identity: 'string'
        keyVaultUrl: 'string'
      }
      certificatePassword: 'string'
      certificateValue: any(...)
      dnsSuffix: 'string'
    }
    daprAIConnectionString: 'string'
    daprAIInstrumentationKey: 'string'
    daprConfiguration: {}
    infrastructureResourceGroup: 'string'
    kedaConfiguration: {}
    peerAuthentication: {
      mtls: {
        enabled: bool
      }
    }
    peerTrafficConfiguration: {
      encryption: {
        enabled: bool
      }
    }
    vnetConfiguration: {
      dockerBridgeCidr: 'string'
      infrastructureSubnetId: 'string'
      internal: bool
      platformReservedCidr: 'string'
      platformReservedDnsIP: 'string'
    }
    workloadProfiles: [
      {
        maximumCount: int
        minimumCount: int
        name: 'string'
        workloadProfileType: 'string'
      }
    ]
    zoneRedundant: bool
  }
  tags: {
    {customized property}: 'string'
  }
}

Eigenschaftswerte

Microsoft.App/verwalteteUmgebungen

Name BESCHREIBUNG Wert
Identität Verwaltete Identitäten für die verwaltete Umgebung, um mit anderen Azure-Diensten zu interagieren, ohne geheime Schlüssel oder Anmeldeinformationen im Code zu verwalten. ManagedServiceIdentity-
Art Art der Umwelt. Schnur
Standort Der geografische Standort, an dem sich die Ressource befindet Zeichenfolge (erforderlich)
Name Der Ressourcenname Zeichenfolge (erforderlich)
Eigenschaften Ressourcenspezifische Eigenschaften der verwalteten Umgebung ManagedEnvironmentProperties
scope Verwenden Sie diese Verwendung beim Erstellen einer Ressource in einem Bereich, der sich von dem Bereitstellungsbereich unterscheidet. Legen Sie diese Eigenschaft auf den symbolischen Namen einer Ressource fest, um die Erweiterungsressourceanzuwenden.
Schlagwörter Ressourcentags Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen

AppLogs-Konfiguration

Name BESCHREIBUNG Wert
Bestimmungsort Protokollziel, kann 'Log-Analytics', 'azure-monitor' oder 'none' sein. Schnur
logAnalyticsKonfiguration Log Analytics-Konfiguration muss nur bereitgestellt werden, wenn das Ziel als "Log-Analytics" konfiguriert ist. LogAnalyticsKonfiguration

CertificateKeyVault-Eigenschaften

Name BESCHREIBUNG Wert
Identität Ressourcen-ID einer verwalteten Identität zum Authentifizieren mit Azure Key Vault oder System zur Verwendung einer vom System zugewiesenen Identität. Schnur
keyVaultUrl DIE URL, die auf den geheimen Azure Key Vault-Schlüssel zeigt, der das Zertifikat enthält. Schnur

CustomDomainConfiguration

Name BESCHREIBUNG Wert
certificateKeyVault-Eigenschaften Zertifikat, das in Azure Key Vault gespeichert ist. CertificateKeyVault-Eigenschaften
certificatePasswort Zertifikatkennwort Zeichenfolge

Zwänge:
Vertraulicher Wert. Übergeben Als sicherer Parameter.
certificate-Wert PFX- oder PEM-Blob jegliche
dnsSuffix Dns-Suffix für die Umgebungsdomäne Schnur

DaprConfiguration

Name BESCHREIBUNG Wert

KedaKonfiguration

Name BESCHREIBUNG Wert

LogAnalyticsKonfiguration

Name BESCHREIBUNG Wert
Kunden-ID Protokollanalyse-Kunden-ID Schnur
gemeinsamerSchlüssel Log Analytics Customer Key Zeichenfolge

Zwänge:
Vertraulicher Wert. Übergeben Als sicherer Parameter.

ManagedEnvironmentProperties

Name BESCHREIBUNG Wert
appLogsKonfiguration Clusterkonfiguration, mit der der Protokolldaemon App-Protokolle in das konfigurierte Ziel exportieren kann. AppLogsConfiguration-
customDomainConfiguration Benutzerdefinierte Domänenkonfiguration für die Umgebung CustomDomainConfiguration-
daprAIConnectionString Application Insights-Verbindungszeichenfolge, die von Dapr zum Exportieren der Dienst-in-Dienst-Kommunikationstelemetrie verwendet wird Zeichenfolge

Zwänge:
Vertraulicher Wert. Übergeben Als sicherer Parameter.
daprAIInstrumentationKey Azure Monitor-Instrumentierungsschlüssel, der von Dapr zum Exportieren von Dienst-in-Dienst-Kommunikationstelemetrie verwendet wird Zeichenfolge

Zwänge:
Vertraulicher Wert. Übergeben Als sicherer Parameter.
daprConfiguration Die Konfiguration der Dapr-Komponente. DaprConfiguration
infrastructureResourceGroup Name der plattformverwalteten Ressourcengruppe, die für die verwaltete Umgebung zum Hosten von Infrastrukturressourcen erstellt wurde. Wenn eine Subnetz-ID angegeben wird, wird diese Ressourcengruppe im selben Abonnement wie das Subnetz erstellt. Schnur
kedaKonfiguration Die Konfiguration der Keda-Komponente. KedaKonfiguration
peer-Authentifizierung Peerauthentifizierungseinstellungen für die verwaltete Umgebung ManagedEnvironmentPropertiesPeerAuthentication
peerTraffic-Konfiguration Peer-Datenverkehrseinstellungen für die verwaltete Umgebung ManagedEnvironmentPropertiesPeerTrafficConfiguration
vnetConfiguration Vnet-Konfiguration für die Umgebung VnetConfiguration-
workload-Profile Workloadprofile, die für die verwaltete Umgebung konfiguriert sind. WorkloadProfile-[]
zoneRedundant Gibt an, ob diese verwaltete Umgebung zonenredundant ist. Boolesch

ManagedEnvironmentPropertiesPeerAuthentication

Name BESCHREIBUNG Wert
MTLS Einstellungen für die gegenseitige TLS-Authentifizierung für die verwaltete Umgebung Mtls

ManagedEnvironmentPropertiesPeerTrafficConfiguration

Name BESCHREIBUNG Wert
Verschlüsselung Verschlüsselungseinstellungen für Peerdatenverkehr für die verwaltete Umgebung ManagedEnvironmentPropertiesPeerTrafficConfigurationEncryption

ManagedEnvironmentPropertiesPeerTrafficConfigurationEncryption

Name BESCHREIBUNG Wert
aktiviert Boolescher Wert, der angibt, ob die Peerdatenverkehrverschlüsselung aktiviert ist Boolesch

Verwaltete Dienstidentität

Name BESCHREIBUNG Wert
Typ Typ der verwalteten Dienstidentität (wobei systemAssigned- und UserAssigned-Typen zulässig sind). "Keine"
'SystemZugewiesen'
"SystemAssigned,UserAssigned"
"UserAssigned" (erforderlich)
vom Benutzer zugewiesene Identitäten Die Gruppe der benutzerzuweisungen Identitäten, die der Ressource zugeordnet sind. Die Wörterbuchschlüssel "userAssignedIdentities" sind ARM-Ressourcen-IDs im Formular: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Die Wörterbuchwerte können leere Objekte ({}) in Anforderungen sein. UserAssignedIdentities-

Mtls

Name BESCHREIBUNG Wert
aktiviert Boolescher Wert, der angibt, ob die gegenseitige TLS-Authentifizierung aktiviert ist Boolesch

Verfolgte ResourceTags

Name BESCHREIBUNG Wert

UserAssignedIdentities

Name BESCHREIBUNG Wert

UserAssignedIdentity

Name BESCHREIBUNG Wert

VnetConfiguration

Name BESCHREIBUNG Wert
dockerBridgeCidr CIDR-Notation-IP-Bereich, der der Docker-Brücke, Netzwerk zugewiesen ist. Darf nicht mit anderen bereitgestellten IP-Bereichen überlappen. Schnur
infrastructureSubnetId Ressourcen-ID eines Subnetzes für Infrastrukturkomponenten. Darf nicht mit anderen bereitgestellten IP-Bereichen überlappen. Schnur
intern Boolescher Wert, der angibt, dass die Umgebung nur über einen internen Lastenausgleich verfügt. Diese Umgebungen verfügen nicht über eine öffentliche statische IP-Ressource. Sie müssen "infrastructureSubnetId" bereitstellen, wenn diese Eigenschaft aktiviert wird. Boolesch
PlattformReservedCidr IP-Bereich in CIDR-Notation, der für IP-Adressen der Umgebungsinfrastruktur reserviert werden kann. Darf nicht mit anderen bereitgestellten IP-Bereichen überlappen. Schnur
platformReservedDnsIP Eine IP-Adresse aus dem durch platformReservedCidr definierten IP-Bereich, der für den internen DNS-Server reserviert wird. Schnur

Workload-Profil

Name BESCHREIBUNG Wert
maximumCount Die maximale Kapazität. Int
minimumCount Die Mindestkapazität. Int
Name Workload-Profiltyp für die Workloads, auf denen ausgeführt werden soll. Zeichenfolge (erforderlich)
workloadProfileType Workload-Profiltyp für die Workloads, auf denen ausgeführt werden soll. Zeichenfolge (erforderlich)

Verwendungsbeispiele

Von Azure verifizierte Module

Die folgenden Azure Verified Modules können verwendet werden, um diesen Ressourcentyp bereitzustellen.

Modul BESCHREIBUNG
verwaltete App-Umgebung AVM-Ressourcenmodul für verwaltete App-Umgebung

Azure-Schnellstartbeispiele

Die folgenden Azure-Schnellstartvorlagen Bicep-Beispiele für die Bereitstellung dieses Ressourcentyps enthalten.

Bicep-Datei BESCHREIBUNG
Erstellt eine Container-App und -Umgebung mit Registrierungs- Erstellen Sie eine Container-App-Umgebung mit einer einfachen Container-App aus einer Azure-Containerregistrierung. Außerdem wird ein Log Analytics-Arbeitsbereich zum Speichern von Protokollen bereitgestellt.
Erstellt eine Container-App mit einer definierten HTTP-Skalierungsregel Erstellen Sie eine Container-App-Umgebung mit einer einfachen Container-App, die basierend auf HTTP-Datenverkehr skaliert wird.
Erstellt eine Container-App in einer Container-App-Umgebung Erstellen Sie eine Container-App-Umgebung mit einer einfachen Container-App. Außerdem wird ein Log Analytics-Arbeitsbereich zum Speichern von Protokollen bereitgestellt.
Erstellt eine Dapr Microservices-App mit Container-Apps Erstellen Sie eine Dapr Microservices-App mit Container-Apps.
Erstellt eine Dapr pub-sub servicebus-App mit Container-Apps Erstellen Sie eine Dapr pub-sub servicebus-App mit Container-Apps.
Erstellt eine zwei Container-App mit einer Container-App-Umgebung Erstellen Sie eine zwei Container-App-Umgebung mit einer einfachen Container-App. Außerdem wird ein Log Analytics-Arbeitsbereich zum Speichern von Protokollen bereitgestellt.
Erstellt eine externe Container-App-Umgebung mit einem VNET- Erstellt eine externe Container-App-Umgebung mit einem VNET.
Erstellt eine interne Container-App-Umgebung mit einem VNET- Erstellt eine interne Container-App-Umgebung mit einem VNET.

ARM-Vorlagenressourcendefinition

Der Ressourcentyp "managedEnvironments" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.App/managedEnvironments-Ressource zu erstellen, fügen Sie der Vorlage den folgenden JSON-Code hinzu.

{
  "type": "Microsoft.App/managedEnvironments",
  "apiVersion": "2025-01-01",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "kind": "string",
  "location": "string",
  "properties": {
    "appLogsConfiguration": {
      "destination": "string",
      "logAnalyticsConfiguration": {
        "customerId": "string",
        "sharedKey": "string"
      }
    },
    "customDomainConfiguration": {
      "certificateKeyVaultProperties": {
        "identity": "string",
        "keyVaultUrl": "string"
      },
      "certificatePassword": "string",
      "certificateValue": {},
      "dnsSuffix": "string"
    },
    "daprAIConnectionString": "string",
    "daprAIInstrumentationKey": "string",
    "daprConfiguration": {
    },
    "infrastructureResourceGroup": "string",
    "kedaConfiguration": {
    },
    "peerAuthentication": {
      "mtls": {
        "enabled": "bool"
      }
    },
    "peerTrafficConfiguration": {
      "encryption": {
        "enabled": "bool"
      }
    },
    "vnetConfiguration": {
      "dockerBridgeCidr": "string",
      "infrastructureSubnetId": "string",
      "internal": "bool",
      "platformReservedCidr": "string",
      "platformReservedDnsIP": "string"
    },
    "workloadProfiles": [
      {
        "maximumCount": "int",
        "minimumCount": "int",
        "name": "string",
        "workloadProfileType": "string"
      }
    ],
    "zoneRedundant": "bool"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Eigenschaftswerte

Microsoft.App/verwalteteUmgebungen

Name BESCHREIBUNG Wert
apiVersion (Englisch) Die API-Version '2025-01-01'
Identität Verwaltete Identitäten für die verwaltete Umgebung, um mit anderen Azure-Diensten zu interagieren, ohne geheime Schlüssel oder Anmeldeinformationen im Code zu verwalten. ManagedServiceIdentity-
Art Art der Umwelt. Schnur
Standort Der geografische Standort, an dem sich die Ressource befindet Zeichenfolge (erforderlich)
Name Der Ressourcenname Zeichenfolge (erforderlich)
Eigenschaften Ressourcenspezifische Eigenschaften der verwalteten Umgebung ManagedEnvironmentProperties
Schlagwörter Ressourcentags Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen
Typ Der Ressourcentyp "Microsoft.App/managedEnvironments"

AppLogs-Konfiguration

Name BESCHREIBUNG Wert
Bestimmungsort Protokollziel, kann 'Log-Analytics', 'azure-monitor' oder 'none' sein. Schnur
logAnalyticsKonfiguration Log Analytics-Konfiguration muss nur bereitgestellt werden, wenn das Ziel als "Log-Analytics" konfiguriert ist. LogAnalyticsKonfiguration

CertificateKeyVault-Eigenschaften

Name BESCHREIBUNG Wert
Identität Ressourcen-ID einer verwalteten Identität zum Authentifizieren mit Azure Key Vault oder System zur Verwendung einer vom System zugewiesenen Identität. Schnur
keyVaultUrl DIE URL, die auf den geheimen Azure Key Vault-Schlüssel zeigt, der das Zertifikat enthält. Schnur

CustomDomainConfiguration

Name BESCHREIBUNG Wert
certificateKeyVault-Eigenschaften Zertifikat, das in Azure Key Vault gespeichert ist. CertificateKeyVault-Eigenschaften
certificatePasswort Zertifikatkennwort Zeichenfolge

Zwänge:
Vertraulicher Wert. Übergeben Als sicherer Parameter.
certificate-Wert PFX- oder PEM-Blob jegliche
dnsSuffix Dns-Suffix für die Umgebungsdomäne Schnur

DaprConfiguration

Name BESCHREIBUNG Wert

KedaKonfiguration

Name BESCHREIBUNG Wert

LogAnalyticsKonfiguration

Name BESCHREIBUNG Wert
Kunden-ID Protokollanalyse-Kunden-ID Schnur
gemeinsamerSchlüssel Log Analytics Customer Key Zeichenfolge

Zwänge:
Vertraulicher Wert. Übergeben Als sicherer Parameter.

ManagedEnvironmentProperties

Name BESCHREIBUNG Wert
appLogsKonfiguration Clusterkonfiguration, mit der der Protokolldaemon App-Protokolle in das konfigurierte Ziel exportieren kann. AppLogsConfiguration-
customDomainConfiguration Benutzerdefinierte Domänenkonfiguration für die Umgebung CustomDomainConfiguration-
daprAIConnectionString Application Insights-Verbindungszeichenfolge, die von Dapr zum Exportieren der Dienst-in-Dienst-Kommunikationstelemetrie verwendet wird Zeichenfolge

Zwänge:
Vertraulicher Wert. Übergeben Als sicherer Parameter.
daprAIInstrumentationKey Azure Monitor-Instrumentierungsschlüssel, der von Dapr zum Exportieren von Dienst-in-Dienst-Kommunikationstelemetrie verwendet wird Zeichenfolge

Zwänge:
Vertraulicher Wert. Übergeben Als sicherer Parameter.
daprConfiguration Die Konfiguration der Dapr-Komponente. DaprConfiguration
infrastructureResourceGroup Name der plattformverwalteten Ressourcengruppe, die für die verwaltete Umgebung zum Hosten von Infrastrukturressourcen erstellt wurde. Wenn eine Subnetz-ID angegeben wird, wird diese Ressourcengruppe im selben Abonnement wie das Subnetz erstellt. Schnur
kedaKonfiguration Die Konfiguration der Keda-Komponente. KedaKonfiguration
peer-Authentifizierung Peerauthentifizierungseinstellungen für die verwaltete Umgebung ManagedEnvironmentPropertiesPeerAuthentication
peerTraffic-Konfiguration Peer-Datenverkehrseinstellungen für die verwaltete Umgebung ManagedEnvironmentPropertiesPeerTrafficConfiguration
vnetConfiguration Vnet-Konfiguration für die Umgebung VnetConfiguration-
workload-Profile Workloadprofile, die für die verwaltete Umgebung konfiguriert sind. WorkloadProfile-[]
zoneRedundant Gibt an, ob diese verwaltete Umgebung zonenredundant ist. Boolesch

ManagedEnvironmentPropertiesPeerAuthentication

Name BESCHREIBUNG Wert
MTLS Einstellungen für die gegenseitige TLS-Authentifizierung für die verwaltete Umgebung Mtls

ManagedEnvironmentPropertiesPeerTrafficConfiguration

Name BESCHREIBUNG Wert
Verschlüsselung Verschlüsselungseinstellungen für Peerdatenverkehr für die verwaltete Umgebung ManagedEnvironmentPropertiesPeerTrafficConfigurationEncryption

ManagedEnvironmentPropertiesPeerTrafficConfigurationEncryption

Name BESCHREIBUNG Wert
aktiviert Boolescher Wert, der angibt, ob die Peerdatenverkehrverschlüsselung aktiviert ist Boolesch

Verwaltete Dienstidentität

Name BESCHREIBUNG Wert
Typ Typ der verwalteten Dienstidentität (wobei systemAssigned- und UserAssigned-Typen zulässig sind). "Keine"
'SystemZugewiesen'
"SystemAssigned,UserAssigned"
"UserAssigned" (erforderlich)
vom Benutzer zugewiesene Identitäten Die Gruppe der benutzerzuweisungen Identitäten, die der Ressource zugeordnet sind. Die Wörterbuchschlüssel "userAssignedIdentities" sind ARM-Ressourcen-IDs im Formular: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Die Wörterbuchwerte können leere Objekte ({}) in Anforderungen sein. UserAssignedIdentities-

Mtls

Name BESCHREIBUNG Wert
aktiviert Boolescher Wert, der angibt, ob die gegenseitige TLS-Authentifizierung aktiviert ist Boolesch

Verfolgte ResourceTags

Name BESCHREIBUNG Wert

UserAssignedIdentities

Name BESCHREIBUNG Wert

UserAssignedIdentity

Name BESCHREIBUNG Wert

VnetConfiguration

Name BESCHREIBUNG Wert
dockerBridgeCidr CIDR-Notation-IP-Bereich, der der Docker-Brücke, Netzwerk zugewiesen ist. Darf nicht mit anderen bereitgestellten IP-Bereichen überlappen. Schnur
infrastructureSubnetId Ressourcen-ID eines Subnetzes für Infrastrukturkomponenten. Darf nicht mit anderen bereitgestellten IP-Bereichen überlappen. Schnur
intern Boolescher Wert, der angibt, dass die Umgebung nur über einen internen Lastenausgleich verfügt. Diese Umgebungen verfügen nicht über eine öffentliche statische IP-Ressource. Sie müssen "infrastructureSubnetId" bereitstellen, wenn diese Eigenschaft aktiviert wird. Boolesch
PlattformReservedCidr IP-Bereich in CIDR-Notation, der für IP-Adressen der Umgebungsinfrastruktur reserviert werden kann. Darf nicht mit anderen bereitgestellten IP-Bereichen überlappen. Schnur
platformReservedDnsIP Eine IP-Adresse aus dem durch platformReservedCidr definierten IP-Bereich, der für den internen DNS-Server reserviert wird. Schnur

Workload-Profil

Name BESCHREIBUNG Wert
maximumCount Die maximale Kapazität. Int
minimumCount Die Mindestkapazität. Int
Name Workload-Profiltyp für die Workloads, auf denen ausgeführt werden soll. Zeichenfolge (erforderlich)
workloadProfileType Workload-Profiltyp für die Workloads, auf denen ausgeführt werden soll. Zeichenfolge (erforderlich)

Verwendungsbeispiele

Azure-Schnellstartvorlagen

Die folgenden Azure-Schnellstartvorlagen diesen Ressourcentyp bereitstellen.

Schablone BESCHREIBUNG
Erstellt eine Container-App und -Umgebung mit Registrierungs-

Bereitstellen in Azure
Erstellen Sie eine Container-App-Umgebung mit einer einfachen Container-App aus einer Azure-Containerregistrierung. Außerdem wird ein Log Analytics-Arbeitsbereich zum Speichern von Protokollen bereitgestellt.
Erstellt eine Container-App mit einer definierten HTTP-Skalierungsregel

Bereitstellen in Azure
Erstellen Sie eine Container-App-Umgebung mit einer einfachen Container-App, die basierend auf HTTP-Datenverkehr skaliert wird.
Erstellt eine Container-App in einer Container-App-Umgebung

Bereitstellen in Azure
Erstellen Sie eine Container-App-Umgebung mit einer einfachen Container-App. Außerdem wird ein Log Analytics-Arbeitsbereich zum Speichern von Protokollen bereitgestellt.
Erstellt eine Dapr Microservices-App mit Container-Apps

Bereitstellen in Azure
Erstellen Sie eine Dapr Microservices-App mit Container-Apps.
Erstellt eine Dapr pub-sub servicebus-App mit Container-Apps

Bereitstellen in Azure
Erstellen Sie eine Dapr pub-sub servicebus-App mit Container-Apps.
Erstellt eine zwei Container-App mit einer Container-App-Umgebung

Bereitstellen in Azure
Erstellen Sie eine zwei Container-App-Umgebung mit einer einfachen Container-App. Außerdem wird ein Log Analytics-Arbeitsbereich zum Speichern von Protokollen bereitgestellt.
Erstellt eine externe Container-App-Umgebung mit einem VNET-

Bereitstellen in Azure
Erstellt eine externe Container-App-Umgebung mit einem VNET.
Erstellt eine interne Container-App-Umgebung mit einem VNET-

Bereitstellen in Azure
Erstellt eine interne Container-App-Umgebung mit einem VNET.

Terraform -Ressourcendefinition (AzAPI-Anbieter)

Der Ressourcentyp "managedEnvironments" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.App/managedEnvironments-Ressource zu erstellen, fügen Sie Ihrer Vorlage die folgende Terraform hinzu.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.App/managedEnvironments@2025-01-01"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    kind = "string"
    properties = {
      appLogsConfiguration = {
        destination = "string"
        logAnalyticsConfiguration = {
          customerId = "string"
          sharedKey = "string"
        }
      }
      customDomainConfiguration = {
        certificateKeyVaultProperties = {
          identity = "string"
          keyVaultUrl = "string"
        }
        certificatePassword = "string"
        certificateValue = ?
        dnsSuffix = "string"
      }
      daprAIConnectionString = "string"
      daprAIInstrumentationKey = "string"
      daprConfiguration = {
      }
      infrastructureResourceGroup = "string"
      kedaConfiguration = {
      }
      peerAuthentication = {
        mtls = {
          enabled = bool
        }
      }
      peerTrafficConfiguration = {
        encryption = {
          enabled = bool
        }
      }
      vnetConfiguration = {
        dockerBridgeCidr = "string"
        infrastructureSubnetId = "string"
        internal = bool
        platformReservedCidr = "string"
        platformReservedDnsIP = "string"
      }
      workloadProfiles = [
        {
          maximumCount = int
          minimumCount = int
          name = "string"
          workloadProfileType = "string"
        }
      ]
      zoneRedundant = bool
    }
  }
}

Eigenschaftswerte

Microsoft.App/verwalteteUmgebungen

Name BESCHREIBUNG Wert
Identität Verwaltete Identitäten für die verwaltete Umgebung, um mit anderen Azure-Diensten zu interagieren, ohne geheime Schlüssel oder Anmeldeinformationen im Code zu verwalten. ManagedServiceIdentity-
Art Art der Umwelt. Schnur
Standort Der geografische Standort, an dem sich die Ressource befindet Zeichenfolge (erforderlich)
Name Der Ressourcenname Zeichenfolge (erforderlich)
parent_id Die ID der Ressource, auf die diese Erweiterungsressource angewendet werden soll. Zeichenfolge (erforderlich)
Eigenschaften Ressourcenspezifische Eigenschaften der verwalteten Umgebung ManagedEnvironmentProperties
Schlagwörter Ressourcentags Wörterbuch der Tagnamen und -werte.
Typ Der Ressourcentyp "Microsoft.App/managedEnvironments@2025-01-01"

AppLogs-Konfiguration

Name BESCHREIBUNG Wert
Bestimmungsort Protokollziel, kann 'Log-Analytics', 'azure-monitor' oder 'none' sein. Schnur
logAnalyticsKonfiguration Log Analytics-Konfiguration muss nur bereitgestellt werden, wenn das Ziel als "Log-Analytics" konfiguriert ist. LogAnalyticsKonfiguration

CertificateKeyVault-Eigenschaften

Name BESCHREIBUNG Wert
Identität Ressourcen-ID einer verwalteten Identität zum Authentifizieren mit Azure Key Vault oder System zur Verwendung einer vom System zugewiesenen Identität. Schnur
keyVaultUrl DIE URL, die auf den geheimen Azure Key Vault-Schlüssel zeigt, der das Zertifikat enthält. Schnur

CustomDomainConfiguration

Name BESCHREIBUNG Wert
certificateKeyVault-Eigenschaften Zertifikat, das in Azure Key Vault gespeichert ist. CertificateKeyVault-Eigenschaften
certificatePasswort Zertifikatkennwort Zeichenfolge

Zwänge:
Vertraulicher Wert. Übergeben Als sicherer Parameter.
certificate-Wert PFX- oder PEM-Blob jegliche
dnsSuffix Dns-Suffix für die Umgebungsdomäne Schnur

DaprConfiguration

Name BESCHREIBUNG Wert

KedaKonfiguration

Name BESCHREIBUNG Wert

LogAnalyticsKonfiguration

Name BESCHREIBUNG Wert
Kunden-ID Protokollanalyse-Kunden-ID Schnur
gemeinsamerSchlüssel Log Analytics Customer Key Zeichenfolge

Zwänge:
Vertraulicher Wert. Übergeben Als sicherer Parameter.

ManagedEnvironmentProperties

Name BESCHREIBUNG Wert
appLogsKonfiguration Clusterkonfiguration, mit der der Protokolldaemon App-Protokolle in das konfigurierte Ziel exportieren kann. AppLogsConfiguration-
customDomainConfiguration Benutzerdefinierte Domänenkonfiguration für die Umgebung CustomDomainConfiguration-
daprAIConnectionString Application Insights-Verbindungszeichenfolge, die von Dapr zum Exportieren der Dienst-in-Dienst-Kommunikationstelemetrie verwendet wird Zeichenfolge

Zwänge:
Vertraulicher Wert. Übergeben Als sicherer Parameter.
daprAIInstrumentationKey Azure Monitor-Instrumentierungsschlüssel, der von Dapr zum Exportieren von Dienst-in-Dienst-Kommunikationstelemetrie verwendet wird Zeichenfolge

Zwänge:
Vertraulicher Wert. Übergeben Als sicherer Parameter.
daprConfiguration Die Konfiguration der Dapr-Komponente. DaprConfiguration
infrastructureResourceGroup Name der plattformverwalteten Ressourcengruppe, die für die verwaltete Umgebung zum Hosten von Infrastrukturressourcen erstellt wurde. Wenn eine Subnetz-ID angegeben wird, wird diese Ressourcengruppe im selben Abonnement wie das Subnetz erstellt. Schnur
kedaKonfiguration Die Konfiguration der Keda-Komponente. KedaKonfiguration
peer-Authentifizierung Peerauthentifizierungseinstellungen für die verwaltete Umgebung ManagedEnvironmentPropertiesPeerAuthentication
peerTraffic-Konfiguration Peer-Datenverkehrseinstellungen für die verwaltete Umgebung ManagedEnvironmentPropertiesPeerTrafficConfiguration
vnetConfiguration Vnet-Konfiguration für die Umgebung VnetConfiguration-
workload-Profile Workloadprofile, die für die verwaltete Umgebung konfiguriert sind. WorkloadProfile-[]
zoneRedundant Gibt an, ob diese verwaltete Umgebung zonenredundant ist. Boolesch

ManagedEnvironmentPropertiesPeerAuthentication

Name BESCHREIBUNG Wert
MTLS Einstellungen für die gegenseitige TLS-Authentifizierung für die verwaltete Umgebung Mtls

ManagedEnvironmentPropertiesPeerTrafficConfiguration

Name BESCHREIBUNG Wert
Verschlüsselung Verschlüsselungseinstellungen für Peerdatenverkehr für die verwaltete Umgebung ManagedEnvironmentPropertiesPeerTrafficConfigurationEncryption

ManagedEnvironmentPropertiesPeerTrafficConfigurationEncryption

Name BESCHREIBUNG Wert
aktiviert Boolescher Wert, der angibt, ob die Peerdatenverkehrverschlüsselung aktiviert ist Boolesch

Verwaltete Dienstidentität

Name BESCHREIBUNG Wert
Typ Typ der verwalteten Dienstidentität (wobei systemAssigned- und UserAssigned-Typen zulässig sind). "Keine"
'SystemZugewiesen'
"SystemAssigned,UserAssigned"
"UserAssigned" (erforderlich)
vom Benutzer zugewiesene Identitäten Die Gruppe der benutzerzuweisungen Identitäten, die der Ressource zugeordnet sind. Die Wörterbuchschlüssel "userAssignedIdentities" sind ARM-Ressourcen-IDs im Formular: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Die Wörterbuchwerte können leere Objekte ({}) in Anforderungen sein. UserAssignedIdentities-

Mtls

Name BESCHREIBUNG Wert
aktiviert Boolescher Wert, der angibt, ob die gegenseitige TLS-Authentifizierung aktiviert ist Boolesch

Verfolgte ResourceTags

Name BESCHREIBUNG Wert

UserAssignedIdentities

Name BESCHREIBUNG Wert

UserAssignedIdentity

Name BESCHREIBUNG Wert

VnetConfiguration

Name BESCHREIBUNG Wert
dockerBridgeCidr CIDR-Notation-IP-Bereich, der der Docker-Brücke, Netzwerk zugewiesen ist. Darf nicht mit anderen bereitgestellten IP-Bereichen überlappen. Schnur
infrastructureSubnetId Ressourcen-ID eines Subnetzes für Infrastrukturkomponenten. Darf nicht mit anderen bereitgestellten IP-Bereichen überlappen. Schnur
intern Boolescher Wert, der angibt, dass die Umgebung nur über einen internen Lastenausgleich verfügt. Diese Umgebungen verfügen nicht über eine öffentliche statische IP-Ressource. Sie müssen "infrastructureSubnetId" bereitstellen, wenn diese Eigenschaft aktiviert wird. Boolesch
PlattformReservedCidr IP-Bereich in CIDR-Notation, der für IP-Adressen der Umgebungsinfrastruktur reserviert werden kann. Darf nicht mit anderen bereitgestellten IP-Bereichen überlappen. Schnur
platformReservedDnsIP Eine IP-Adresse aus dem durch platformReservedCidr definierten IP-Bereich, der für den internen DNS-Server reserviert wird. Schnur

Workload-Profil

Name BESCHREIBUNG Wert
maximumCount Die maximale Kapazität. Int
minimumCount Die Mindestkapazität. Int
Name Workload-Profiltyp für die Workloads, auf denen ausgeführt werden soll. Zeichenfolge (erforderlich)
workloadProfileType Workload-Profiltyp für die Workloads, auf denen ausgeführt werden soll. Zeichenfolge (erforderlich)

Verwendungsbeispiele

Terraform-Beispiele

Ein grundlegendes Beispiel für die Bereitstellung von Container App Environment.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "workspace" {
  type      = "Microsoft.OperationalInsights/workspaces@2022-10-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      features = {
        disableLocalAuth                            = false
        enableLogAccessUsingOnlyResourcePermissions = true
      }
      publicNetworkAccessForIngestion = "Enabled"
      publicNetworkAccessForQuery     = "Enabled"
      retentionInDays                 = 30
      sku = {
        name = "PerGB2018"
      }
      workspaceCapping = {
        dailyQuotaGb = -1
      }
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

data "azapi_resource_action" "sharedKeys" {
  type                   = "Microsoft.OperationalInsights/workspaces@2020-08-01"
  resource_id            = azapi_resource.workspace.id
  action                 = "sharedKeys"
  response_export_values = ["*"]
}

resource "azapi_resource" "managedEnvironment" {
  type      = "Microsoft.App/managedEnvironments@2022-03-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      appLogsConfiguration = {
        destination = "log-analytics"
        logAnalyticsConfiguration = {
          customerId = azapi_resource.workspace.output.properties.customerId
          sharedKey  = data.azapi_resource_action.sharedKeys.output.primarySharedKey
        }
      }
      vnetConfiguration = {
      }
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

Von Azure verifizierte Module

Die folgenden Azure Verified Modules können verwendet werden, um diesen Ressourcentyp bereitzustellen.

Modul BESCHREIBUNG
verwaltete App-Umgebung AVM-Ressourcenmodul für verwaltete App-Umgebung