FtpUpload@2: tarea de carga de FTP v2

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

Syntax

# FTP upload v2
# Upload files using FTP.
- task: FtpUpload@2
  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. 
    #implicitFTPS: false # boolean. Use implicit FTPS. Default: false.
    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
    #enableUtf8: false # boolean. Enable UTF8 support. Default: false.
    #clean: false # boolean. Delete remote directory. Default: false.
    #cleanContents: false # boolean. Optional. Use when clean = false. Clear remote directory contents. Default: false.
    #preservePaths: false # boolean. Preserve file paths. Default: false.
    #trustSSL: false # boolean. Trust server certificate. Default: false.
    #customCmds: # string. FTP Commands.

Entradas

credentialsOption - Método de autenticación
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. Necesario 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.com, y 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 ftps:// protocolo, por ejemplo, ftps://server.example.com. Si se especifica, se producirá un error ftps:// en las conexiones a servidores que no admiten FTPS.

serverUrl - Dirección URL del servidor
string. Necesario cuando credsType = inputs.

Especifica la dirección URL del servidor FTP.

username - Nombre de usuario
string. Necesario cuando credsType = inputs.

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

password - Contraseña
string. Necesario cuando credsType = inputs.

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

implicitFTPS - Uso de FTPS implícitos
boolean. Valor predeterminado: false.

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

Especifica la carpeta de origen desde la que cargar los archivos.

filePatterns - Patrones de archivo
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 - 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.

enableUtf8 - Habilitación de la compatibilidad con UTF8
boolean. Valor predeterminado: false.

Habilita la compatibilidad con UTF-8 para la conexión FTP (OPTS UTF8 ON).

clean - Eliminar 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. El directorio existente no se eliminará. Para mejorar el rendimiento, use clean en su lugar.

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.

trustSSL - Certificado de servidor de confianza
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).

customCmds - Comandos FTP
string.

Los comandos FTP opcionales que se enviarán al servidor FTP remoto tras la conexión.

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.

Comentarios

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

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

• Referencia de 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
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:	Utilidad

Consulte también

• Referencia de patrones de coincidencia de archivos