Microsoft.AppPlatform Spring/apps/deployments 2022-05-01-preview

Anmärkningar

Obs: Azure Spring Apps Application Deployments (Microsoft.AppPlatform/Spring/apps/deployments) är nu föråldrade och kommer att tas ur bruk den 31 maj 2028. Mer information finns i https://aka.ms/asaretirement.

Bicep-resursdefinition

Resurstypen Spring/apps/deployments kan distribueras med åtgärder som mål:

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Resursformat

För att skapa en Microsoft.AppPlatform/Spring/apps/deployments-resurs, lägg till följande Bicep i din mall.

resource symbolicname 'Microsoft.AppPlatform/Spring/apps/deployments@2022-05-01-preview' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    active: bool
    deploymentSettings: {
      addonConfigs: {
        {customized property}: {
          {customized property}: any(...)
        }
      }
      containerProbeSettings: {
        disableProbe: bool
      }
      environmentVariables: {
        {customized property}: 'string'
      }
      livenessProbe: {
        disableProbe: bool
        failureThreshold: int
        initialDelaySeconds: int
        periodSeconds: int
        probeAction: {
          type: 'string'
          // For remaining properties, see ProbeAction objects
        }
        successThreshold: int
        timeoutSeconds: int
      }
      readinessProbe: {
        disableProbe: bool
        failureThreshold: int
        initialDelaySeconds: int
        periodSeconds: int
        probeAction: {
          type: 'string'
          // For remaining properties, see ProbeAction objects
        }
        successThreshold: int
        timeoutSeconds: int
      }
      resourceRequests: {
        cpu: 'string'
        memory: 'string'
      }
      startupProbe: {
        disableProbe: bool
        failureThreshold: int
        initialDelaySeconds: int
        periodSeconds: int
        probeAction: {
          type: 'string'
          // For remaining properties, see ProbeAction objects
        }
        successThreshold: int
        timeoutSeconds: int
      }
      terminationGracePeriodSeconds: int
    }
    source: {
      version: 'string'
      type: 'string'
      // For remaining properties, see UserSourceInfo objects
    }
  }
  sku: {
    capacity: int
    name: 'string'
    tier: 'string'
  }
}

UserSourceInfo-objekt

Ange egenskapen typ för att ange typ av objekt.

För BuildResult-använder du:

{
  buildResultId: 'string'
  type: 'BuildResult'
}

För Containeranvänder du:

{
  customContainer: {
    args: [
      'string'
    ]
    command: [
      'string'
    ]
    containerImage: 'string'
    imageRegistryCredential: {
      password: 'string'
      username: 'string'
    }
    languageFramework: 'string'
    server: 'string'
  }
  type: 'Container'
}

För Jaranvänder du:

{
  jvmOptions: 'string'
  relativePath: 'string'
  runtimeVersion: 'string'
  type: 'Jar'
}

För NetCoreZipanvänder du:

{
  netCoreMainEntryPath: 'string'
  relativePath: 'string'
  runtimeVersion: 'string'
  type: 'NetCoreZip'
}

För Källa använder du:

{
  artifactSelector: 'string'
  relativePath: 'string'
  runtimeVersion: 'string'
  type: 'Source'
}

ProbeAction-objekt

Ange egenskapen typ för att ange typ av objekt.

För ExecActionanvänder du:

{
  command: [
    'string'
  ]
  type: 'ExecAction'
}

För HTTPGetAction-använder du:

{
  path: 'string'
  scheme: 'string'
  type: 'HTTPGetAction'
}

För TCPSocketAction-använder du:

{
  type: 'TCPSocketAction'
}

Egenskapsvärden

Microsoft.AppPlatform/Spring/apps/deployments

Namn Beskrivning Värde
namn Resursnamnet sträng (krävs)
förälder I Bicep kan du ange föräldraresursen för en barnresurs. Du behöver bara lägga till den här egenskapen när den underordnade resursen deklareras utanför den överordnade resursen.

Mer information finns i Underordnad resurs utanför den överordnade resursen.
Symboliskt namn för resurs av typen: Spring/apps
egenskaper Egenskaper för distributionsresursen DeploymentResourceProperties (DistributionResourceProperties)
Sku SKU för distributionsresursen Sku

AddonProfil

Namn Beskrivning Värde

BuildResultUserSourceInfo (på engelska)

Namn Beskrivning Värde
buildResultId Resurs-ID för ett befintligt slutfört byggresultat under samma Spring-instans. snöre
typ Typ av källa som laddats upp "BuildResult" (krävs)

ContainerProbeSettings (på engelska)

Namn Beskrivning Värde
disableProbe (på engelska) Anger om du inaktiverar live- och beredskapsavsökningen Bool

CustomContainer (på engelska)

Namn Beskrivning Värde
args args Argument till startpunkten. Docker-avbildningens CMD används om detta inte anges. sträng[]
kommando Startpunktsmatris. Körs inte i ett gränssnitt. Docker-avbildningens ENTRYPOINT används om detta inte anges. sträng[]
containerImage Containeravbildning av den anpassade containern. Detta bör vara i form av <lagringsplats>:<tagg> utan registrets servernamn snöre
imageRegistryCredential Autentiseringsuppgifter för avbildningsregistret ImageRegistryCredential (på engelska)
språkramverk Språkramverk för containeravbildningen som laddats upp snöre
server Namnet på registret som innehåller containeravbildningen snöre

