CopyFilesOverSSH@0: tarea Copiar archivos a través de SSH v0

Copie archivos o cree artefactos en una máquina remota a través de SSH.

Syntax

# Copy files over SSH v0
# Copy files or build artifacts to a remote machine over SSH.
- task: CopyFilesOverSSH@0
  inputs:
    sshEndpoint: # string. Required. SSH service connection. 
    #sourceFolder: # string. Source folder. 
    contents: '**' # string. Required. Contents. Default: **.
    #targetFolder: # string. Target folder. 
  # Advanced
    #isWindowsOnTarget: false # boolean. Target machine running Windows. Default: false.
    #cleanTargetFolder: false # boolean. Clean target folder. Default: false.
    #cleanHiddenFilesInTarget: false # boolean. Optional. Use when cleanTargetFolder = true. Remove hidden files in target folder. Default: false.
    readyTimeout: '20000' # string. Required. SSH handshake timeout. Default: 20000.
    #overwrite: true # boolean. Overwrite. Default: true.
    #failOnEmptySource: false # boolean. Fail if no files found to copy. Default: false.
    #flattenFolders: false # boolean. Flatten folders. Default: false.
# Copy files over SSH v0
# Copy files or build artifacts to a remote machine over SSH.
- task: CopyFilesOverSSH@0
  inputs:
    sshEndpoint: # string. Required. SSH service connection. 
    #sourceFolder: # string. Source folder. 
    contents: '**' # string. Required. Contents. Default: **.
    #targetFolder: # string. Target folder. 
  # Advanced
    #isWindowsOnTarget: false # boolean. Target machine running Windows. Default: false.
    #cleanTargetFolder: false # boolean. Clean target folder. Default: false.
    readyTimeout: '20000' # string. Required. SSH handshake timeout. Default: 20000.
    #overwrite: true # boolean. Overwrite. Default: true.
    #failOnEmptySource: false # boolean. Fail if no files found to copy. Default: false.
    #flattenFolders: false # boolean. Flatten folders. Default: false.
# Copy files over SSH v0
# Copy files or build artifacts to a remote machine over SSH.
- task: CopyFilesOverSSH@0
  inputs:
    sshEndpoint: # string. Required. SSH service connection. 
    #sourceFolder: # string. Source folder. 
    contents: '**' # string. Required. Contents. Default: **.
    #targetFolder: # string. Target folder. 
  # Advanced
    #cleanTargetFolder: false # boolean. Clean target folder. Default: false.
    #overwrite: true # boolean. Overwrite. Default: true.
    #failOnEmptySource: false # boolean. Fail if no files found to copy. Default: false.
    #flattenFolders: false # boolean. Flatten folders. Default: false.
# Copy Files Over SSH v0
# Copy files or build artifacts to a remote machine over SSH.
- task: CopyFilesOverSSH@0
  inputs:
    sshEndpoint: # string. Required. SSH service connection. 
    #sourceFolder: # string. Source folder. 
    contents: '**' # string. Required. Contents. Default: **.
    #targetFolder: # string. Target folder. 
  # Advanced
    #cleanTargetFolder: false # boolean. Clean target folder. Default: false.
    #overwrite: true # boolean. Overwrite. Default: true.
    #failOnEmptySource: false # boolean. Fail if no files found to copy. Default: false.
    #flattenFolders: false # boolean. Flatten folders. Default: false.

Entradas

sshEndpoint - Conexión de servicio SSH
string. Obligatorio.

Nombre de una conexión de servicio SSH que contiene los detalles de conexión de la máquina remota.

  • - El nombre de host o la dirección IP de la máquina remota, el número de puerto y el nombre de usuario son necesarios para crear una conexión de servicio SSH.
  • La clave privada y la frase de contraseña deben especificarse para la autenticación.

sourceFolder - Carpeta de origen
string.

Carpeta de origen de los archivos que se van a copiar en el equipo remoto. Cuando está vacío, se usa la raíz del repositorio (compilación) o el directorio de artefactos (versión), que es $(System.DefaultWorkingDirectory). Use variables si los archivos no están en el repositorio. Ejemplo: $(Agent.BuildDirectory).


