Compartir a través de


AzureFileCopy@2: tarea copia de archivos de Azure v2

Copie archivos en Azure Blob Storage o máquinas virtuales.

Esta tarea está en desuso, ya que esta versión de la tarea AzureFileCopy usa una versión retirada de AzCopy. Use la versión más reciente de la tarea AzureFileCopy. Consulte Guía de migración de AzCopy para v8 a v10.

Copie archivos en Azure Blob Storage o máquinas virtuales.

Sintaxis

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

Entradas

SourcePath - origen
string. Obligatorio.

Especifique la ruta de acceso absoluta a la carpeta de origen, el archivo en el equipo local o un recurso compartido UNC. El valor o la expresión especificados deben devolver un solo nombre de carpeta o un nombre de archivo.


azureConnectionType - de tipo de conexión de Azure
Alias de entrada: ConnectedServiceNameSelector. string. Valores permitidos: ConnectedServiceName (Azure clásico), ConnectedServiceNameARM (Azure Resource Manager). Valor predeterminado: ConnectedServiceNameARM.

Especifique el tipo de conexión de Azure.


azureClassicSubscription - de suscripción clásica de Azure
Alias de entrada: ConnectedServiceName. string. Obligatorio cuando ConnectedServiceNameSelector = ConnectedServiceName.

Especifique la suscripción de Azure clásica de destino.


azureSubscription - de suscripción de Azure
Alias de entrada: ConnectedServiceNameARM. string. Obligatorio cuando ConnectedServiceNameSelector = ConnectedServiceNameARM.

Especifique la suscripción de Azure Resource Manager de destino.


tipo de destino de Destination -
string. Obligatorio. Valores permitidos: AzureBlob (Blob de Azure), AzureVMs (máquinas virtuales de Azure).

Especifique el tipo de destino que se va a usar para copiar los archivos.


classicStorage - de cuenta de almacenamiento clásica
Alias de entrada: StorageAccount. string. Obligatorio cuando ConnectedServiceNameSelector = ConnectedServiceName.

Especifique una cuenta de almacenamiento clásica existente previamente. Esta es la cuenta de almacenamiento que se usa como intermediario para copiar archivos en máquinas virtuales de Azure.


storage - de cuenta de almacenamiento de RM
Alias de entrada: StorageAccountRM. string. Obligatorio cuando ConnectedServiceNameSelector = ConnectedServiceNameARM.

Especifique una cuenta de almacenamiento arm existente previamente. Esta es la cuenta de almacenamiento que se usa como intermediario para copiar archivos en máquinas virtuales de Azure.


ContainerName - nombre de contenedor
string. Obligatorio cuando Destination = AzureBlob.

Especifique el nombre del contenedor en el que se copian los archivos. Si el contenedor especificado no existe en la cuenta de almacenamiento, se creará.

Para crear un directorio virtual dentro del contenedor, use la entrada de prefijo Blob. Por ejemplo, para la ubicación de destino https://myaccount.blob.core.windows.net/mycontainer/vd1/vd2/, especifique el nombre del contenedor mycontainer y el prefijo blob vd1/vd2.


de prefijo de blob de BlobPrefix -
string. Opcional. Use cuando Destination = AzureBlob.

Especifique un prefijo que se pueda usar para filtrar archivos.

Ejemplo: puede anexar un número de compilación para filtrar los archivos de todos los blobs con el mismo número de compilación.

Ejemplo: si especifica un prefijo blob myvd1, se crea un directorio virtual dentro del contenedor. Los archivos se copian del origen en https://myaccount.blob.core.windows.net/mycontainer/myvd1/.


de servicio en la nube de cloudService -
Alias de entrada: EnvironmentName. string. Obligatorio cuando ConnectedServiceNameSelector = ConnectedServiceName && Destination = AzureVMs.

Especifique el nombre del servicio en la nube de destino.


de grupo de recursos de resourceGroup -
Alias de entrada: EnvironmentNameRM. string. Obligatorio cuando ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs.

Especifique el nombre del grupo de recursos de destino.


ResourceFilteringMethod - Seleccionar máquinas por
string. Opcional. Use cuando Destination = AzureVMs. Valores permitidos: machineNames (nombres de máquina), tags. Valor predeterminado: machineNames.

Especifique el nombre de host o la etiqueta de la máquina virtual que identifica un subconjunto de máquinas virtuales de un grupo de recursos. etiquetas solo se admiten para los recursos creados a través de Azure Resource Manager.


MachineNames - criterios de filtro
string. Opcional. Use cuando Destination = AzureVMs.

Proporcione una lista de nombres de host de máquina virtual de Azure, como ffweb, ffdbo etiquetas como Role:DB, Web, OS:Win8.1.