CustomContainerUserSourceInfo (på engelska)

Namn Beskrivning Värde
customContainer (anpassad) Nyttolast för anpassad container CustomContainer (på engelska)
typ Typ av källa som laddats upp "Container" (krävs)

DeploymentResourceProperties (DistributionResourceProperties)

Namn Beskrivning Värde
aktiv Anger om distributionen är aktiv Bool
inställningar för distribution Distributionsinställningar för distributionen DistributionInställningar
källa Uppladdad källinformation för distributionen. UserSourceInfo (på engelska)

DistributionInställningar

Namn Beskrivning Värde
addonConfigs Samling med tillägg DeploymentSettingsAddonConfigs
containerProbeSettings (på engelska) Inställningar för containerbehåll och beredskapsavsökning ContainerProbeSettings (på engelska)
miljövariabler Samling miljövariabler DeploymentSettingsEnvironmentVariables (DistributionSettingsEnvironmentVariabler)
livenessProbe Periodisk avsökning av appinstansens liveness. Appinstansen startas om om avsökningen misslyckas. Mer information: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes avsökning
beredskapSond Periodisk avsökning av appinstanstjänstens beredskap. App instance tas bort från tjänstslutpunkter om avsökningen misslyckas. Mer information: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes avsökning
resourceRequests (på engelska) Den begärda resurskvantiteten för nödvändig processor och minne. Vi rekommenderar att du använder det här fältet för att representera den processor och det minne som krävs, att den gamla fältprocessorn och minnetInGB kommer att bli inaktuella senare. ResourceRequests (på engelska)
startupProbe (starta) StartupProbe anger att appinstansen har initierats. Om det anges körs inga andra avsökningar förrän det har slutförts. Om den här avsökningen misslyckas startas podden om, precis som om livenessProbe misslyckades. Detta kan användas för att tillhandahålla olika avsökningsparametrar i början av en appinstans livscykel, när det kan ta lång tid att läsa in data eller värma en cache, än under åtgärden för stabilt tillstånd. Det går inte att uppdatera detta. Mer information: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes avsökning
terminationGracePeriodSeconds Valfri varaktighet i sekunder appinstansen måste avslutas korrekt. Kan minskas i borttagningsbegäran. Värdet måste vara ett heltal som inte är negativt. Värdet noll anger stopp direkt via avlivningssignalen (ingen möjlighet att stänga av). Om det här värdet är noll används standard respitperioden i stället. Respitperioden är varaktigheten i sekunder efter att processerna som körs i appinstansen har skickats en avslutningssignal och den tid då processerna med två skäl stoppas med en kill-signal. Ange det här värdet längre än den förväntade rensningstiden för din process. Standardvärdet är 90 sekunder. Int

DeploymentSettingsAddonConfigs

Namn Beskrivning Värde

DeploymentSettingsEnvironmentVariables (DistributionSettingsEnvironmentVariabler)

Namn Beskrivning Värde

ExecAction

Namn Beskrivning Värde
kommando Kommandot är kommandoraden som ska köras i containern. Arbetskatalogen för kommandot är rot ('/') i containerns filsystem. Kommandot körs inte i ett gränssnitt, så traditionella gränssnittsinstruktioner (|) fungerar inte. Om du vill använda ett gränssnitt måste du uttryckligen anropa gränssnittet. Utgångsstatusen 0 behandlas som live/felfri och icke-noll är inte felfri. sträng[]
typ Vilken typ av åtgärd som ska vidtas för att utföra hälsokontrollen. "ExecAction" (krävs)

HttpGetAction (på engelska)

Namn Beskrivning Värde
väg Sökväg till åtkomst på HTTP-servern. snöre
schema Schema som ska användas för att ansluta till värden. Standardvärdet är HTTP.

Möjliga uppräkningsvärden:
- "HTTP" innebär att det system som används kommer att http://
- "HTTPS" innebär att det system som används kommer att https://
"HTTP"
"HTTPS"
typ Vilken typ av åtgärd som ska vidtas för att utföra hälsokontrollen. "HTTPGetAction" (krävs)

ImageRegistryCredential (på engelska)

Namn Beskrivning Värde
lösenord Lösenordet för avbildningsregistrets autentiseringsuppgifter snöre
användarnamn Användarnamnet för avbildningsregistrets autentiseringsuppgifter snöre

JarUploadedUserSourceInfo

Namn Beskrivning Värde
jvmOptions JVM-parameter snöre
relativePath Relativ sökväg för lagringen som lagrar källan snöre
runtimeVersion Körningsversion av Jar-filen snöre
typ Typ av källa som laddats upp "Jar" (krävs)

NetCoreZipUploadedUserSourceInfo

Namn Beskrivning Värde
netCoreMainEntryPath Vägen till .NET-exekverbara filen i förhållande till zip-roten snöre
relativePath Relativ sökväg för lagringen som lagrar källan snöre
runtimeVersion Körningsversion av .Net-filen snöre
typ Typ av källa som laddats upp "NetCoreZip" (krävs)

Sond

