Partilhar via

AzureSpringCloud@0 - Tarefa Azure Spring Apps v0

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

Importante

Esta tarefa é suportada nos planos Azure Spring Apps Basic/Standard e Enterprise. 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.

Insumos

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

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


Action - Ação
string. Obrigatório Valores permitidos: Deploy, Set Production (set Production Deployment), Delete Staging Deployment. Valor predefinido: Deploy.

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


AzureSpringCloud - Nome dos aplicativos Azure Spring
string. Obrigatório

O nome ou ID de 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 predefinido: Artifacts.

Para implementar 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 predefinido: 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 existir.
boolean. Opcional. Use quando Action = Deploy && UseStagingDeployment = false. Valor predefinido: false.

Se definido como true, e a implantação especificada por DeploymentName não existir no momento da 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 este campo como default. O valor deve começar com uma letra e consistir apenas em letras minúsculas e números.


Package - de pacotes ou pastas
string. Opcional. Use quando Action = Deploy && DeploymentType = Artifacts. Valor predefinido: $(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).
Variáveis ( Build | Release) e curingas são suportadas.
Por exemplo, $(System.DefaultWorkingDirectory)/**/*.jar


Package - de pacotes ou pastas
string. Opcional. Use quando Action = Deploy. Valor predefinido: $(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).
Variáveis ( Build | Release) e curingas são suportadas.
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 no nível corporativo.
Para obter uma descrição detalhada, verifique Usar o Tanzu Build Service.


RegistryServer - Servidor de Registo
string. Opcional. Use quando Action = Deploy && DeploymentType = CustomContainer. Valor predefinido: docker.io.

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


RegistryUsername - Nome de utilizador do registo
string. Opcional. Use quando Action = Deploy && DeploymentType = CustomContainer.

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


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

A senha do registro do contêiner.


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

A tag de imagem do contêiner.


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

O comando da imagem do contêiner.


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

Os argumentos da imagem do contêiner.


ImageLanguageFramework - Quadro linguístico
string. Opcional. Use quando Action = Deploy && DeploymentType = CustomContainer. Valores permitidos: springboot.


EnvironmentVariables - Variáveis de ambiente
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 da JVM do aplicativo. Uma cadeia de caracteres que contém opções da JVM, como -Xms1024m -Xmx2048m.


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

Edita as opções da JVM do aplicativo. Uma cadeia de caracteres que contém 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 predefinido: Java_11.

A versão de tempo de execução 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 predefinido: Java_11.

A versão de tempo de execução 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 predefinido: Java_11.

A versão de tempo de execução na qual o aplicativo será executado.


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

O caminho para o executável .NET relativo à raiz zip.


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

A versão de implantação. Se não estiver definida, a versão será mantida inalterada.


Opções de controlo de tarefas

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

Variáveis de saída

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

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

Observações

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

Importante

Esta tarefa é suportada nos planos Azure Spring Apps Basic/Standard e Enterprise. 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.

Excluindo 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

Desdobramento

Para a produção

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

Observação

O padrão de pesquisa de pacotes só deve retornar exatamente um pacote. Se a tarefa de compilação 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 implanta 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 mais informações sobre implantações verde-azul, incluindo uma abordagem alternativa, consulte Estratégias de implantação azul-verde.

Definindo 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 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

Requerimentos

Requisito Descrição
Tipos de pipeline YAML, Construção clássica, Versão clássica
Funciona em Agente, DeploymentGroup
Exigências Nenhum
Capacidades Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes no trabalho.
Restrições de comando Qualquer
Variáveis configuráveis Qualquer
Versão do agente 2.104.1 ou superior
Categoria de tarefa Desplegar
  • Last updated on