contents - Contenido
string. Obligatorio. Valor predeterminado: **.

Rutas de acceso de archivo que se van a incluir como parte de la copia. Admite varias líneas de patrones de minimatch. El valor predeterminado es **, que incluye todos los archivos (incluidas las subcarpetas) en la carpeta de origen.

  • Ejemplo: **/*.*(jar|war) incluye todos los archivos .jar y .war (incluidas las subcarpetas) en la carpeta de origen.
  • Ejemplo: "** \n !**/*.xml" incluye todos los archivos (incluidas las subcarpetas) en la carpeta de origen, pero excluye los archivos xml.

targetFolder - Carpeta de destino
string.

La carpeta de destino de la máquina remota, donde se copiarán los archivos. Ejemplo: /home/user/MySite. Prefacio con una tilde (~) para especificar el directorio principal del usuario.


isWindowsOnTarget - Máquina de destino que ejecuta Windows
boolean. Valor predeterminado: false.

Comprueba si la máquina de destino ejecuta Windows.


cleanTargetFolder - Carpeta de destino limpia
boolean. Valor predeterminado: false.

Elimina todos los archivos y subcarpetas existentes de la carpeta de destino antes de copiarlos.


cleanHiddenFilesInTarget - Eliminación de archivos ocultos en la carpeta de destino
boolean. Opcional. Use cuando cleanTargetFolder = true. Valor predeterminado: false.

Cuando se establece trueen , quita los archivos ocultos en la carpeta de destino.


readyTimeout - Tiempo de espera del protocolo de enlace SSH
string. Obligatorio. Valor predeterminado: 20000.

Cuánto tiempo (en milisegundos) esperar a que se complete el protocolo de enlace SSH.


overwrite - Sobrescribir
boolean. Valor predeterminado: true.

Reemplaza los archivos existentes en y debajo de la carpeta de destino.


failOnEmptySource - Se produce un error si no se ha encontrado ningún archivo para copiar
boolean. Valor predeterminado: false.

Se produce un error si no se encuentra ningún archivo coincidente en la carpeta de origen.


flattenFolders - Acoplar carpetas
boolean. Valor predeterminado: false.

Acopla la estructura de carpetas y copia todos los archivos en la carpeta de destino especificada en el equipo remoto.


Opciones de control de tareas

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

Variables de salida

Ninguno.

Requisitos

Requisito Descripción
Tipos de canalización YAML, compilación clásica, versión clásica
Se ejecuta en Agente, DeploymentGroup
Peticiones None
Capabilities Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
Restricciones de comandos Esta tarea se ejecuta con las siguientes restricciones de comandos: restringido
Variables que se pueden establecer Esta tarea tiene permiso para establecer las siguientes variables: La configuración de variables está deshabilitada.
Versión del agente 2.206.1 o superior
Categoría de la tarea: Implementar
Requisito Descripción
Tipos de canalización YAML, compilación clásica, versión clásica
Se ejecuta en Agente, DeploymentGroup
Peticiones None
Capabilities Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
Restricciones de comandos Esta tarea se ejecuta con las siguientes restricciones de comandos: restringido
Variables que se pueden establecer Esta tarea tiene permiso para establecer las siguientes variables: La configuración de variables está deshabilitada.
Versión del agente 2.182.1 o superior
Categoría de la tarea: Implementar
Requisito Descripción
Tipos de canalización YAML, compilación clásica, versión clásica
Se ejecuta en Agente, DeploymentGroup
Peticiones None
Capabilities Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
Restricciones de comandos Any
Variables que se pueden establecer Any
Versión del agente 2.144.0 o superior
Categoría de la tarea: Implementar
Requisito Descripción
Tipos de canalización YAML, compilación clásica, versión clásica
Se ejecuta en Agente, DeploymentGroup
Peticiones None
Capabilities Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
Restricciones de comandos Any
Variables que se pueden establecer Any
Versión del agente 2.102.0 o superior
Categoría de la tarea: Implementación