Namn Beskrivning Värde
disableProbe (på engelska) Ange om avsökningen är inaktiverad. bool (krävs)
failureThreshold (på engelska) Minsta på varandra följande fel för avsökningen som ska betraktas som misslyckad efter att ha lyckats. Minimivärdet är 1. Int
initialDelaySeconds Antal sekunder efter att appinstansen har startats innan avsökningar initieras. Mer information: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes Int
periodsekunder Hur ofta (i sekunder) avsökningen ska utföras. Minimivärdet är 1. Int
sondAction (på engelska) Avsökningens åtgärd. SondAction (på engelska)
framgångströskel Minsta lyckade resultat i följd för att avsökningen ska anses vara lyckad efter att den har misslyckats. Måste vara 1 för liveness och start. Minimivärdet är 1. Int
timeoutSekunder Antal sekunder efter vilken avsökningen överskrider tidsgränsen. Minimivärdet är 1. Int

SondAction (på engelska)

Namn Beskrivning Värde
typ Ange till ExecAction för typ ExecAction. Ange till HTTPGetAction för typen HttpGetAction. Ange TCPSocketAction för typen TCPSocketAction. "ExecAction"
"HTTPGetAction"
"TCPSocketAction" (krävs)

ResourceRequests (på engelska)

Namn Beskrivning Värde
CPU Nödvändig PROCESSOR. 1 kärna kan representeras av 1 eller 1 000 m. Detta bör vara 500m eller 1 för Basic-nivån och {500m, 1, 2, 3, 4} för Standard-nivån. snöre
minne Minne som krävs. 1 GB kan representeras av 1Gi eller 1024Mi. Detta bör vara {512Mi, 1Gi, 2Gi} för Basic-nivån och {512Mi, 1Gi, 2Gi, ..., 8Gi} för standardnivån. snöre

Sku

Namn Beskrivning Värde
kapacitet Målresursens aktuella kapacitet Int
namn SKU:ns namn snöre
nivå Nivå för SKU:n snöre

SourceUploadedUserSourceInfo (på engelska)

Namn Beskrivning Värde
artefakt Selector Väljare för artefakten som ska användas för distributionen för projekt med flera moduler. Detta bör vara
den relativa sökvägen till målmodulen/projektet.
snöre
relativePath Relativ sökväg för lagringen som lagrar källan snöre
runtimeVersion Körningsversion av källfilen snöre
typ Typ av källa som laddats upp "Källa" (krävs)

TCPSocketAction

Namn Beskrivning Värde
typ Vilken typ av åtgärd som ska vidtas för att utföra hälsokontrollen. "TCPSocketAction" (krävs)

UserSourceInfo (på engelska)

Namn Beskrivning Värde
typ Ange till BuildResult för typen BuildResultUserSourceInfo. Ange till Container för typen CustomContainerUserSourceInfo. Ange till Jar för typ JarUploadedUserSourceInfo. Ange till "NetCoreZip" för typen NetCoreZipUploadedUserSourceInfo. Ange till "Källa" för typen SourceUploadedUserSourceInfo. "BuildResult"
"Container"
"Jar"
"NetCoreZip"
"Källa" (krävs)
version Version av källan snöre

Användningsexempel

Bicep-prover

Ett grundläggande exempel på distribution av Spring Cloud Deployment.

param resourceName string = 'acctest0001'
param location string = 'westeurope'

resource spring 'Microsoft.AppPlatform/Spring@2023-05-01-preview' = {
  name: resourceName
  location: location
  properties: {
    zoneRedundant: false
  }
  sku: {
    name: 'E0'
  }
}

resource app 'Microsoft.AppPlatform/Spring/apps@2023-05-01-preview' = {
  parent: spring
  name: resourceName
  location: location
  properties: {
    customPersistentDisks: []
    enableEndToEndTLS: false
    public: false
  }
}

resource deployment 'Microsoft.AppPlatform/Spring/apps/deployments@2023-05-01-preview' = {
  parent: app
  name: resourceName
  properties: {
    deploymentSettings: {
      environmentVariables: {}
    }
    source: {
      customContainer: {
        args: []
        command: []
        containerImage: 'springio/gs-spring-boot-docker'
        languageFramework: ''
        server: 'docker.io'
      }
      type: 'Container'
    }
  }
  sku: {
    capacity: 1
    name: 'E0'
    tier: 'Enterprise'
  }
}

Azure Quickstart Samples

Följande Azure Quickstart-mallar innehåller Bicep exempel för att distribuera denna resurstyp.

Bicep-fil Beskrivning
Distribuera en enkel Azure Spring Apps mikrotjänstapplikation Denna mall distribuerar en enkel Azure Spring Apps-mikrotjänstapplikation för att köras på Azure.

Resursdefinition för ARM-mall

Resurstypen Spring/apps/deployments kan distribueras med åtgärder som mål:

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Resursformat

Om du vill skapa en Microsoft.AppPlatform/Spring/apps/deployments-resurs lägger du till följande JSON i mallen.

