Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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.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 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.txt
y 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 |