FtpUpload@2 - Tarefa de carregamento de FTP v2
Utilize esta tarefa para carregar ficheiros para um computador remoto com FTP ou de forma segura com 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.
# 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.
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.
# 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.
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.
#preservePaths: false # boolean. Preserve file paths. Default: false.
#trustSSL: false # boolean. Trust server certificate. Default: false.
Entradas
credentialsOption
- Método de Autenticação
Alias de entrada: credsType
. string
. Obrigatório. Valores permitidos: serviceEndpoint
(ligação de serviço FTP), inputs
(Introduza credenciais). Valor predefinido: serviceEndpoint
.
Especifica o método de autenticação. Utilize uma ligação de serviço FTP ou introduza as credenciais de ligação.
serverEndpoint
- Ligação do Serviço FTP
string
. Necessário quando credsType = serviceEndpoint
.
Especifica a ligação de serviço para o servidor FTP. Para criar uma, clique na ligação Gerir e crie uma nova ligação de serviço genérica e, em seguida, introduza o URL do servidor FTP para o URL do servidor, por exemplo ftp://server.example.com
, e as credenciais necessárias.
As ligações seguras serão sempre efetuadas independentemente do protocolo especificado (ftp://
ou ftps://
) se o servidor de destino suportar FTPS. Para permitir apenas ligações seguras, utilize o ftps://
protocolo, por exemplo, ftps://server.example.com
. As ligações a servidores que não suportam FTPS falharão se ftps://
for especificado.
serverUrl
- URL do servidor
string
. Necessário quando credsType = inputs
.
Especifica o URL do servidor FTP.
username
- Nome de utilizador
string
. Necessário quando credsType = inputs
.
Especifica o nome de utilizador da ligação FTP.
password
- Palavra-passe
string
. Necessário quando credsType = inputs
.
Especifica a palavra-passe da ligação FTP.
implicitFTPS
- Utilizar FTPS implícito
boolean
. Valor predefinido: false
.
rootDirectory
- Pasta raiz
Alias de entrada: rootFolder
. string
. Obrigatório.
Especifica a pasta de origem a partir da qual carregar ficheiros.
filePatterns
- Padrões de ficheiro
string
. Obrigatório. Valor predefinido: **
.
Especifica os caminhos de ficheiro ou padrões dos ficheiros a carregar. A cadeia suporta múltiplas linhas de padrões de minimatch. Saiba mais sobre os padrões de correspondência de ficheiros.
remoteDirectory
- Diretório remoto
Alias de entrada: remotePath
. string
. Obrigatório. Valor predefinido: /upload/$(Build.BuildId)/
.
Especifica o diretório no servidor FTP remoto onde a tarefa carrega ficheiros.
enableUtf8
- Ativar o suporte UTF8
boolean
. Valor predefinido: false
.
Ativa o suporte UTF-8 para a ligação FTP (OPTS UTF8 ON
).
clean
- Eliminar diretório remoto
boolean
. Valor predefinido: false
.
Elimina o diretório remoto, incluindo o respetivo conteúdo, antes de carregar.
cleanContents
- Limpar conteúdo do diretório remoto
boolean
. Opcional. Utilize quando clean = false
. Valor predefinido: false
.
Elimina recursivamente todo o conteúdo no diretório remoto antes de carregar. O diretório existente não será eliminado. Para um melhor desempenho, utilize clean
em vez disso.
preservePaths
- Preservar caminhos de ficheiro
boolean
. Valor predefinido: false
.
Se selecionada, a estrutura de diretório local relativa é recriada no diretório remoto onde os ficheiros são carregados. Caso contrário, os ficheiros são carregados diretamente para o diretório remoto sem criar subdiretórios adicionais.
Por exemplo, suponha que a pasta de origem é /home/user/source/
, que contém o ficheiro foo/bar/foobar.txt
e o diretório remoto é: /uploads/
. Se este valor booleano estiver selecionado, o ficheiro será carregado para /uploads/foo/bar/foobar.txt
. Se este valor booleano não estiver selecionado, o ficheiro será carregado para /uploads/foobar.txt
.
trustSSL
- Certificado de servidor fidedigno
boolean
. Valor predefinido: false
.
Confia no certificado SSL do servidor FTP com ftps://
, mesmo que seja autoassinado ou não possa ser validado por uma autoridade de certificação (AC).
customCmds
- Comandos FTP
string
.
Os comandos FTP opcionais que serão enviados para o servidor FTP remoto após a ligação.
Opções de controlo de tarefas
Todas as tarefas têm opções de controlo para além das entradas de tarefas. Para obter mais informações, veja Opções de controlo e propriedades de tarefas comuns.
Variáveis de saída
Nenhum.
Observações
Utilize esta tarefa para carregar ficheiros para um computador remoto com FTP ou de forma segura com FTPS.
Onde posso saber mais sobre padrões de correspondência de ficheiros?
Requisitos
Requisito | Description |
---|---|
Tipos de pipeline | YAML, Compilação clássica, Versão clássica |
É executado em | Agente, DeploymentGroup |
Exigências | Nenhuma |
Capacidades | Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes na tarefa. |
Restrições de comandos | Esta tarefa é executada com as seguintes restrições de comandos: restritas |
Variáveis de tabelas definidas | Esta tarefa tem permissão para definir as seguintes variáveis: A definição de variáveis está desativada |
Versão do agente | 2.182.1 ou superior |
Categoria da tarefa | Utilitário |
Requisito | Description |
---|---|
Tipos de pipeline | YAML, Compilação clássica, Versão clássica |
É executado em | Agent, DeploymentGroup |
Exigências | Nenhuma |
Capacidades | Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes na tarefa. |
Restrições de comandos | Qualquer |
Variáveis de definição | Qualquer |
Versão do agente | Todas as versões de agente suportadas. |
Categoria da tarefa | Utilitário |