{
  "type": "Microsoft.AppPlatform/Spring/apps/deployments",
  "apiVersion": "2022-05-01-preview",
  "name": "string",
  "properties": {
    "active": "bool",
    "deploymentSettings": {
      "addonConfigs": {
        "{customized property}": {
          "{customized property}": {}
        }
      },
      "containerProbeSettings": {
        "disableProbe": "bool"
      },
      "environmentVariables": {
        "{customized property}": "string"
      },
      "livenessProbe": {
        "disableProbe": "bool",
        "failureThreshold": "int",
        "initialDelaySeconds": "int",
        "periodSeconds": "int",
        "probeAction": {
          "type": "string"
          // For remaining properties, see ProbeAction objects
        },
        "successThreshold": "int",
        "timeoutSeconds": "int"
      },
      "readinessProbe": {
        "disableProbe": "bool",
        "failureThreshold": "int",
        "initialDelaySeconds": "int",
        "periodSeconds": "int",
        "probeAction": {
          "type": "string"
          // For remaining properties, see ProbeAction objects
        },
        "successThreshold": "int",
        "timeoutSeconds": "int"
      },
      "resourceRequests": {
        "cpu": "string",
        "memory": "string"
      },
      "startupProbe": {
        "disableProbe": "bool",
        "failureThreshold": "int",
        "initialDelaySeconds": "int",
        "periodSeconds": "int",
        "probeAction": {
          "type": "string"
          // For remaining properties, see ProbeAction objects
        },
        "successThreshold": "int",
        "timeoutSeconds": "int"
      },
      "terminationGracePeriodSeconds": "int"
    },
    "source": {
      "version": "string",
      "type": "string"
      // For remaining properties, see UserSourceInfo objects
    }
  },
  "sku": {
    "capacity": "int",
    "name": "string",
    "tier": "string"
  }
}

UserSourceInfo-objekt

Ange egenskapen typ för att ange typ av objekt.

För BuildResult-använder du:

{
  "buildResultId": "string",
  "type": "BuildResult"
}

För Containeranvänder du:

{
  "customContainer": {
    "args": [ "string" ],
    "command": [ "string" ],
    "containerImage": "string",
    "imageRegistryCredential": {
      "password": "string",
      "username": "string"
    },
    "languageFramework": "string",
    "server": "string"
  },
  "type": "Container"
}

För Jaranvänder du:

{
  "jvmOptions": "string",
  "relativePath": "string",
  "runtimeVersion": "string",
  "type": "Jar"
}

För NetCoreZipanvänder du:

{
  "netCoreMainEntryPath": "string",
  "relativePath": "string",
  "runtimeVersion": "string",
  "type": "NetCoreZip"
}

För Källa använder du:

{
  "artifactSelector": "string",
  "relativePath": "string",
  "runtimeVersion": "string",
  "type": "Source"
}

ProbeAction-objekt

Ange egenskapen typ för att ange typ av objekt.

För ExecActionanvänder du:

{
  "command": [ "string" ],
  "type": "ExecAction"
}

För HTTPGetAction-använder du:

{
  "path": "string",
  "scheme": "string",
  "type": "HTTPGetAction"
}

För TCPSocketAction-använder du:

{
  "type": "TCPSocketAction"
}

Egenskapsvärden

Microsoft.AppPlatform/Spring/apps/deployments

Namn Beskrivning Värde
apiVersion API-versionen "2022-05-01-preview"
namn Resursnamnet sträng (krävs)
egenskaper Egenskaper för distributionsresursen DeploymentResourceProperties (DistributionResourceProperties)
Sku SKU för distributionsresursen Sku
typ Resurstypen "Microsoft.AppPlatform/Spring/apps/deployments"

AddonProfil

Namn Beskrivning Värde

BuildResultUserSourceInfo (på engelska)

Namn Beskrivning Värde
buildResultId Resurs-ID för ett befintligt slutfört byggresultat under samma Spring-instans. snöre
typ Typ av källa som laddats upp "BuildResult" (krävs)

ContainerProbeSettings (på engelska)

Namn Beskrivning Värde
disableProbe (på engelska) Anger om du inaktiverar live- och beredskapsavsökningen Bool

CustomContainer (på engelska)

Namn Beskrivning Värde
args args Argument till startpunkten. Docker-avbildningens CMD används om detta inte anges. sträng[]
kommando Startpunktsmatris. Körs inte i ett gränssnitt. Docker-avbildningens ENTRYPOINT används om detta inte anges. sträng[]
containerImage Containeravbildning av den anpassade containern. Detta bör vara i form av <lagringsplats>:<tagg> utan registrets servernamn snöre
imageRegistryCredential Autentiseringsuppgifter för avbildningsregistret ImageRegistryCredential (på engelska)
språkramverk Språkramverk för containeravbildningen som laddats upp snöre
server Namnet på registret som innehåller containeravbildningen snöre

CustomContainerUserSourceInfo (på engelska)

Namn Beskrivning Värde
customContainer (anpassad) Nyttolast för anpassad container CustomContainer (på engelska)
typ Typ av källa som laddats upp "Container" (krävs)

DeploymentResourceProperties (DistributionResourceProperties)

Namn Beskrivning Värde
aktiv Anger om distributionen är aktiv Bool
inställningar för distribution Distributionsinställningar för distributionen DistributionInställningar
källa Uppladdad källinformation för distributionen. UserSourceInfo (på engelska)

DistributionInställningar

