Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Use esta tarefa para carregar arquivos para uma máquina remota usando FTP ou com segurança com FTPS.
Esta versão da tarefa foi preterida; use FtpUpload@2.
Use esta tarefa para carregar arquivos para uma máquina remota usando FTP ou com segurança com FTPS.
Sintaxe
# 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.
Insumos
Método de autenticação credentialsOption -
Alias de entrada: credsType.
string. Obrigatório. Valores permitidos: serviceEndpoint (conexão de serviço FTP), inputs (Inserir credenciais). Valor padrão: serviceEndpoint.
Especifica o método de autenticação. Use uma conexão de serviço FTP ou insira as credenciais de conexão.
serverEndpoint
-
de Conexão de Serviço FTP
string. Necessário quando credsType = serviceEndpoint.
Especifica a conexão de serviço para o servidor FTP. Para criar uma, clique no link Gerenciar e crie uma nova conexão de serviço genérica e, em seguida, insira a URL do servidor FTP para a URL do servidor, por exemplo, ftp://server.example.com, e as credenciais necessárias.
Conexões seguras sempre serão feitas independentemente do protocolo especificado (ftp:// ou ftps://) se o servidor de destino suportar FTPS. Para permitir apenas conexões seguras, use o protocolo ftps://, por exemplo, ftps://server.example.com. As conexões com servidores que não suportam FTPS falharão se ftps:// for especificado.
serverUrl
-
URL do servidor
string. Necessário quando credsType = inputs.
Especifica a URL para o servidor FTP.
username
-
Nome de utilizador
string. Necessário quando credsType = inputs.
Especifica o nome de usuário para a conexão FTP.
password
-
Palavra-passe
string. Necessário quando credsType = inputs.
Especifica a senha para a conexão FTP.
rootDirectory
-
pasta raiz
Alias de entrada: rootFolder.
string. Obrigatório.
Especifica a pasta de origem a partir da qual carregar arquivos.
filePatterns
-
Padrões de arquivo
string. Obrigatório. Valor padrão: **.
Especifica os caminhos ou padrões de arquivo dos arquivos a serem carregados. A cadeia de caracteres suporta várias linhas de padrões de minimatch. Saiba mais sobre padrões de correspondência de arquivos.
remoteDirectory
-
de diretório remoto
Alias de entrada: remotePath.
string. Obrigatório. Valor padrão: /upload/$(Build.BuildId)/.
Especifica o diretório no servidor FTP remoto onde a tarefa carrega arquivos.
clean
-
Excluir diretório remoto
boolean. Valor padrão: false.
Exclui o diretório remoto, incluindo seu conteúdo, antes de carregar.
cleanContents
-
Limpar o conteúdo do diretório remoto
boolean. Opcional. Use quando clean = false. Valor padrão: false.
Recursivamente exclui todo o conteúdo no diretório remoto antes de carregar. O diretório existente não será excluído. Para um melhor desempenho, use clean em vez disso.
overwrite
-
Substituir
boolean. Valor padrão: true.
Substitui arquivos existentes no diretório remoto.
preservePaths
-
Preservar caminhos de arquivo
boolean. Valor padrão: false.
Se selecionada, a estrutura de diretórios local relativa é recriada no diretório remoto onde os arquivos são carregados. Caso contrário, os arquivos são carregados diretamente para o diretório remoto sem criar subdiretórios adicionais.
Por exemplo, suponha que sua pasta de origem seja /home/user/source/, que contém o arquivo foo/bar/foobar.txt, e seu diretório remoto seja: /uploads/. Se este booleano for selecionado, o arquivo será carregado para /uploads/foo/bar/foobar.txt. Se este booleano não estiver selecionado, o arquivo será carregado para /uploads/foobar.txt.
trustSSL
-
de certificado de servidor confiável
boolean. Valor padrão: false.
Confia no certificado SSL do servidor FTP com ftps://, mesmo que ele seja autoassinado ou não possa ser validado por uma autoridade de certificação (CA).
Opções de controlo de tarefas
Todas as tarefas têm opções de controle, além de suas entradas de tarefas. Para obter mais informações, consulte Opções de controle de e propriedades de tarefas comuns.
Variáveis de saída
Nenhum.
Observações
Use esta tarefa para carregar arquivos para uma máquina remota usando FTP ou com segurança com FTPS.
Observação
Existe uma versão mais recente desta tarefa disponível em FtpUpload@2.
Onde posso saber mais sobre padrões de correspondência de arquivos?
Requerimentos
| Requisito | Descrição |
|---|---|
| Tipos de pipeline | YAML, Construção clássica, Versão clássica |
| Funciona em | Agente, DeploymentGroup |
| Exigências | Nenhum |
| Capacidades | Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes no trabalho. |
| Restrições de comando | Esta tarefa é executada usando as seguintes restrições de comando : restrito |
| Variáveis configuráveis | Esta tarefa tem permissão para definir as seguintes variáveis: A configuração de variáveis está desativada |
| Versão do agente | 2.182.1 ou superior |
| Categoria de tarefa | Utilidade |