AzureSpringCloud@0 – Azure Spring Apps v0-feladat

Ez a feladat alkalmazásokat helyez üzembe az Azure Spring Appsben, és kezeli ezeket az üzembe helyezéseket.

Fontos

Ezt a feladatot az Azure Spring Apps Basic/Standard és Enterprise csomagjai támogatják. További információ: Alkalmazások üzembe helyezésének automatizálása az Azure Spring Appsben.

Syntax

# Azure Spring Apps v0
# Deploy applications to Azure Spring Apps and manage deployments.
- task: AzureSpringCloud@0
  inputs:
    azureSubscription: # string. Alias: ConnectedServiceName. Required. Azure subscription. 
    Action: 'Deploy' # 'Deploy' | 'Set Production' | 'Delete Staging Deployment'. Required. Action. Default: Deploy.
    AzureSpringCloud: # string. Required. Azure Spring Apps Name. 
    AppName: # string. Required. App. 
    #DeploymentType: 'Artifacts' # 'Artifacts' | 'CustomContainer'. Optional. Use when Action = Deploy. Deployment Type. Default: Artifacts.
    #UseStagingDeployment: true # boolean. Optional. Use when Action = Deploy || Action = Set Production. Use Staging Deployment. Default: true.
    #CreateNewDeployment: false # boolean. Optional. Use when Action = Deploy && UseStagingDeployment = false. Create a new staging deployment if one does not exist. Default: false.
    #DeploymentName: # string. Optional. Use when UseStagingDeployment = false && Action != Delete Staging Deployment. Deployment. 
    #Package: '$(System.DefaultWorkingDirectory)/**/*.jar' # string. Optional. Use when Action = Deploy && DeploymentType = Artifacts. Package or folder. Default: $(System.DefaultWorkingDirectory)/**/*.jar.
    #RegistryServer: 'docker.io' # string. Optional. Use when Action = Deploy && DeploymentType = CustomContainer. Registry Server. Default: docker.io.
    #RegistryUsername: # string. Optional. Use when Action = Deploy && DeploymentType = CustomContainer. Registry Username. 
    #RegistryPassword: # string. Optional. Use when Action = Deploy && DeploymentType = CustomContainer. Registry Password. 
    #ImageName: 'hello-world:v1' # string. Optional. Use when Action = Deploy && DeploymentType = CustomContainer. Image Name and Tag. Default: hello-world:v1.
    #ImageCommand: # string. Optional. Use when Action = Deploy && DeploymentType = CustomContainer. Image Command. 
    #ImageArgs: # string. Optional. Use when Action = Deploy && DeploymentType = CustomContainer. Image Arguments. 
    #ImageLanguageFramework: # 'springboot'. Optional. Use when Action = Deploy && DeploymentType = CustomContainer. Language Framework. 
  # Application and Configuration Settings
    #Builder: # string. Optional. Use when Action = Deploy && DeploymentType = Artifacts. Builder. 
    #EnvironmentVariables: # string. Optional. Use when Action = Deploy. Environment Variables. 
    #JvmOptions: # string. Optional. Use when Action = Deploy && DeploymentType = Artifacts. JVM Options. 
    #RuntimeVersion: 'Java_11' # 'Java_8' | 'Java_11' | 'Java_17' | 'Java_21' | 'NetCore_31'. Optional. Use when Action = Deploy && DeploymentType = Artifacts. Runtime Version. Default: Java_11.
    #DotNetCoreMainEntryPath: # string. Optional. Use when RuntimeVersion = NetCore_31. Main Entry Path. 
    #Version: # string. Optional. Use when Action = Deploy. Version.

Bevitelek

azureSubscription - Azure-előfizetés
Bemeneti alias: ConnectedServiceName. string. Kötelező.

Az üzembe helyezésHez tartozó Azure Resource Manager-előfizetést adja meg.

Action - Akció
string. Kötelező. Engedélyezett értékek: Deploy, Set Production (Éles üzembe helyezés beállítása), Delete Staging Deployment. Alapértelmezett érték: Deploy.

Az Azure Spring Appsben végrehajtandó művelet.

AzureSpringCloud - Azure Spring Apps neve
string. Kötelező.

Az üzembe helyezendő Azure Spring Apps-példány neve vagy erőforrás-azonosítója.

AppName - App
string. Kötelező.

Az üzembe helyezendő Azure Spring Apps-alkalmazás neve. Az alkalmazásnak a feladat végrehajtása előtt léteznie kell.

DeploymentType - Üzembe helyezés típusa
string. Választható. Használja a következőt: Action = Deploy. Engedélyezett értékek: Artifacts, CustomContainer (Egyéni tároló). Alapértelmezett érték: Artifacts.

Forráskóddal vagy Java-csomaggal való üzembe helyezéshez válassza az "Összetevők" lehetőséget; A tárolórendszerkép használatával történő üzembe helyezéshez válassza az "Egyéni tároló" lehetőséget.

