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.

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.txte 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?

• Referência de 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

Ver também

• Referência de padrões de correspondência de ficheiros