Compartir a través de


FtpUpload@1: tarea carga de FTP v1

Use esta tarea para cargar archivos en una máquina remota mediante FTP o de forma segura con FTPS.

Esta versión de la tarea está en desuso; use FtpUpload@2.

Use esta tarea para cargar archivos en una máquina remota mediante FTP o de forma segura con FTPS.

Sintaxis

# FTP upload v1
# Upload files using FTP.
- task: FtpUpload@1
  inputs:
    credentialsOption: 'serviceEndpoint' # 'serviceEndpoint' | 'inputs'. Alias: credsType. Required. Authentication Method. Default: serviceEndpoint.
    serverEndpoint: # string. Required when credsType = serviceEndpoint. FTP Service Connection. 
    #serverUrl: # string. Required when credsType = inputs. Server URL. 
    #username: # string. Required when credsType = inputs. Username. 
    #password: # string. Required when credsType = inputs. Password. 
    rootDirectory: # string. Alias: rootFolder. Required. Root folder. 
    filePatterns: '**' # string. Required. File patterns. Default: **.
    remoteDirectory: '/upload/$(Build.BuildId)/' # string. Alias: remotePath. Required. Remote directory. Default: /upload/$(Build.BuildId)/.
  # Advanced
    #clean: false # boolean. Delete remote directory. Default: false.
    #cleanContents: false # boolean. Optional. Use when clean = false. Clear remote directory contents. Default: false.
    #overwrite: true # boolean. Overwrite. Default: true.
    #preservePaths: false # boolean. Preserve file paths. Default: false.
    #trustSSL: false # boolean. Trust server certificate. Default: false.

Entradas

método de autenticación de credentialsOption -
Alias de entrada: credsType. string. Obligatorio. Valores permitidos: serviceEndpoint (conexión de servicio FTP), inputs (Escriba credenciales). Valor predeterminado: serviceEndpoint.

Especifica el método de autenticación. Use una conexión de servicio FTP o escriba las credenciales de conexión.


serverEndpoint - conexión de servicio FTP
string. Obligatorio cuando credsType = serviceEndpoint.

Especifica la conexión de servicio para el servidor FTP. Para crear uno, haga clic en el vínculo Administrar y cree una nueva conexión de servicio genérico y, a continuación, escriba la dirección URL del servidor FTP para la dirección URL del servidor, por ejemplo, ftp://server.example.comy las credenciales necesarias.

Las conexiones seguras siempre se realizarán independientemente del protocolo especificado (ftp:// o ftps://) si el servidor de destino admite FTPS. Para permitir solo conexiones seguras, use el protocolo ftps://, por ejemplo, ftps://server.example.com. Se producirá un error en las conexiones a servidores que no admiten FTPS si se especifica ftps://.


url del servidor de serverUrl -
string. Obligatorio cuando credsType = inputs.

Especifica la dirección URL del servidor FTP.


de nombre de usuario de username -
string. Obligatorio cuando credsType = inputs.

Especifica el nombre de usuario de la conexión FTP.


de contraseña de password -
string. Obligatorio cuando credsType = inputs.

Especifica la contraseña de la conexión FTP.


rootDirectory - carpeta raíz
Alias de entrada: rootFolder. string. Obligatorio.

Especifica la carpeta de origen desde la que cargar archivos.


patrones de archivo de filePatterns -
string. Obligatorio. Valor predeterminado: **.

Especifica las rutas de acceso de archivo o los patrones de los archivos que se van a cargar. La cadena admite varias líneas de patrones de minimatch. Obtenga más información sobre los patrones de coincidencia de archivos .


remoteDirectory - de directorio remoto
Alias de entrada: remotePath. string. Obligatorio. Valor predeterminado: /upload/$(Build.BuildId)/.

Especifica el directorio en el servidor FTP remoto donde la tarea carga los archivos.


clean - Eliminar de directorio remoto
boolean. Valor predeterminado: false.

Elimina el directorio remoto, incluido su contenido, antes de cargarlo.


cleanContents - Borrar el contenido del directorio remoto
boolean. Opcional. Use cuando clean = false. Valor predeterminado: false.

Elimina de forma recursiva todo el contenido del directorio remoto antes de cargarlo. No se eliminará el directorio existente. Para mejorar el rendimiento, use clean en su lugar.


overwrite - sobrescribir
boolean. Valor predeterminado: true.

Sobrescribe los archivos existentes en el directorio remoto.


preservePaths - conservar rutas de acceso de archivo
boolean. Valor predeterminado: false.

Si está seleccionada, la estructura de directorios local relativa se vuelve a crear en el directorio remoto donde se cargan los archivos. De lo contrario, los archivos se cargan directamente en el directorio remoto sin crear subdirectorios adicionales.

Por ejemplo, supongamos que la carpeta de origen es /home/user/source/, que contiene el archivo foo/bar/foobar.txty el directorio remoto es: /uploads/. Si se selecciona este valor booleano, el archivo se carga en /uploads/foo/bar/foobar.txt. Si no se selecciona este valor booleano, el archivo se carga en /uploads/foobar.txt.


de certificados de servidor de confianza de trustSSL -
boolean. Valor predeterminado: false.

Confía en el certificado SSL del servidor FTP con ftps://, incluso si está autofirmado o no se puede validar mediante una entidad de certificación (CA).


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

Use esta tarea para cargar archivos en una máquina remota mediante FTP o de forma segura con FTPS.

Nota:

Hay una versión más reciente de esta tarea disponible en FtpUpload@2.

¿Dónde puedo obtener más información sobre los patrones de coincidencia de archivos?

Requisitos

Requisito Descripción
Tipos de canalización YAML, compilación clásica, versión clásica
Se ejecuta en Agente, DeploymentGroup
demandas Ninguno
funcionalidades de Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
restricciones de comandos Esta tarea se ejecuta con las restricciones de comandos siguientes: restringido
variables settable 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 tarea Utilidad
Requisito Descripción
Tipos de canalización YAML, compilación clásica, versión clásica
Se ejecuta en Agente, DeploymentGroup
demandas Ninguno
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 Todas las versiones de agente admitidas.
Categoría de tarea Utilidad