FtpUpload@1: tarea de carga de FTP v1

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

Syntax

# 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

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 del 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, . Connections a los servidores que no admiten FTPS producirán un error si ftps:// se especifica .

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.

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

Especifica la carpeta de origen desde la que cargar 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.

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.

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 directorio 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 este valor booleano no está seleccionado, 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).

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.

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?

• 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