Namn Beskrivning Värde
addonConfigs Samling med tillägg DeploymentSettingsAddonConfigs
containerProbeSettings (på engelska) Inställningar för containerbehåll och beredskapsavsökning ContainerProbeSettings (på engelska)
miljövariabler Samling miljövariabler DeploymentSettingsEnvironmentVariables (DistributionSettingsEnvironmentVariabler)
livenessProbe Periodisk avsökning av appinstansens liveness. Appinstansen startas om om avsökningen misslyckas. Mer information: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes avsökning
beredskapSond Periodisk avsökning av appinstanstjänstens beredskap. App instance tas bort från tjänstslutpunkter om avsökningen misslyckas. Mer information: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes avsökning
resourceRequests (på engelska) Den begärda resurskvantiteten för nödvändig processor och minne. Vi rekommenderar att du använder det här fältet för att representera den processor och det minne som krävs, att den gamla fältprocessorn och minnetInGB kommer att bli inaktuella senare. ResourceRequests (på engelska)
startupProbe (starta) StartupProbe anger att appinstansen har initierats. Om det anges körs inga andra avsökningar förrän det har slutförts. Om den här avsökningen misslyckas startas podden om, precis som om livenessProbe misslyckades. Detta kan användas för att tillhandahålla olika avsökningsparametrar i början av en appinstans livscykel, när det kan ta lång tid att läsa in data eller värma en cache, än under åtgärden för stabilt tillstånd. Det går inte att uppdatera detta. Mer information: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes avsökning
terminationGracePeriodSeconds Valfri varaktighet i sekunder appinstansen måste avslutas korrekt. Kan minskas i borttagningsbegäran. Värdet måste vara ett heltal som inte är negativt. Värdet noll anger stopp direkt via avlivningssignalen (ingen möjlighet att stänga av). Om det här värdet är noll används standard respitperioden i stället. Respitperioden är varaktigheten i sekunder efter att processerna som körs i appinstansen har skickats en avslutningssignal och den tid då processerna med två skäl stoppas med en kill-signal. Ange det här värdet längre än den förväntade rensningstiden för din process. Standardvärdet är 90 sekunder. Int

DeploymentSettingsAddonConfigs

Namn Beskrivning Värde

DeploymentSettingsEnvironmentVariables (DistributionSettingsEnvironmentVariabler)

Namn Beskrivning Värde

ExecAction

Namn Beskrivning Värde
kommando Kommandot är kommandoraden som ska köras i containern. Arbetskatalogen för kommandot är rot ('/') i containerns filsystem. Kommandot körs inte i ett gränssnitt, så traditionella gränssnittsinstruktioner (|) fungerar inte. Om du vill använda ett gränssnitt måste du uttryckligen anropa gränssnittet. Utgångsstatusen 0 behandlas som live/felfri och icke-noll är inte felfri. sträng[]
typ Vilken typ av åtgärd som ska vidtas för att utföra hälsokontrollen. "ExecAction" (krävs)

HttpGetAction (på engelska)

Namn Beskrivning Värde
väg Sökväg till åtkomst på HTTP-servern. snöre
schema Schema som ska användas för att ansluta till värden. Standardvärdet är HTTP.

Möjliga uppräkningsvärden:
- "HTTP" innebär att det system som används kommer att http://
- "HTTPS" innebär att det system som används kommer att https://
"HTTP"
"HTTPS"
typ Vilken typ av åtgärd som ska vidtas för att utföra hälsokontrollen. "HTTPGetAction" (krävs)

ImageRegistryCredential (på engelska)

Namn Beskrivning Värde
lösenord Lösenordet för avbildningsregistrets autentiseringsuppgifter snöre
användarnamn Användarnamnet för avbildningsregistrets autentiseringsuppgifter snöre

JarUploadedUserSourceInfo

Namn Beskrivning Värde
jvmOptions JVM-parameter snöre
relativePath Relativ sökväg för lagringen som lagrar källan snöre
runtimeVersion Körningsversion av Jar-filen snöre
typ Typ av källa som laddats upp "Jar" (krävs)

NetCoreZipUploadedUserSourceInfo

Namn Beskrivning Värde
netCoreMainEntryPath Vägen till .NET-exekverbara filen i förhållande till zip-roten snöre
relativePath Relativ sökväg för lagringen som lagrar källan snöre
runtimeVersion Körningsversion av .Net-filen snöre
typ Typ av källa som laddats upp "NetCoreZip" (krävs)

Sond

Namn Beskrivning Värde
disableProbe (på engelska) Ange om avsökningen är inaktiverad. bool (krävs)
failureThreshold (på engelska) Minsta på varandra följande fel för avsökningen som ska betraktas som misslyckad efter att ha lyckats. Minimivärdet är 1. Int
initialDelaySeconds Antal sekunder efter att appinstansen har startats innan avsökningar initieras. Mer information: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes Int
periodsekunder Hur ofta (i sekunder) avsökningen ska utföras. Minimivärdet är 1. Int
sondAction (på engelska) Avsökningens åtgärd. SondAction (på engelska)
framgångströskel Minsta lyckade resultat i följd för att avsökningen ska anses vara lyckad efter att den har misslyckats. Måste vara 1 för liveness och start. Minimivärdet är 1. Int
timeoutSekunder Antal sekunder efter vilken avsökningen överskrider tidsgränsen. Minimivärdet är 1. Int

SondAction (på engelska)

Namn Beskrivning Värde
typ Ange till ExecAction för typ ExecAction. Ange till HTTPGetAction för typen HttpGetAction. Ange TCPSocketAction för typen TCPSocketAction. "ExecAction"
"HTTPGetAction"
"TCPSocketAction" (krävs)

ResourceRequests (på engelska)

Namn Beskrivning Värde
CPU Nödvändig PROCESSOR. 1 kärna kan representeras av 1 eller 1 000 m. Detta bör vara 500m eller 1 för Basic-nivån och {500m, 1, 2, 3, 4} för Standard-nivån. snöre
minne Minne som krävs. 1 GB kan representeras av 1Gi eller 1024Mi. Detta bör vara {512Mi, 1Gi, 2Gi} för Basic-nivån och {512Mi, 1Gi, 2Gi, ..., 8Gi} för standardnivån. snöre