UseStagingDeployment - Átmeneti üzembe helyezés használata
boolean. Választható. Használja a következőt: Action = Deploy || Action = Set Production. Alapértelmezett érték: true.

A feladat futtatásakor ez a bemenet automatikusan kiválasztja a beállított üzembe helyezést staging.

Ha a értékre truevan állítva, alkalmazza a feladatot arra az üzembe helyezésre , amely előkészítési üzembe helyezésként van beállítva a végrehajtás időpontjában. Ha nincs megadva, a paramétert DeploymentName be kell állítani.

CreateNewDeployment - Hozzon létre egy új előkészítési üzembe helyezést, ha nem létezik.
boolean. Választható. Használja a következőt: Action = Deploy && UseStagingDeployment = false. Alapértelmezett érték: false.

Ha a értékre van trueállítva, és a által DeploymentName megadott üzembe helyezés nem létezik a végrehajtási időpontban, akkor létrejön. Ha nincs megadva, a paramétert DeploymentName be kell állítani.

DeploymentName - Telepítési
string. Választható. Használja a következőt: UseStagingDeployment = false && Action != Delete Staging Deployment.

Az üzembe helyezés , amelyre ezt a feladatot alkalmazni fogja. Ha nem használ kék-zöld üzemelő példányokat, állítsa ezt a mezőt a értékre default. Az értéknek betűvel kell kezdődnie, és csak kisbetűkből és számokból kell állnia.

Package - Csomag vagy mappa
string. Választható. Használja a következőt: Action = Deploy && DeploymentType = Artifacts. Alapértelmezett érték: $(System.DefaultWorkingDirectory)/**/*.jar.

Az Azure Spring Apps alkalmazás tartalmát tartalmazó csomag vagy mappa elérési útja (.jar Java fájl a .zip .NET Core-hoz).
A változók (buildkiadás | ) és a helyettesítő karakterek támogatottak.
Például: $(System.DefaultWorkingDirectory)/**/*.jar

Builder - Builder
string. Választható. Használja a következőt: Action = Deploy && DeploymentType = Artifacts.

Válassza ki a VMware Tanzu® buildelési szolgáltatás™ egyik szerkesztője, amely vállalati szinten is használható.
Részletes leírásért tekintse meg a Tanzu Build Service használata című témakört.

RegistryServer - Beállításjegyzék-kiszolgáló
string. Választható. Használja a következőt: Action = Deploy && DeploymentType = CustomContainer. Alapértelmezett érték: docker.io.

A tárolórendszerkép beállításjegyzéke. Alapértelmezett: docker.io.

RegistryUsername - Regisztrációs adatbázis felhasználóneve
string. Választható. Használja a következőt: Action = Deploy && DeploymentType = CustomContainer.

A tárolóregisztrációs adatbázis felhasználóneve.

RegistryPassword - Beállításjegyzék jelszava
string. Választható. Használja a következőt: Action = Deploy && DeploymentType = CustomContainer.

A tárolóregisztrációs adatbázis jelszava.

ImageName - Kép neve és címke
string. Választható. Használja a következőt: Action = Deploy && DeploymentType = CustomContainer. Alapértelmezett érték: hello-world:v1.

A tárolórendszerkép címkéje.

ImageCommand - Image Command
string. Választható. Használja a következőt: Action = Deploy && DeploymentType = CustomContainer.

A tárolórendszerkép parancsa.

ImageArgs - Képargumentumok
string. Választható. Használja a következőt: Action = Deploy && DeploymentType = CustomContainer.

A tárolórendszerkép argumentumai.

ImageLanguageFramework - Nyelvi keretrendszer
string. Választható. Használja a következőt: Action = Deploy && DeploymentType = CustomContainer. Engedélyezett értékek: springboot.

EnvironmentVariables - Környezeti változók
string. Választható. Használja a következőt: Action = Deploy.

A szintaxissal -key value beírandó környezeti változók (például: -CUSTOMER_NAME Contoso-WEBSITE_TIME_ZONE). A szóközöket tartalmazó értékeket idézőjelek közé kell tenni (például: "Eastern Standard Time").

JvmOptions - JVM-beállítások
string. Választható. Használja a következőt: Action = Deploy && DeploymentType = Artifacts.

Az alkalmazás JVM-beállításainak szerkesztése. JVM-beállításokat tartalmazó sztring, például -Xms1024m -Xmx2048m: .

RuntimeVersion - Futtatókörnyezet verziója
string. Választható. Használja a következőt: Action = Deploy && DeploymentType = Artifacts. Engedélyezett értékek: Java_8 (Java 8), Java_11 (Java 11), Java_17 (Java 17), Java_21 (Java 21), NetCore_31 (.Net Core 3.1). Alapértelmezett érték: Java_11.

A futtatókörnyezet verziója, amelyen az alkalmazás futni fog.

DotNetCoreMainEntryPath - Fő bejegyzés elérési útja
string. Választható. Használja a következőt: RuntimeVersion = NetCore_31.