Nota: Los delimitadores válidos para las etiquetas incluyen ,(coma), :(colon) y ;(semicolon). Al proporcionar varias etiquetas, la tarea se ejecutará en todas las máquinas virtuales que contengan las etiquetas especificadas. De forma predeterminada, la tarea se ejecuta en todas las máquinas virtuales.


de inicio de sesión de administrador de vmsAdminUserName -
string. Obligatorio cuando Destination = AzureVMs.

Proporcione el nombre de usuario de la cuenta de administrador de máquina virtual de Azure.


de contraseña de vmsAdminPassword -
string. Obligatorio cuando Destination = AzureVMs.

Proporcione la contraseña de la cuenta de administrador de máquina virtual de Azure.

La entrada válida incluye variables definidas en canalizaciones de compilación o versión, como $(passwordVariable). Para proteger una contraseña, marque como secret.


carpeta de destino de TargetPath -
string. Obligatorio cuando Destination = AzureVMs.

Especifique la ruta de acceso local en las máquinas virtuales de destino.

La entrada válida incluye variables de entorno como $env:windir\BudgetIT\Web.


AdditionalArgumentsForBlobCopy - argumentos opcionales (para cargar archivos en blob)
string.

Proporcione argumentos adicionales para AzCopy.exe que se pueden aplicar al cargar en blobs, como /NC:10.

Si no se especifica ningún argumento opcional, los argumentos siguientes se agregan de forma predeterminada.

  • /Y
  • /SetContentType
  • /Z
  • /V
  • /S: se agrega cuando el nombre del contenedor no es $root.
  • /BlobType:page: se agrega cuando la cuenta de almacenamiento especificada es una cuenta Premium.
  • /Pattern: se agrega cuando la ruta de acceso de origen es un archivo. Se incluye con cualquier otro argumento opcional especificado.

AdditionalArgumentsForVMCopy - argumentos opcionales (para descargar archivos en la máquina virtual)
string. Opcional. Use cuando Destination = AzureVMs.

Proporcione argumentos adicionales para AzCopy.exe que se pueden aplicar al descargar en máquinas virtuales como /NC:10.

Si no se especifica ningún argumento opcional, se agregan de forma predeterminada lo siguiente.

  • /Y
  • /S
  • /Z
  • /V

enableCopyPrerequisites - habilitar los requisitos previos de copia
boolean. Opcional. Use cuando ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs. Valor predeterminado: false.

Cuando se habilita, usa un certificado autofirmado para configurar un agente de escucha de Administración remota de Windows (WinRM) en el puerto 5986 en lugar del protocolo HTTPS. Necesario para realizar operaciones de copia en máquinas virtuales de Azure. Si las máquinas virtuales de destino usan un equilibrador de carga, configure reglas NAT de entrada para el puerto de destino (5986). Solo se aplica a las máquinas virtuales arm.


copia de CopyFilesInParallel - en en paralelo
boolean. Opcional. Use cuando Destination = AzureVMs. Valor predeterminado: true.

Al aceptar la configuración predeterminada, se copian los archivos en paralelo a las máquinas virtuales de destino.


CleanTargetBeforeCopy - de destino limpio
boolean. Opcional. Use cuando Destination = AzureVMs. Valor predeterminado: false.

Al establecer este valor en true limpia la carpeta de destino antes de realizar la acción de copia.


skipCACheck - de certificado de prueba
boolean. Opcional. Use cuando Destination = AzureVMs. Valor predeterminado: true.

El valor predeterminado no validará que un ca de confianza firmó el certificado de servidor antes de conectarse a través de HTTPS.


outputStorageUri - URI del contenedor de almacenamiento
string.

Especifique el nombre de la variable usada para el URI del contenedor de almacenamiento al que se copiaron los archivos. Válido solo cuando el destino seleccionado es un blob de Azure.


outputStorageContainerSasToken - token de SAS del contenedor de almacenamiento
string.

Especifique el nombre de la variable usada para el token de SAS del contenedor de almacenamiento que tiene acceso a los archivos que se copiaron. Válido solo cuando el destino seleccionado es un blob de Azure.


Opciones de control de tareas

Todas las tareas tienen opciones de control además de sus entradas de tarea. Para obtener más información, consulte Opciones de control y propiedades de tareas comunes.

Variables de salida

Ninguno.

Observaciones

Novedades de la versión 2.0: Uso de la versión más reciente de AzCopy.

Requisitos

Requisito Descripción
Tipos de canalización YAML, compilación clásica, versión clásica
Se ejecuta en Agente, DeploymentGroup
demandas Los agentes autohospedados deben tener funcionalidades que coincidan con los siguientes exigen ejecutar trabajos que usen esta tarea: azureps
funcionalidades de Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
restricciones de comandos Cualquiera
variables settable Cualquiera
Versión del agente 1.103.0 o superior
Categoría de tarea Desplegar