Sku

Namn Beskrivning Värde
kapacitet Målresursens aktuella kapacitet Int
namn SKU:ns namn snöre
nivå Nivå för SKU:n snöre

SourceUploadedUserSourceInfo (på engelska)

Namn Beskrivning Värde
artefakt Selector Väljare för artefakten som ska användas för distributionen för projekt med flera moduler. Detta bör vara
den relativa sökvägen till målmodulen/projektet.
snöre
relativePath Relativ sökväg för lagringen som lagrar källan snöre
runtimeVersion Körningsversion av källfilen snöre
typ Typ av källa som laddats upp "Källa" (krävs)

TCPSocketAction

Namn Beskrivning Värde
typ Vilken typ av åtgärd som ska vidtas för att utföra hälsokontrollen. "TCPSocketAction" (krävs)

UserSourceInfo (på engelska)

Namn Beskrivning Värde
typ Ange till BuildResult för typen BuildResultUserSourceInfo. Ange till Container för typen CustomContainerUserSourceInfo. Ange till Jar för typ JarUploadedUserSourceInfo. Ange till "NetCoreZip" för typen NetCoreZipUploadedUserSourceInfo. Ange till "Källa" för typen SourceUploadedUserSourceInfo. "BuildResult"
"Container"
"Jar"
"NetCoreZip"
"Källa" (krävs)
version Version av källan snöre

Användningsexempel

Azure snabbstartsmallar

Följande Azure Quickstart-mallar distribuerar denna resurstyp.

Mall Beskrivning
Distribuera en enkel Azure Spring Apps mikrotjänstapplikation

Distribuera till Azure
Denna mall distribuerar en enkel Azure Spring Apps-mikrotjänstapplikation för att köras på Azure.

Resursdefinition för Terraform (AzAPI-provider)

Resurstypen Spring/apps/deployments kan distribueras med åtgärder som mål:

  • Resursgrupper

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Resursformat

Om du vill skapa en Microsoft.AppPlatform/Spring/apps/deployments-resurs lägger du till följande Terraform i mallen.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.AppPlatform/Spring/apps/deployments@2022-05-01-preview"
  name = "string"
  parent_id = "string"
  body = {
    properties = {
      active = bool
      deploymentSettings = {
        addonConfigs = {
          {customized property} = {
            {customized property} = ?
          }
        }
        containerProbeSettings = {
          disableProbe = bool
        }
        environmentVariables = {
          {customized property} = "string"
        }
        livenessProbe = {
          disableProbe = bool
          failureThreshold = int
          initialDelaySeconds = int
          periodSeconds = int
          probeAction = {
            type = "string"
            // For remaining properties, see ProbeAction objects
          }
          successThreshold = int
          timeoutSeconds = int
        }
        readinessProbe = {
          disableProbe = bool
          failureThreshold = int
          initialDelaySeconds = int
          periodSeconds = int
          probeAction = {
            type = "string"
            // For remaining properties, see ProbeAction objects
          }
          successThreshold = int
          timeoutSeconds = int
        }
        resourceRequests = {
          cpu = "string"
          memory = "string"
        }
        startupProbe = {
          disableProbe = bool
          failureThreshold = int
          initialDelaySeconds = int
          periodSeconds = int
          probeAction = {
            type = "string"
            // For remaining properties, see ProbeAction objects
          }
          successThreshold = int
          timeoutSeconds = int
        }
        terminationGracePeriodSeconds = int
      }
      source = {
        version = "string"
        type = "string"
        // For remaining properties, see UserSourceInfo objects
      }
    }
    sku = {
      capacity = int
      name = "string"
      tier = "string"
    }
  }
}

UserSourceInfo-objekt

Ange egenskapen typ för att ange typ av objekt.

För BuildResult-använder du:

{
  buildResultId = "string"
  type = "BuildResult"
}

För Containeranvänder du:

{
  customContainer = {
    args = [
      "string"
    ]
    command = [
      "string"
    ]
    containerImage = "string"
    imageRegistryCredential = {
      password = "string"
      username = "string"
    }
    languageFramework = "string"
    server = "string"
  }
  type = "Container"
}

För Jaranvänder du:

{
  jvmOptions = "string"
  relativePath = "string"
  runtimeVersion = "string"
  type = "Jar"
}

För NetCoreZipanvänder du:

{
  netCoreMainEntryPath = "string"
  relativePath = "string"
  runtimeVersion = "string"
  type = "NetCoreZip"
}

För Källa använder du:

{
  artifactSelector = "string"
  relativePath = "string"
  runtimeVersion = "string"
  type = "Source"
}

ProbeAction-objekt

Ange egenskapen typ för att ange typ av objekt.

För ExecActionanvänder du:

{
  command = [
    "string"
  ]
  type = "ExecAction"
}

För HTTPGetAction-använder du:

{
  path = "string"
  scheme = "string"
  type = "HTTPGetAction"
}

För TCPSocketAction-använder du:

{
  type = "TCPSocketAction"
}

Egenskapsvärden

Microsoft.AppPlatform/Spring/apps/deployments

