Compartilhar via

AzureSpringCloud@0 – Tarefa do Azure Spring Apps v0

Esta tarefa implanta aplicativos no Azure Spring Apps e gerencia essas implantações.

Importante

Essa tarefa tem suporte nos planos Basic/Standard e Enterprise do Azure Spring Apps. Para obter mais informações, consulte Automatizar implantações de aplicativos no Azure Spring Apps.

Sintaxe

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

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

# 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. 
    #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. Package or folder. Default: $(System.DefaultWorkingDirectory)/**/*.jar.
  # Application and Configuration Settings
    #EnvironmentVariables: # string. Optional. Use when Action = Deploy. Environment Variables. 
    #JvmOptions: # string. Optional. Use when Action = Deploy. JVM Options. 
    #RuntimeVersion: 'Java_11' # 'Java_8' | 'Java_11' | 'NetCore_31'. Optional. Use when Action = Deploy. Runtime Version. Default: Java_11.
    #DotNetCoreMainEntryPath: # string. Optional. Use when RuntimeVersion = NetCore_31. Main Entry Path. 
    #Version: # string. Optional. Use when Action = Deploy. Version.

Entradas

azureSubscription - assinatura do Azure
Alias de entrada: ConnectedServiceName. string. Obrigatório

Especifica a assinatura do Azure Resource Manager para a implantação.


de Ação Action -
string. Obrigatório Valores permitidos: Deploy, Set Production (Definir implantação de produção), Delete Staging Deployment. Valor padrão: Deploy.

A ação a ser executada no Azure Spring Apps.


AzureSpringCloud - Nome do Azure Spring Apps
string. Obrigatório

O nome ou a ID do recurso da instância do Azure Spring Apps a ser implantada.


AppName - Aplicação
string. Obrigatório

O nome do aplicativo Azure Spring Apps a ser implantado. O aplicativo deve existir antes da execução da tarefa.


DeploymentType - Tipo de implantação
string. Opcional. Use quando Action = Deploy. Valores permitidos: Artifacts, CustomContainer (Contêiner Personalizado). Valor padrão: Artifacts.

Para implantar com código-fonte ou pacote Java, escolha "Artefatos"; Para implantar com a imagem do contêiner, escolha "Contêiner personalizado".


UseStagingDeployment - Usar implantação de preparo
boolean. Opcional. Use quando Action = Deploy || Action = Set Production. Valor padrão: true.

No momento em que a tarefa é executada, essa entrada seleciona automaticamente a implantação definida como staging.

Se definido como true, aplique a tarefa à implantação definida como a implantação de preparo no momento da execução. Se omitido, o DeploymentName parâmetro deve ser definido.


CreateNewDeployment - Crie uma nova implantação de preparo se não houver uma.
boolean. Opcional. Use quando Action = Deploy && UseStagingDeployment = false. Valor padrão: false.

Se definido como truee a implantação especificada por DeploymentName não existir no tempo de execução, ela será criada. Se omitido, o DeploymentName parâmetro deve ser definido.


DeploymentName - Implantação
string. Opcional. Use quando UseStagingDeployment = false && Action != Delete Staging Deployment.

A implantação à qual essa tarefa será aplicada. Se não estiver usando implantações azul-verde, defina esse campo como default. O valor deve começar com uma letra e consistir apenas em letras minúsculas e números.


pacote Package - ou de pasta
string. Opcional. Use quando Action = Deploy && DeploymentType = Artifacts. Valor padrão: $(System.DefaultWorkingDirectory)/**/*.jar.

O caminho do arquivo para o pacote ou pasta que contém o conteúdo do aplicativo Azure Spring Apps (.jar arquivo para Java, .zip para .NET Core).
Há suporte para variáveis ( | versão de build) e curingas.
Por exemplo, $(System.DefaultWorkingDirectory)/**/*.jar


pacote Package - ou de pasta
string. Opcional. Use quando Action = Deploy. Valor padrão: $(System.DefaultWorkingDirectory)/**/*.jar.

O caminho do arquivo para o pacote ou pasta que contém o conteúdo do aplicativo Azure Spring Apps (.jar arquivo para Java, .zip para .NET Core).
Há suporte para variáveis ( | versão de build) e curingas.
Por exemplo, $(System.DefaultWorkingDirectory)/**/*.jar


Builder - Construtor
string. Opcional. Use quando Action = Deploy && DeploymentType = Artifacts.

Selecione um construtor do VMware Tanzu® Build Service™, que pode ser usado na camada empresarial.
Para obter uma descrição detalhada, consulte Usar o serviço de compilação Tanzu.


RegistryServer - Servidor de Registro
string. Opcional. Use quando Action = Deploy && DeploymentType = CustomContainer. Valor padrão: docker.io.

O registro da imagem do contêiner. Padrão: docker.io.


RegistryUsername - Nome de usuário do registro
string. Opcional. Use quando Action = Deploy && DeploymentType = CustomContainer.

O nome de usuário do registro de contêiner.


RegistryPassword - de Senha do Registro
string. Opcional. Use quando Action = Deploy && DeploymentType = CustomContainer.

A senha do registro de contêiner.


ImageName - Nome e tag da imagem
string. Opcional. Use quando Action = Deploy && DeploymentType = CustomContainer. Valor padrão: hello-world:v1.