A .NET végrehajtható fájl elérési útja a zip-gyökérhez viszonyítva.

Version - Változat
string. Választható. Használja a következőt: Action = Deploy.

Az üzembe helyezés verziója. Ha nincs beállítva, a verzió változatlan marad.

Feladatvezérlési lehetőségek

Minden feladathoz tartoznak vezérlési lehetőségek is a feladat bemenetei mellett. További információ: Vezérlési beállítások és gyakori feladattulajdonságok.

Kimeneti változók

Ez a feladat a következő kimeneti változókat határozza meg, amelyeket az alsóbb rétegbeli lépésekben, feladatokban és szakaszokban használhat fel.

testEndpoint
Csak az Üzembe helyezés művelet után. Privát URL-címet tartalmaz a frissített üzemelő példány eléréséhez.

Megjegyzések

Ezzel a feladatokkal alkalmazásokat helyezhet üzembe az Azure Spring Appsben , és kezelheti az Azure Spring Cloud üzemelő példányait.

Fontos

Ezt a feladatot az Azure Spring Apps Basic/Standard és Enterprise csomagjai támogatják. További információ: Alkalmazások üzembe helyezésének automatizálása az Azure Spring Appsben.

Példák

Az alábbi példák gyakori használati forgatókönyveket mutatnak be. További információ: Alkalmazások üzembe helyezésének automatizálása az Azure Spring Appsben.

Átmeneti üzemelő példány törlése

Az "Átmeneti üzembe helyezés törlése" művelet lehetővé teszi az éles forgalmat nem fogadó üzemelő példány törlését. Ez felszabadítja az üzembe helyezés által használt erőforrásokat, és helyet biztosít az új átmeneti üzembe helyezésnek:

variables:
  azureSubscription: Contoso

steps:
- task: AzureSpringCloud@0
  continueOnError: true # Don't fail the pipeline if a staging deployment doesn't already exist.
  inputs:
    continueOnError: true
    inputs:
    azureSubscription: $(azureSubscription)
    Action: 'Delete Staging Deployment'
    AppName: customer-api
    AzureSpringCloud: contoso-dev-az-spr-cld

Telepítése

Éles környezetbe

Az alábbi példa az Azure Spring Apps alapértelmezett éles környezetében helyezi üzembe az üzembe helyezést. Ez az egyetlen lehetséges üzembehelyezési forgatókönyv az alapszintű termékváltozat használatakor:

Megjegyzés

A csomagkeresési minta csak egy csomagot ad vissza. Ha a buildelési feladat több JAR-csomagot hoz létre, például sources.jar és javadoc.jar, pontosítania kell a keresési mintát, hogy csak az alkalmazás bináris összetevőjének feleljen meg.

variables:
  azureSubscription: Contoso

steps:
- task: AzureSpringCloud@0
    inputs:
    azureSubscription: $(azureSubscription)
    Action: 'Deploy'
    AzureSpringCloud: contoso-dev-az-spr-cld
    AppName: customer-api
    UseStagingDeployment: false
    DeploymentName: default
    Package: '$(System.DefaultWorkingDirectory)/**/*customer-api*.jar'

Kék-zöld

Az alábbi példa egy már meglévő átmeneti üzembe helyezésre helyezi üzembe az üzembe helyezést. Ez az üzemelő példány csak akkor kapja meg az éles forgalmat, ha éles üzemelő példányként van beállítva.

variables:
  azureSubscription: Contoso

steps:
- task: AzureSpringCloud@0
    inputs:
    azureSubscription: $(azureSubscription)
    Action: 'Deploy'
    AzureSpringCloud: contoso-dev-az-spr-cld
    AppName: customer-api
    UseStagingDeployment: true
    Package: '$(System.DefaultWorkingDirectory)/**/*customer-api*.jar'

A kék-zöld üzembe helyezésekkel kapcsolatos további információkért, beleértve az alternatív megközelítést is, tekintse meg a kék-zöld üzembehelyezési stratégiákat.

Éles üzembe helyezés beállítása

Az alábbi példa éles környezetként állítja be az aktuális előkészítési üzembe helyezést, és hatékonyan cseréli le, hogy melyik üzemelő példány fogadja az éles forgalmat.

variables:
  azureSubscription: Contoso

steps:
- task: AzureSpringCloud@0
    inputs:
    azureSubscription: $(azureSubscription)
    Action: 'Set Production'
    AzureSpringCloud: contoso-dev-az-spr-cld
    AppName: customer-api
    UseStagingDeployment: true

Követelmények

Követelmény	Leírás
Folyamattípusok	YAML, klasszikus build, klasszikus kiadás
Futtatás:	Ügynök, DeploymentGroup
Igények	None
Képességek	Ez a tevékenység nem felel meg a feladat későbbi tevékenységeire vonatkozó követelményeknek.
Parancskorlátozások	Bármelyik
Változók beállítása	Bármelyik
Ügynök verziója	2.104.1 vagy újabb
Feladatkategória	Üzembe helyezés