Namn Beskrivning Värde
namn Resursnamnet sträng (krävs)
föräldra_id ID för resursen som är överordnad för den här resursen. ID för resurs av typen: Spring/apps
egenskaper Egenskaper för distributionsresursen DeploymentResourceProperties (DistributionResourceProperties)
Sku SKU för distributionsresursen Sku
typ Resurstypen "Microsoft.AppPlatform/Spring/apps/deployments@2022-05-01-preview"

AddonProfil

Namn Beskrivning Värde

BuildResultUserSourceInfo (på engelska)

Namn Beskrivning Värde
buildResultId Resurs-ID för ett befintligt slutfört byggresultat under samma Spring-instans. snöre
typ Typ av källa som laddats upp "BuildResult" (krävs)

ContainerProbeSettings (på engelska)

Namn Beskrivning Värde
disableProbe (på engelska) Anger om du inaktiverar live- och beredskapsavsökningen Bool

CustomContainer (på engelska)

Namn Beskrivning Värde
args args Argument till startpunkten. Docker-avbildningens CMD används om detta inte anges. sträng[]
kommando Startpunktsmatris. Körs inte i ett gränssnitt. Docker-avbildningens ENTRYPOINT används om detta inte anges. sträng[]
containerImage Containeravbildning av den anpassade containern. Detta bör vara i form av <lagringsplats>:<tagg> utan registrets servernamn snöre
imageRegistryCredential Autentiseringsuppgifter för avbildningsregistret ImageRegistryCredential (på engelska)
språkramverk Språkramverk för containeravbildningen som laddats upp snöre
server Namnet på registret som innehåller containeravbildningen snöre

CustomContainerUserSourceInfo (på engelska)

Namn Beskrivning Värde
customContainer (anpassad) Nyttolast för anpassad container CustomContainer (på engelska)
typ Typ av källa som laddats upp "Container" (krävs)

DeploymentResourceProperties (DistributionResourceProperties)

Namn Beskrivning Värde
aktiv Anger om distributionen är aktiv Bool
inställningar för distribution Distributionsinställningar för distributionen DistributionInställningar
källa Uppladdad källinformation för distributionen. UserSourceInfo (på engelska)

DistributionInställningar

Namn Beskrivning Värde
addonConfigs Samling med tillägg DeploymentSettingsAddonConfigs
containerProbeSettings (på engelska) Inställningar för containerbehåll och beredskapsavsökning ContainerProbeSettings (på engelska)
miljövariabler Samling miljövariabler DeploymentSettingsEnvironmentVariables (DistributionSettingsEnvironmentVariabler)
livenessProbe Periodisk avsökning av appinstansens liveness. Appinstansen startas om om avsökningen misslyckas. Mer information: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes avsökning
beredskapSond Periodisk avsökning av appinstanstjänstens beredskap. App instance tas bort från tjänstslutpunkter om avsökningen misslyckas. Mer information: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes avsökning
resourceRequests (på engelska) Den begärda resurskvantiteten för nödvändig processor och minne. Vi rekommenderar att du använder det här fältet för att representera den processor och det minne som krävs, att den gamla fältprocessorn och minnetInGB kommer att bli inaktuella senare. ResourceRequests (på engelska)
startupProbe (starta) StartupProbe anger att appinstansen har initierats. Om det anges körs inga andra avsökningar förrän det har slutförts. Om den här avsökningen misslyckas startas podden om, precis som om livenessProbe misslyckades. Detta kan användas för att tillhandahålla olika avsökningsparametrar i början av en appinstans livscykel, när det kan ta lång tid att läsa in data eller värma en cache, än under åtgärden för stabilt tillstånd. Det går inte att uppdatera detta. Mer information: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes avsökning
terminationGracePeriodSeconds Valfri varaktighet i sekunder appinstansen måste avslutas korrekt. Kan minskas i borttagningsbegäran. Värdet måste vara ett heltal som inte är negativt. Värdet noll anger stopp direkt via avlivningssignalen (ingen möjlighet att stänga av). Om det här värdet är noll används standard respitperioden i stället. Respitperioden är varaktigheten i sekunder efter att processerna som körs i appinstansen har skickats en avslutningssignal och den tid då processerna med två skäl stoppas med en kill-signal. Ange det här värdet längre än den förväntade rensningstiden för din process. Standardvärdet är 90 sekunder. Int

DeploymentSettingsAddonConfigs

Namn Beskrivning Värde

DeploymentSettingsEnvironmentVariables (DistributionSettingsEnvironmentVariabler)

Namn Beskrivning Värde

ExecAction

Namn Beskrivning Värde
kommando Kommandot är kommandoraden som ska köras i containern. Arbetskatalogen för kommandot är rot ('/') i containerns filsystem. Kommandot körs inte i ett gränssnitt, så traditionella gränssnittsinstruktioner (|) fungerar inte. Om du vill använda ett gränssnitt måste du uttryckligen anropa gränssnittet. Utgångsstatusen 0 behandlas som live/felfri och icke-noll är inte felfri. sträng[]
typ Vilken typ av åtgärd som ska vidtas för att utföra hälsokontrollen. "ExecAction" (krävs)

HttpGetAction (på engelska)

Namn Beskrivning Värde
väg Sökväg till åtkomst på HTTP-servern. snöre
schema Schema som ska användas för att ansluta till värden. Standardvärdet är HTTP.

Möjliga uppräkningsvärden:
- "HTTP" innebär att det system som används kommer att http://
- "HTTPS" innebär att det system som används kommer att https://
"HTTP"
"HTTPS"
typ Vilken typ av åtgärd som ska vidtas för att utföra hälsokontrollen. "HTTPGetAction" (krävs)