A marca de imagem do contêiner.


ImageCommand - Comando de imagem
string. Opcional. Use quando Action = Deploy && DeploymentType = CustomContainer.

O comando da imagem de contêiner.


ImageArgs - Argumentos de imagem
string. Opcional. Use quando Action = Deploy && DeploymentType = CustomContainer.

Os argumentos da imagem de contêiner.


ImageLanguageFramework - Estrutura de linguagem
string. Opcional. Use quando Action = Deploy && DeploymentType = CustomContainer. Valores permitidos: springboot.


variáveis de ambiente EnvironmentVariables -
string. Opcional. Use quando Action = Deploy.

As variáveis de ambiente a serem inseridas usando a sintaxe -key value (por exemplo: -CUSTOMER_NAME Contoso-WEBSITE_TIME_ZONE). Os valores que contêm espaços devem ser colocados entre aspas duplas (por exemplo: "Eastern Standard Time").


JvmOptions - Opções da JVM
string. Opcional. Use quando Action = Deploy && DeploymentType = Artifacts.

Edita as opções de JVM do aplicativo. Uma string contendo opções da JVM, como -Xms1024m -Xmx2048m.


JvmOptions - Opções da JVM
string. Opcional. Use quando Action = Deploy.

Edita as opções de JVM do aplicativo. Uma string contendo opções da JVM, como -Xms1024m -Xmx2048m.


RuntimeVersion - Versão de tempo de execução
string. Opcional. Use quando Action = Deploy && DeploymentType = Artifacts. Valores permitidos: Java_8 (Java 8), Java_11 (Java 11), Java_17 (Java 17), Java_21 (Java 21), NetCore_31 (.Net Core 3.1). Valor padrão: Java_11.

A versão de runtime na qual o aplicativo será executado.


RuntimeVersion - Versão de tempo de execução
string. Opcional. Use quando Action = Deploy && DeploymentType = Artifacts. Valores permitidos: Java_8 (Java 8), Java_11 (Java 11), NetCore_31 (.Net Core 3.1). Valor padrão: Java_11.

A versão de runtime na qual o aplicativo será executado.


RuntimeVersion - Versão de tempo de execução
string. Opcional. Use quando Action = Deploy. Valores permitidos: Java_8 (Java 8), Java_11 (Java 11), NetCore_31 (.Net Core 3.1). Valor padrão: Java_11.

A versão de runtime na qual o aplicativo será executado.


DotNetCoreMainEntryPath - Caminho de entrada principal
string. Opcional. Use quando RuntimeVersion = NetCore_31.

O caminho para o executável do .NET em relação à raiz zip.


Version - versão
string. Opcional. Use quando Action = Deploy.

A versão de implantação. Se não for definido, a versão permanece inalterada.


Opções de controle de tarefa

Todas as tarefas têm opções de controle além das suas entradas de tarefas. Para obter mais informações, consulte as opções de Controle de e as propriedades comuns da tarefa.

Variáveis de saída

Essa tarefa define as seguintes variáveis de saída , que você pode consumir em etapas downstream, trabalhos e estágios.

testEndpoint
Somente após a ação 'Implantar'. Contém URL privada para acessar a implantação atualizada.

Observações

Use essa tarefa para implantar aplicativos no Azure Spring Apps e gerenciar implantações do Azure Spring Cloud.

Importante

Essa tarefa tem suporte nos planos Basic/Standard e Enterprise do Azure Spring Apps. Para obter mais informações, consulte Automatizar implantações de aplicativos no Azure Spring Apps.

Exemplos

Os exemplos a seguir demonstram cenários de uso comuns. Para obter mais informações, consulte Automatizar implantações de aplicativos no Azure Spring Apps.

Excluir uma implantação de preparo

A ação "Excluir implantação de preparo" permite excluir a implantação que não recebe tráfego de produção. Isso libera recursos usados por essa implantação e abre espaço para uma nova implantação de preparo:

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

Implantando

Para produção

O exemplo a seguir é implantado na implantação de produção padrão no Azure Spring Apps. Este é o único cenário de implantação possível ao usar o SKU Básico:

Observação

O padrão de pesquisa de pacote apenas deve retornar exatamente um pacote. Se a tarefa de build produzir vários pacotes JAR, como sources.jar e javadoc.jar, você precisará refinar o padrão de pesquisa para que ele corresponda apenas ao artefato binário do aplicativo.

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'

Azul-esverdeado

O exemplo a seguir é implantado em uma implantação de preparo pré-existente. Essa implantação não receberá tráfego de produção até que seja definida como uma implantação de produção.

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'

Para obter mais informações sobre implantações azul-verde, incluindo uma abordagem alternativa, consulte Estratégias de implantação azul-verde.

Definir a implantação de produção

O exemplo a seguir define a implantação de preparo atual como produção, trocando efetivamente qual implantação recebe o tráfego de produção.

variables:
  azureSubscription: Contoso

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

Requisitos

Requisito Descrição
Tipos de pipeline YAML, build clássico, versão clássica
Execuções em Agent, DeploymentGroup
de demandas Nenhum
recursos Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
restrições de comando Qualquer
variáveis settable Qualquer
Versão do agente 2.104.1 ou superior
Categoria de tarefa Implantar
  • Last updated on