AzureSpringCloud@0 - Tugas Azure Spring Apps v0

Tugas ini menyebarkan aplikasi ke Azure Spring Apps dan mengelola penyebaran tersebut.

Penting

Tugas ini didukung pada paket Azure Spring Apps Basic/Standard dan Enterprise. Untuk informasi selengkapnya, lihat Mengotomatiskan penyebaran aplikasi ke Azure Spring Apps.

Sintaks

# 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.

Input

azureSubscription - Langganan Azure
Alias input: ConnectedServiceName. string. Wajib diisi.

Menentukan langganan Azure Resource Manager untuk penyebaran.

Action - Tindakan
string. Wajib diisi. Nilai yang diizinkan: Deploy, Set Production (Atur Penyebaran Produksi), Delete Staging Deployment. Nilai default: Deploy.

Tindakan yang akan dilakukan di Azure Spring Apps.

AzureSpringCloud - Nama Azure Spring Apps
string. Wajib diisi.

Nama atau ID sumber daya instans Azure Spring Apps untuk disebarkan.

AppName - App
string. Wajib diisi.

Nama aplikasi Azure Spring Apps yang akan disebarkan. Aplikasi harus ada sebelum eksekusi tugas.

DeploymentType - Jenis Penyebaran
string. Pilihan. Gunakan saat Action = Deploy. Nilai yang diizinkan: Artifacts, CustomContainer (Kontainer Kustom). Nilai default: Artifacts.

Untuk menyebarkan dengan kode sumber atau paket Java, pilih "Artefak"; Untuk menyebarkan dengan gambar kontainer, pilih "Kontainer Kustom".

UseStagingDeployment - Menggunakan Penyebaran Penahapan
boolean. Pilihan. Gunakan saat Action = Deploy || Action = Set Production. Nilai default: true.

Pada saat tugas berjalan, input ini secara otomatis memilih penyebaran yang ditetapkan sebagai staging.

Jika diatur ke true, terapkan tugas ke penyebaran yang ditetapkan sebagai penyebaran penahapan pada saat eksekusi. Jika dihilangkan DeploymentName , parameter harus diatur.

CreateNewDeployment - Buat penyebaran penahapan baru jika tidak ada.
boolean. Pilihan. Gunakan saat Action = Deploy && UseStagingDeployment = false. Nilai default: false.

Jika diatur ke true, dan penyebaran yang ditentukan oleh DeploymentName tidak ada pada waktu eksekusi, penyebaran akan dibuat. Jika dihilangkan DeploymentName , parameter harus diatur.

DeploymentName - Penyebaran
string. Pilihan. Gunakan saat UseStagingDeployment = false && Action != Delete Staging Deployment.

Penyebaran yang akan diterapkan tugas ini. Jika tidak menggunakan penyebaran biru-hijau, atur bidang ini ke default. Nilai harus dimulai dengan huruf dan terdiri dari huruf kecil dan angka saja.

Package - Paket atau folder
string. Pilihan. Gunakan saat Action = Deploy && DeploymentType = Artifacts. Nilai default: $(System.DefaultWorkingDirectory)/**/*.jar.

Jalur file ke paket atau folder yang berisi konten aplikasi Azure Spring Apps (.jar file untuk Java, .zip untuk .NET Core).
Variabel (RilisBuild | ) dan kartubebas didukung.
Misalnya, $(System.DefaultWorkingDirectory)/**/*.jar

Builder - Builder
string. Pilihan. Gunakan saat Action = Deploy && DeploymentType = Artifacts.

Pilih penyusun VMware Tanzu® Build Service™, ini dapat digunakan di tingkat perusahaan.
Untuk deskripsi terperinci, silakan periksa Gunakan Tanzu Build Service.

RegistryServer - Server Registri
string. Pilihan. Gunakan saat Action = Deploy && DeploymentType = CustomContainer. Nilai default: docker.io.

Registri gambar kontainer. Default: docker.io.

RegistryUsername - Nama Pengguna Registri
string. Pilihan. Gunakan saat Action = Deploy && DeploymentType = CustomContainer.

Nama pengguna registri kontainer.

RegistryPassword - Kata Sandi Registri
string. Pilihan. Gunakan saat Action = Deploy && DeploymentType = CustomContainer.

Kata sandi registri kontainer.

ImageName - Nama dan Tag Gambar
string. Pilihan. Gunakan saat Action = Deploy && DeploymentType = CustomContainer. Nilai default: hello-world:v1.

Tag gambar kontainer.

ImageCommand - Perintah Gambar
string. Pilihan. Gunakan saat Action = Deploy && DeploymentType = CustomContainer.

Perintah gambar kontainer.

ImageArgs - Argumen Gambar
string. Pilihan. Gunakan saat Action = Deploy && DeploymentType = CustomContainer.

