AzureCloudPowerShellDeployment@1 - Tarefa de implantação do Serviço de Nuvem do Azure v1

Artigo
03/24/2025

Implante um Serviço de Nuvem do Azure.

Observação

Esta tarefa não suporta autenticação do Azure Resource Manager com federação de identidade de fluxo de trabalho.

Esta tarefa foi preterida porque os Serviços de Nuvem do Azure estão sendo desativados, consulte Migrar os Serviços de Nuvem do Azure (clássico) para os Serviços de Nuvem do Azure (suporte estendido).

Implante um Serviço de Nuvem do Azure.

Observação

Esta tarefa não suporta autenticação do Azure Resource Manager com federação de identidade de fluxo de trabalho.

Sintaxe

# Azure Cloud Service deployment v1
# Deploy an Azure Cloud Service.
- task: AzureCloudPowerShellDeployment@1
  inputs:
    azureClassicSubscription: # string. Alias: ConnectedServiceName. Required. Azure subscription (Classic). 
    #EnableAdvancedStorageOptions: false # boolean. Enable ARM storage support. Default: false.
    StorageAccount: # string. Required when EnableAdvancedStorageOptions = false. Storage account (Classic). 
    #ARMConnectedServiceName: # string. Required when EnableAdvancedStorageOptions = true. Azure subscription (ARM). 
    #ARMStorageAccount: # string. Required when EnableAdvancedStorageOptions = true. Storage account (ARM). 
    ServiceName: # string. Required. Service name. 
    ServiceLocation: # string. Required. Service location. 
    CsPkg: # string. Required. CsPkg. 
    CsCfg: # string. Required. CsCfg. 
    slotName: 'Production' # string. Alias: Slot. Required. Environment (Slot). Default: Production.
    #DeploymentLabel: '$(Build.BuildNumber)' # string. Deployment label. Default: $(Build.BuildNumber).
    #AppendDateTimeToLabel: false # boolean. Append current date and time. Default: false.
    #AllowUpgrade: true # boolean. Allow upgrade. Default: true.
    #SimultaneousUpgrade: false # boolean. Optional. Use when AllowUpgrade == true. Simultaneous upgrade. Default: false.
    #ForceUpgrade: false # boolean. Optional. Use when AllowUpgrade == true. Force upgrade. Default: false.
    #VerifyRoleInstanceStatus: false # boolean. Verify role instance status. Default: false.
  # Advanced Options For Creating New Service
    #DiagnosticStorageAccountKeys: # string. Diagnostic storage account keys. 
    #NewServiceCustomCertificates: # string. Custom certificates to import. 
    #NewServiceAdditionalArguments: # string. Additional arguments. 
    #NewServiceAffinityGroup: # string. Affinity group.

Insumos

azureClassicSubscription - assinatura do Azure (Classic)
Alias de entrada: ConnectedServiceName. string. Obrigatório.

A assinatura do Azure para destino para implantação.

EnableAdvancedStorageOptions - Ativar o suporte de armazenamento ARM
boolean. Valor padrão: false.

Habilita ou desabilita o suporte de armazenamento ARM.

StorageAccount - Conta de armazenamento (Clássico)
string. Necessário quando EnableAdvancedStorageOptions = false.

A conta de armazenamento deve existir antes da implantação.

ARMConnectedServiceName - assinatura do Azure (ARM)
string. Necessário quando EnableAdvancedStorageOptions = true.

A assinatura ARM.

ARMStorageAccount - Conta de armazenamento (ARM)
string. Necessário quando EnableAdvancedStorageOptions = true.

Uma conta de armazenamento ARM pré-existente.

ServiceName - Nome do serviço
string. Obrigatório.

Um nome de serviço de nuvem existente.

ServiceLocation - Localização do serviço
string. Obrigatório.

Uma região para implantação de novos serviços. As opções incluem: Leste dos EUA, Leste dos EUA 2, Centro dos EUA, Centro-Sul dos EUA, Oeste dos EUA, Norte da Europa, Europa Ocidental e outros.

CsPkg - CsPkg
string. Obrigatório.

Caminho para o CsPkg no diretório de artefato padrão.

CsCfg - CsCfg
string. Obrigatório.

O caminho CsCfg no diretório de artefato padrão.

slotName - Ambiente (Slot)
Alias de entrada: Slot. string. Obrigatório. Valor padrão: Production.

Defina esse valor como 'Preparo' ou use o padrão.

DeploymentLabel - Rótulo de implantação
string. Valor padrão: $(Build.BuildNumber).

Especifica o nome do rótulo para a nova implantação. Se não for especificado, o padrão será um GUID (Identificador Global Exclusivo).

AppendDateTimeToLabel - Anexar data e hora atuais
boolean. Valor padrão: false.

Acrescenta a data e a hora atuais ao rótulo de implantação.

AllowUpgrade - Permitir de atualização
boolean. Valor padrão: true.

Permite uma atualização para a implantação do Microsoft Azure.

SimultaneousUpgrade - Atualização simultânea
boolean. Opcional. Use quando AllowUpgrade == true. Valor padrão: false.

Atualiza todas as instâncias de uma só vez. O seu serviço na nuvem não está disponível durante este período.

ForceUpgrade - Force upgrade
boolean. Opcional. Use quando AllowUpgrade == true. Valor padrão: false.

Define uma atualização forçada. Forçar uma atualização pode causar perda de dados locais.

VerifyRoleInstanceStatus - Verificar o status da instância de função
boolean. Valor padrão: false.

Faz com que a tarefa aguarde até que as instâncias de função estejam no estado pronto.

DiagnosticStorageAccountKeys - Chaves de conta de armazenamento de diagnóstico
string.

Formate a cadeia de caracteres da chave de armazenamento como Role:Storagekey. O nome da conta de armazenamento de diagnóstico para cada função é recuperado do arquivo de configuração de diagnóstico (.wadcfgx).

Se o arquivo .wadcfgx de uma função não for encontrado: a extensão de diagnóstico não está definida para essa função.
Se o nome da conta de armazenamento não for encontrado no arquivo .wadcfgx: a conta de armazenamento padrão é usada para armazenar resultados de diagnóstico e os parâmetros da chave de armazenamento da tarefa de implantação são ignorados.

Observação : se houver informações confidenciais nos resultados de diagnóstico para seu ambiente, salve o storage_account_key como uma variável secreta. Por exemplo:

WebRole: WebRole_storage_account_key
WorkerRole: WorkerRole_stoarge_account_key

NewServiceCustomCertificates - Certificados personalizados para importar
string.

Formate a cadeia de caracteres de certificado personalizada como CertificatePfxBase64:CertificatePassword. Salve o certificate_password como uma variável secreta. Por exemplo:

Certificado1: Certificate1_password
Certificado2: Certificate2_password

NewServiceAdditionalArguments - Argumentos adicionais
string.

Passa argumentos adicionais ao criar um novo serviço. Os argumentos são passados para o cmdlet New-AzureService. Por exemplo, -Label 'MyTestService'.

NewServiceAffinityGroup - Grupo de afinidade
string.

O grupo de afinidade usado em vez do local do serviço ao criar um novo serviço.

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

Nenhum.

Observações

Use esta tarefa para implantar um Serviço de Nuvem do Azure.

Requerimentos

Requisito	Descrição
Tipos de pipeline	YAML, Construção clássica, Versão clássica
Funciona em	Agente
Exigências	Os agentes auto-hospedados devem ter recursos que correspondam às seguintes demandas executar trabalhos que usam essa tarefa: azureps
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	1.103.0 ou superior
Categoria de tarefa	Desplegar

Partilhar via