AzureFileCopy@2 - Tarefa v2 de cópia de ficheiros do Azure
Copie ficheiros para Armazenamento de Blobs do Azure ou máquinas virtuais.
Nota
Esta tarefa não suporta a autenticação do Azure Resource Manager com a federação de identidade do fluxo de trabalho.
Syntax
# Azure file copy v2
# Copy files to Azure Blob Storage or virtual machines.
- task: AzureFileCopy@2
inputs:
SourcePath: # string. Required. Source.
#azureConnectionType: 'ConnectedServiceNameARM' # 'ConnectedServiceName' | 'ConnectedServiceNameARM'. Alias: ConnectedServiceNameSelector. Azure Connection Type. Default: ConnectedServiceNameARM.
#azureClassicSubscription: # string. Alias: ConnectedServiceName. Required when ConnectedServiceNameSelector = ConnectedServiceName. Azure Classic Subscription.
azureSubscription: # string. Alias: ConnectedServiceNameARM. Required when ConnectedServiceNameSelector = ConnectedServiceNameARM. Azure Subscription.
Destination: # 'AzureBlob' | 'AzureVMs'. Required. Destination Type.
#classicStorage: # string. Alias: StorageAccount. Required when ConnectedServiceNameSelector = ConnectedServiceName. Classic Storage Account.
storage: # string. Alias: StorageAccountRM. Required when ConnectedServiceNameSelector = ConnectedServiceNameARM. RM Storage Account.
#ContainerName: # string. Required when Destination = AzureBlob. Container Name.
#BlobPrefix: # string. Optional. Use when Destination = AzureBlob. Blob Prefix.
#cloudService: # string. Alias: EnvironmentName. Required when ConnectedServiceNameSelector = ConnectedServiceName && Destination = AzureVMs. Cloud Service.
#resourceGroup: # string. Alias: EnvironmentNameRM. Required when ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs. Resource Group.
#ResourceFilteringMethod: 'machineNames' # 'machineNames' | 'tags'. Optional. Use when Destination = AzureVMs. Select Machines By. Default: machineNames.
#MachineNames: # string. Optional. Use when Destination = AzureVMs. Filter Criteria.
#vmsAdminUserName: # string. Required when Destination = AzureVMs. Admin Login.
#vmsAdminPassword: # string. Required when Destination = AzureVMs. Password.
#TargetPath: # string. Required when Destination = AzureVMs. Destination Folder.
#AdditionalArgumentsForBlobCopy: # string. Optional Arguments (for uploading files to blob).
#AdditionalArgumentsForVMCopy: # string. Optional. Use when Destination = AzureVMs. Optional Arguments (for downloading files to VM).
#enableCopyPrerequisites: false # boolean. Optional. Use when ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs. Enable Copy Prerequisites. Default: false.
#CopyFilesInParallel: true # boolean. Optional. Use when Destination = AzureVMs. Copy in Parallel. Default: true.
#CleanTargetBeforeCopy: false # boolean. Optional. Use when Destination = AzureVMs. Clean Target. Default: false.
#skipCACheck: true # boolean. Optional. Use when Destination = AzureVMs. Test Certificate. Default: true.
# Output
#outputStorageUri: # string. Storage Container URI.
#outputStorageContainerSasToken: # string. Storage Container SAS Token.
# Azure File Copy v2
# Copy files to Azure blob or VM(s).
- task: AzureFileCopy@2
inputs:
SourcePath: # string. Required. Source.
#azureConnectionType: 'ConnectedServiceNameARM' # 'ConnectedServiceName' | 'ConnectedServiceNameARM'. Alias: ConnectedServiceNameSelector. Azure Connection Type. Default: ConnectedServiceNameARM.
#azureClassicSubscription: # string. Alias: ConnectedServiceName. Required when ConnectedServiceNameSelector = ConnectedServiceName. Azure Classic Subscription.
azureSubscription: # string. Alias: ConnectedServiceNameARM. Required when ConnectedServiceNameSelector = ConnectedServiceNameARM. Azure Subscription.
Destination: # 'AzureBlob' | 'AzureVMs'. Required. Destination Type.
#classicStorage: # string. Alias: StorageAccount. Required when ConnectedServiceNameSelector = ConnectedServiceName. Classic Storage Account.
storage: # string. Alias: StorageAccountRM. Required when ConnectedServiceNameSelector = ConnectedServiceNameARM. RM Storage Account.
#ContainerName: # string. Required when Destination = AzureBlob. Container Name.
#BlobPrefix: # string. Optional. Use when Destination = AzureBlob. Blob Prefix.
#cloudService: # string. Alias: EnvironmentName. Required when ConnectedServiceNameSelector = ConnectedServiceName && Destination = AzureVMs. Cloud Service.
#resourceGroup: # string. Alias: EnvironmentNameRM. Required when ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs. Resource Group.
#ResourceFilteringMethod: 'machineNames' # 'machineNames' | 'tags'. Optional. Use when Destination = AzureVMs. Select Machines By. Default: machineNames.
#MachineNames: # string. Optional. Use when Destination = AzureVMs. Filter Criteria.
#vmsAdminUserName: # string. Required when Destination = AzureVMs. Admin Login.
#vmsAdminPassword: # string. Required when Destination = AzureVMs. Password.
#TargetPath: # string. Required when Destination = AzureVMs. Destination Folder.
#AdditionalArgumentsForBlobCopy: # string. Optional Arguments (for uploading files to blob).
#AdditionalArgumentsForVMCopy: # string. Optional. Use when Destination = AzureVMs. Optional Arguments (for downloading files to VM).
#enableCopyPrerequisites: false # boolean. Optional. Use when ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs. Enable Copy Prerequisites. Default: false.
#CopyFilesInParallel: true # boolean. Optional. Use when Destination = AzureVMs. Copy in Parallel. Default: true.
#CleanTargetBeforeCopy: false # boolean. Optional. Use when Destination = AzureVMs. Clean Target. Default: false.
#skipCACheck: true # boolean. Optional. Use when Destination = AzureVMs. Test Certificate. Default: true.
# Output
#outputStorageUri: # string. Storage Container URI.
#outputStorageContainerSasToken: # string. Storage Container SAS Token.
Entradas
SourcePath
- Origem
string
. Obrigatório.
Especifique o caminho absoluto para a pasta de origem, ficheiro no computador local ou uma partilha UNC. O valor ou expressão especificado deve devolver um nome de pasta única ou um nome de ficheiro.
azureConnectionType
- Tipo de Ligação do Azure
Alias de entrada: ConnectedServiceNameSelector
. string
. Valores permitidos: ConnectedServiceName
(Azure Classic), ConnectedServiceNameARM
(Azure Resource Manager). Valor predefinido: ConnectedServiceNameARM
.
Especifique o tipo de ligação do Azure.
azureClassicSubscription
- Subscrição Clássica do Azure
Alias de entrada: ConnectedServiceName
. string
. Necessário quando ConnectedServiceNameSelector = ConnectedServiceName
.
Especifique a subscrição clássica do Azure de destino.
azureSubscription
- Subscrição do Azure
Alias de entrada: ConnectedServiceNameARM
. string
. Necessário quando ConnectedServiceNameSelector = ConnectedServiceNameARM
.
Especifique a subscrição do Azure Resource Manager de destino.
Destination
- Tipo de Destino
string
. Obrigatório. Valores permitidos: AzureBlob
(Blob do Azure), AzureVMs
(VMs do Azure).
Especifique o tipo de destino a utilizar para copiar os ficheiros.
classicStorage
- Conta de Armazenamento Clássica
Alias de entrada: StorageAccount
. string
. Necessário quando ConnectedServiceNameSelector = ConnectedServiceName
.
Especifique uma conta de armazenamento clássica pré-existente. Esta é a conta de armazenamento utilizada como intermediário para copiar ficheiros para VMs do Azure.
storage
- Conta de Armazenamento RM
Alias de entrada: StorageAccountRM
. string
. Necessário quando ConnectedServiceNameSelector = ConnectedServiceNameARM
.
Especifique uma conta de armazenamento arm pré-existente. Esta é a conta de armazenamento utilizada como intermediário para copiar ficheiros para VMs do Azure.
ContainerName
- Nome do Contentor
string
. Necessário quando Destination = AzureBlob
.
Especifique o nome do contentor no qual os ficheiros são copiados. Se o contentor especificado não existir na conta de armazenamento, será criado.
Para criar um diretório virtual dentro do contentor, utilize a entrada de prefixo blob. Por exemplo, para a localização de destino https://myaccount.blob.core.windows.net/mycontainer/vd1/vd2/
, especifique o nome mycontainer
do contentor e o prefixo blob vd1/vd2
.
BlobPrefix
- Prefixo de Blobs
string
. Opcional. Utilize quando Destination = AzureBlob
.
Especifique um prefixo que possa ser utilizado para filtrar ficheiros.
Exemplo: pode acrescentar um número de compilação para filtrar os ficheiros de todos os Blobs com o mesmo número de compilação.
Exemplo: se especificar um prefixo myvd1
de Blob, é criado um diretório virtual dentro do contentor. Os ficheiros são copiados da origem para https://myaccount.blob.core.windows.net/mycontainer/myvd1/
.
cloudService
- Serviço Cloud
Alias de entrada: EnvironmentName
. string
. Necessário quando ConnectedServiceNameSelector = ConnectedServiceName && Destination = AzureVMs
.
Especifique o nome do Serviço Cloud de destino.
resourceGroup
- Grupo de Recursos
Alias de entrada: EnvironmentNameRM
. string
. Necessário quando ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs
.
Especifique o nome do Grupo de Recursos de destino.
ResourceFilteringMethod
- Selecionar Máquinas Por
string
. Opcional. Utilize quando Destination = AzureVMs
. Valores permitidos: machineNames
(Nomes das Máquinas), tags
. Valor predefinido: machineNames
.
Especifique o nome ou etiqueta do anfitrião da VM que identifica um subconjunto de VMs num grupo de recursos. As etiquetas são suportadas para recursos criados apenas através do Azure Resource Manager.
MachineNames
- Critérios de Filtro
string
. Opcional. Utilize quando Destination = AzureVMs
.
Forneça uma lista de nomes de anfitriões de VMs do Azure, como ffweb
, ffdb
ou etiquetas como Role:DB
, Web
, OS:Win8.1
.
Nota: os delimitadores válidos para etiquetas incluem ,(vírgula), :(colon) e ;(semicolon). Ao fornecer várias etiquetas, a tarefa será executada em todas as VMs que contêm as etiquetas especificadas. Por predefinição, a tarefa é executada em todas as VMs.
vmsAdminUserName
- Início de Sessão do Administração
string
. Necessário quando Destination = AzureVMs
.
Indique o nome de utilizador da conta de administrador da VM do Azure.
vmsAdminPassword
- Palavra-passe
string
. Necessário quando Destination = AzureVMs
.
Indique a palavra-passe da conta de administrador da VM do Azure.
A entrada válida inclui variáveis definidas em pipelines de compilação ou versão, como $(passwordVariable)
. Para proteger uma palavra-passe, marque-a como secret
.
TargetPath
- Pasta de Destino
string
. Necessário quando Destination = AzureVMs
.
Especifique o caminho local nas VMs de destino.
A entrada válida inclui variáveis de ambiente, como $env:windir\BudgetIT\Web
.
AdditionalArgumentsForBlobCopy
- Argumentos Opcionais (para carregar ficheiros para blob)
string
.
Forneça argumentos adicionais para que possam ser aplicados ao AzCopy.exe
carregar para Blobs, como /NC:10
.
Se não forem especificados argumentos opcionais, os seguintes argumentos são adicionados por predefinição.
/Y
/SetContentType
/Z
/V
/S
- Adicionado quando o nome do contentor não$root
é ./BlobType:page
- Adicionado quando a conta de armazenamento especificada é uma conta premium./Pattern
- Adicionado quando o caminho de origem é um ficheiro. Incluído com quaisquer outros argumentos opcionais especificados.
AdditionalArgumentsForVMCopy
- Argumentos Opcionais (para transferir ficheiros para a VM)
string
. Opcional. Utilize quando Destination = AzureVMs
.
Forneça argumentos adicionais para que possam ser aplicados ao AzCopy.exe
transferir para VMs como /NC:10
.
Se não forem especificados argumentos opcionais, os seguintes são adicionados por predefinição.
/Y
/S
/Z
/V
enableCopyPrerequisites
- Ativar Pré-requisitos de Cópia
boolean
. Opcional. Utilize quando ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs
. Valor predefinido: false
.
Quando ativado, utiliza um certificado autoassinado para configurar um serviço de escuta de Gestão Remota do Windows (WinRM) na porta 5986 em vez do protocolo HTTPS. Necessário para realizar operações de cópia em VMs do Azure. Se as VMs de destino utilizarem um balanceador de carga, configure regras NAT de entrada para a porta de destino (5986). Aplica-se apenas a VMs do ARM.
CopyFilesInParallel
- Copiar em Paralelo
boolean
. Opcional. Utilize quando Destination = AzureVMs
. Valor predefinido: true
.
Aceitar a predefinição copia ficheiros em paralelo para as VMs de destino.
CleanTargetBeforeCopy
- Destino Limpo
boolean
. Opcional. Utilize quando Destination = AzureVMs
. Valor predefinido: false
.
Definir este valor para true
limpar a pasta de destino antes de executar a ação de cópia.
skipCACheck
- Certificado de Teste
boolean
. Opcional. Utilize quando Destination = AzureVMs
. Valor predefinido: true
.
O valor predefinido não validará que o certificado de servidor foi assinado por uma AC fidedigna antes de se ligar através de HTTPS.
outputStorageUri
- URI do Contentor de Armazenamento
string
.
Especifique o nome da variável utilizada para o URI do contentor de armazenamento para o qual os ficheiros foram copiados. Válido apenas quando o destino selecionado é um Blob do Azure.
outputStorageContainerSasToken
- Token de SAS de Contentor de Armazenamento
string
.
Especifique o nome da variável utilizada para o token SAS do contentor de armazenamento que acede aos ficheiros que foram copiados. Válido apenas quando o destino selecionado é um Blob do Azure.
Opções de controlo de tarefas
Todas as tarefas têm opções de controlo para além das entradas de tarefas. Para obter mais informações, veja Opções de controlo e propriedades de tarefas comuns.
Variáveis de saída
Nenhum.
Observações
Novidades na Versão 2.0: utilizar a versão mais recente do AzCopy.
Requisitos
Requisito | Description |
---|---|
Tipos de pipeline | YAML, Compilação clássica, Versão clássica |
É executado em | Agente, DeploymentGroup |
Exigências | Os agentes autoalojados têm de ter capacidades que correspondam às seguintes exigências para executar tarefas que utilizam esta tarefa: azureps |
Capacidades | Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes na tarefa. |
Restrições de comandos | Qualquer |
Variáveis de tabelas definidas | Qualquer |
Versão do agente | 1.103.0 ou superior |
Categoria da tarefa | Implementação |