Argumen gambar kontainer.

ImageLanguageFramework - Kerangka Kerja Bahasa
string. Pilihan. Gunakan saat Action = Deploy && DeploymentType = CustomContainer. Nilai yang diizinkan: springboot.

EnvironmentVariables - Variabel Lingkungan
string. Pilihan. Gunakan saat Action = Deploy.

Variabel lingkungan yang akan dimasukkan menggunakan sintaks -key value (misalnya: -CUSTOMER_NAME Contoso-WEBSITE_TIME_ZONE). Nilai yang berisi spasi harus diapit dalam tanda kutip ganda (misalnya: "Eastern Standard Time").

JvmOptions - Opsi JVM
string. Pilihan. Gunakan saat Action = Deploy && DeploymentType = Artifacts.

Mengedit opsi JVM aplikasi. String yang berisi opsi JVM, seperti -Xms1024m -Xmx2048m.

RuntimeVersion - Versi Runtime
string. Opsional. Gunakan saat Action = Deploy && DeploymentType = Artifacts. Nilai yang diizinkan: Java_8 (Java 8), Java_11 (Java 11), Java_17 (Java 17), Java_21 (Java 21), NetCore_31 (.Net Core 3.1). Nilai default: Java_11.

Versi runtime tempat aplikasi akan berjalan.

DotNetCoreMainEntryPath - Jalur Entri Utama
string. Pilihan. Gunakan saat RuntimeVersion = NetCore_31.

Jalur ke .NET yang dapat dieksekusi relatif terhadap akar zip.

Version - Versi
string. Opsional. Gunakan saat Action = Deploy.

Versi penyebaran. Jika tidak diatur, versi dibiarkan tidak berubah.

Opsi kontrol tugas

Semua tugas memiliki opsi kontrol selain input tugas mereka. Untuk informasi selengkapnya, lihat Opsi kontrol dan properti tugas umum.

Variabel output

Tugas ini menentukan variabel output berikut, yang dapat Anda konsumsi dalam langkah-langkah hilir, pekerjaan, dan tahapan.

testEndpoint
Setelah tindakan 'Sebarkan' saja. Berisi URL privat untuk mengakses penyebaran yang diperbarui.

Keterangan

Gunakan tugas ini untuk menyebarkan aplikasi ke Azure Spring Apps dan untuk mengelola penyebaran Azure Spring Cloud.

Penting

Tugas ini didukung pada paket Azure Spring Apps Basic/Standard dan Enterprise. Untuk informasi selengkapnya, lihat Mengotomatiskan penyebaran aplikasi ke Azure Spring Apps.

Contoh

Contoh berikut menunjukkan skenario penggunaan yang umum. Untuk informasi selengkapnya, lihat Mengotomatiskan penyebaran aplikasi ke Azure Spring Apps.

Menghapus penyebaran penahapan

Tindakan "Hapus Penyebaran Penahapan" memungkinkan Anda menghapus penyebaran yang tidak menerima lalu lintas produksi. Ini membebaskan sumber daya yang digunakan oleh penyebaran tersebut dan memberi ruang untuk penyebaran penahapan baru:

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

Menyebarkan

Ke produksi

Contoh berikut disebarkan ke penyebaran produksi default di Azure Spring Apps. Ini adalah satu-satunya skenario penyebaran yang mungkin saat menggunakan SKU Dasar:

Catatan

Pola pencarian paket hanya boleh mengembalikan tepat satu paket. Jika tugas build menghasilkan beberapa paket JAR seperti sources.jar dan javadoc.jar, Anda perlu memperbaiki pola pencarian sehingga hanya cocok dengan artefak biner aplikasi.

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'

Biru-hijau

Contoh berikut menyebarkan ke penyebaran penahapan yang sudah ada sebelumnya. Penyebaran ini tidak akan menerima lalu lintas produksi hingga ditetapkan sebagai penyebaran produksi.

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'

Untuk informasi selengkapnya tentang penyebaran biru-hijau, termasuk pendekatan alternatif, lihat Strategi penyebaran biru-hijau.

Mengatur penyebaran produksi

Contoh berikut menetapkan penyebaran penahapan saat ini sebagai produksi, secara efektif menukar penyebaran mana yang menerima lalu lintas produksi.

variables:
  azureSubscription: Contoso

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

Persyaratan

Persyaratan	Deskripsi
Jenis alur	YAML, Build klasik, Rilis klasik
Berjalan pada	Agen, DeploymentGroup
Permintaan	Tidak ada
Kemampuan	Tugas ini tidak memenuhi tuntutan untuk tugas berikutnya dalam pekerjaan.
Pembatasan perintah	Apa pun
Variabel yang dapat diatur	Apa pun
Versi agen	2.104.1 atau lebih tinggi
Kategori tugas	Sebarkan