Freigeben über


Microsoft.App managedEnvironments 2022-03-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@2022-03-01' = {
  scope: resourceSymbolicName or scope
  location: 'string'
  name: 'string'
  properties: {
    appLogsConfiguration: {
      destination: 'string'
      logAnalyticsConfiguration: {
        customerId: 'string'
        sharedKey: 'string'
      }
    }
    daprAIConnectionString: 'string'
    daprAIInstrumentationKey: 'string'
    vnetConfiguration: {
      dockerBridgeCidr: 'string'
      infrastructureSubnetId: 'string'
      internal: bool
      platformReservedCidr: 'string'
      platformReservedDnsIP: 'string'
      runtimeSubnetId: 'string'
    }
    zoneRedundant: bool
  }
  tags: {
    {customized property}: 'string'
  }
}

Eigenschaftswerte

Microsoft.App/verwalteteUmgebungen

Name BESCHREIBUNG Wert
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 Ressourcenetiketten Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen

AppLogs-Konfiguration

Name BESCHREIBUNG Wert
Reiseziel 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

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-
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.
vnetConfiguration Vnet-Konfiguration für die Umgebung VnetConfiguration-
zoneRedundant Gibt an, ob diese verwaltete Umgebung zonenredundant ist. Boolesch

Verfolgte ResourceTags

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. Dieses Subnetz muss sich im selben VNET wie das subnetz befinden, das in "runtimeSubnetId" definiert ist. 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 "runtimeSubnetId" und "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
runtimeSubnetId Dieses Feld ist veraltet und wird nicht verwendet. Wenn Sie Ihr eigenes Subnetz bereitstellen möchten, in das Container-App-Container eingefügt werden, sollten Sie die infrastructureSubnetId nutzen. Schnur

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 Registrierung 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": "2022-03-01",
  "name": "string",
  "location": "string",
  "properties": {
    "appLogsConfiguration": {
      "destination": "string",
      "logAnalyticsConfiguration": {
        "customerId": "string",
        "sharedKey": "string"
      }
    },
    "daprAIConnectionString": "string",
    "daprAIInstrumentationKey": "string",
    "vnetConfiguration": {
      "dockerBridgeCidr": "string",
      "infrastructureSubnetId": "string",
      "internal": "bool",
      "platformReservedCidr": "string",
      "platformReservedDnsIP": "string",
      "runtimeSubnetId": "string"
    },
    "zoneRedundant": "bool"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Eigenschaftswerte

Microsoft.App/verwalteteUmgebungen

Name BESCHREIBUNG Wert
apiVersion (Englisch) Die API-Version '2022-03-01'
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 Ressourcenetiketten Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen
Typ Der Ressourcentyp "Microsoft.App/managedEnvironments"

AppLogs-Konfiguration

Name BESCHREIBUNG Wert
Reiseziel 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

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-
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.
vnetConfiguration Vnet-Konfiguration für die Umgebung VnetConfiguration-
zoneRedundant Gibt an, ob diese verwaltete Umgebung zonenredundant ist. Boolesch

Verfolgte ResourceTags

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. Dieses Subnetz muss sich im selben VNET wie das subnetz befinden, das in "runtimeSubnetId" definiert ist. 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 "runtimeSubnetId" und "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
runtimeSubnetId Dieses Feld ist veraltet und wird nicht verwendet. Wenn Sie Ihr eigenes Subnetz bereitstellen möchten, in das Container-App-Container eingefügt werden, sollten Sie die infrastructureSubnetId nutzen. Schnur

Verwendungsbeispiele

Azure-Schnellstartvorlagen

Die folgenden Azure-Schnellstartvorlagen diesen Ressourcentyp bereitstellen.

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

Bereitstellung 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

Bereitstellung 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

Bereitstellung 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

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

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

Bereitstellung 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

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

Bereitstellung 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@2022-03-01"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      appLogsConfiguration = {
        destination = "string"
        logAnalyticsConfiguration = {
          customerId = "string"
          sharedKey = "string"
        }
      }
      daprAIConnectionString = "string"
      daprAIInstrumentationKey = "string"
      vnetConfiguration = {
        dockerBridgeCidr = "string"
        infrastructureSubnetId = "string"
        internal = bool
        platformReservedCidr = "string"
        platformReservedDnsIP = "string"
        runtimeSubnetId = "string"
      }
      zoneRedundant = bool
    }
  }
}

Eigenschaftswerte

Microsoft.App/verwalteteUmgebungen

Name BESCHREIBUNG Wert
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 Ressourcenetiketten Wörterbuch der Tagnamen und -werte.
Typ Der Ressourcentyp "Microsoft.App/managedEnvironments@2022-03-01"

AppLogs-Konfiguration

Name BESCHREIBUNG Wert
Reiseziel 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

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-
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.
vnetConfiguration Vnet-Konfiguration für die Umgebung VnetConfiguration-
zoneRedundant Gibt an, ob diese verwaltete Umgebung zonenredundant ist. Boolesch

Verfolgte ResourceTags

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. Dieses Subnetz muss sich im selben VNET wie das subnetz befinden, das in "runtimeSubnetId" definiert ist. 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 "runtimeSubnetId" und "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
runtimeSubnetId Dieses Feld ist veraltet und wird nicht verwendet. Wenn Sie Ihr eigenes Subnetz bereitstellen möchten, in das Container-App-Container eingefügt werden, sollten Sie die infrastructureSubnetId nutzen. Schnur

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