ImageRegistryCredential (på engelska)

Namn Beskrivning Värde
lösenord Lösenordet för avbildningsregistrets autentiseringsuppgifter snöre
användarnamn Användarnamnet för avbildningsregistrets autentiseringsuppgifter snöre

JarUploadedUserSourceInfo

Namn Beskrivning Värde
jvmOptions JVM-parameter snöre
relativePath Relativ sökväg för lagringen som lagrar källan snöre
runtimeVersion Körningsversion av Jar-filen snöre
typ Typ av källa som laddats upp "Jar" (krävs)

NetCoreZipUploadedUserSourceInfo

Namn Beskrivning Värde
netCoreMainEntryPath Vägen till .NET-exekverbara filen i förhållande till zip-roten snöre
relativePath Relativ sökväg för lagringen som lagrar källan snöre
runtimeVersion Körningsversion av .Net-filen snöre
typ Typ av källa som laddats upp "NetCoreZip" (krävs)

Sond

Namn Beskrivning Värde
disableProbe (på engelska) Ange om avsökningen är inaktiverad. bool (krävs)
failureThreshold (på engelska) Minsta på varandra följande fel för avsökningen som ska betraktas som misslyckad efter att ha lyckats. Minimivärdet är 1. Int
initialDelaySeconds Antal sekunder efter att appinstansen har startats innan avsökningar initieras. Mer information: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes Int
periodsekunder Hur ofta (i sekunder) avsökningen ska utföras. Minimivärdet är 1. Int
sondAction (på engelska) Avsökningens åtgärd. SondAction (på engelska)
framgångströskel Minsta lyckade resultat i följd för att avsökningen ska anses vara lyckad efter att den har misslyckats. Måste vara 1 för liveness och start. Minimivärdet är 1. Int
timeoutSekunder Antal sekunder efter vilken avsökningen överskrider tidsgränsen. Minimivärdet är 1. Int

SondAction (på engelska)

Namn Beskrivning Värde
typ Ange till ExecAction för typ ExecAction. Ange till HTTPGetAction för typen HttpGetAction. Ange TCPSocketAction för typen TCPSocketAction. "ExecAction"
"HTTPGetAction"
"TCPSocketAction" (krävs)

ResourceRequests (på engelska)

Namn Beskrivning Värde
CPU Nödvändig PROCESSOR. 1 kärna kan representeras av 1 eller 1 000 m. Detta bör vara 500m eller 1 för Basic-nivån och {500m, 1, 2, 3, 4} för Standard-nivån. snöre
minne Minne som krävs. 1 GB kan representeras av 1Gi eller 1024Mi. Detta bör vara {512Mi, 1Gi, 2Gi} för Basic-nivån och {512Mi, 1Gi, 2Gi, ..., 8Gi} för standardnivån. snöre

Sku

Namn Beskrivning Värde
kapacitet Målresursens aktuella kapacitet Int
namn SKU:ns namn snöre
nivå Nivå för SKU:n snöre

SourceUploadedUserSourceInfo (på engelska)

Namn Beskrivning Värde
artefakt Selector Väljare för artefakten som ska användas för distributionen för projekt med flera moduler. Detta bör vara
den relativa sökvägen till målmodulen/projektet.
snöre
relativePath Relativ sökväg för lagringen som lagrar källan snöre
runtimeVersion Körningsversion av källfilen snöre
typ Typ av källa som laddats upp "Källa" (krävs)

TCPSocketAction

Namn Beskrivning Värde
typ Vilken typ av åtgärd som ska vidtas för att utföra hälsokontrollen. "TCPSocketAction" (krävs)

UserSourceInfo (på engelska)

Namn Beskrivning Värde
typ Ange till BuildResult för typen BuildResultUserSourceInfo. Ange till Container för typen CustomContainerUserSourceInfo. Ange till Jar för typ JarUploadedUserSourceInfo. Ange till "NetCoreZip" för typen NetCoreZipUploadedUserSourceInfo. Ange till "Källa" för typen SourceUploadedUserSourceInfo. "BuildResult"
"Container"
"Jar"
"NetCoreZip"
"Källa" (krävs)
version Version av källan snöre

Användningsexempel

Terraform-exempel

Ett grundläggande exempel på distribution av Spring Cloud Deployment.

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" "Spring" {
  type      = "Microsoft.AppPlatform/Spring@2023-05-01-preview"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      zoneRedundant = false
    }
    sku = {
      name = "E0"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "app" {
  type      = "Microsoft.AppPlatform/Spring/apps@2023-05-01-preview"
  parent_id = azapi_resource.Spring.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      customPersistentDisks = [
      ]
      enableEndToEndTLS = false
      public            = false
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "deployment" {
  type      = "Microsoft.AppPlatform/Spring/apps/deployments@2023-05-01-preview"
  parent_id = azapi_resource.app.id
  name      = var.resource_name
  body = {
    properties = {
      deploymentSettings = {
        environmentVariables = {
        }
      }
      source = {
        customContainer = {
          args = [
          ]
          command = [
          ]
          containerImage    = "springio/gs-spring-boot-docker"
          languageFramework = ""
          server            = "docker.io"
        }
        type = "Container"
      }
    }
    sku = {
      capacity = 1
      name     = "E0"
      tier     = "Enterprise"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}