FtpUpload@1 - Tarefa de carregamento de FTP v1

Utilize esta tarefa para carregar ficheiros para um computador remoto através de FTP ou de forma segura com 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.
# FTP Upload v1
# FTP Upload.
- 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 Autenticação
Alias de entrada: credsType. string. Obrigatório. Valores permitidos: serviceEndpoint (ligação do 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 ligação, 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. Connections para 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 para o servidor FTP.


username - Nome de utilizador
string. Necessário quando credsType = inputs.

Especifica o nome de utilizador para a ligação ftp.


password - Palavra-passe
string. Necessário quando credsType = inputs.

Especifica a palavra-passe para a ligação ftp.


rootDirectory - Pasta raiz
Alias de entrada: rootFolder. string. Obrigatório.

Especifica a pasta de origem a partir da que pretende 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 de carateres suporta múltiplas linhas de padrões de correspondência. 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.


clean - Eliminar diretório remoto
boolean. Valor predefinido: false.

Elimina o diretório remoto, incluindo o respetivo conteúdo, antes do carregamento.


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.


overwrite - Substituir
boolean. Valor predefinido: true.

Substitui ficheiros existentes no diretório remoto.


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 booleano estiver selecionado, o ficheiro é carregado para /uploads/foo/bar/foobar.txt. Se este booleano não estiver selecionado, o ficheiro é carregado para /uploads/foobar.txt.


trustSSL - Certificado de servidor de fidedignidade
boolean. Valor predefinido: false.

Confia no certificado SSL do servidor FTP com ftps://, mesmo que esteja autoassinado ou não possa ser validado por uma autoridade de certificação (AC).


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 através de FTP ou de forma segura com FTPS.

Nota

Existe uma versão mais recente desta tarefa disponível em FtpUpload@2.

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 Agent, 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 comando: restritas
Variáveis de definição 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