Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Use essa tarefa para carregar arquivos em um computador remoto usando FTP ou com segurança com FTPS.
Esta versão da tarefa foi preterida; use FtpUpload@2.
Use essa tarefa para carregar arquivos em um computador remoto 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.
Entradas
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 insira a URL do servidor FTP para a URL do servidor, por exemplo, ftp://server.example.come as credenciais necessárias.
Conexões seguras sempre serão feitas independentemente do protocolo especificado (ftp:// ou ftps://) se o servidor de destino der suporte a 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 dão suporte ao FTPS falharão se ftps:// for especificado.
de URL do servidor serverUrl -
string. Necessário quando credsType = inputs.
Especifica a URL do servidor FTP.
username
-
de nome de usuário
string. Necessário quando credsType = inputs.
Especifica o nome de usuário para a conexão FTP.
password
-
de senha
string. Necessário quando credsType = inputs.
Especifica a senha da conexão FTP.
rootDirectory
-
pasta raiz
Alias de entrada: rootFolder.
string. Obrigatório
Especifica a pasta de origem da qual carregar arquivos.
padrões de arquivo filePatterns -
string. Obrigatório Valor padrão: **.
Especifica os caminhos de arquivo ou padrões dos arquivos a serem carregados. A cadeia de caracteres dá suporte a 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 em que a tarefa carrega arquivos.
clean
-
Excluir de 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.
Exclui recursivamente todo o conteúdo no diretório remoto antes de carregar. O diretório existente não será excluído. Para obter 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ório local relativa será recriada no diretório remoto em que os arquivos são carregados. Caso contrário, os arquivos são carregados diretamente no 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 esse booliano estiver selecionado, o arquivo será carregado para /uploads/foo/bar/foobar.txt. Se esse booliano não estiver selecionado, o arquivo será carregado para /uploads/foobar.txt.
trustSSL
-
de certificado do 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 AC (autoridade de certificação).
Opções de controle de tarefa
Todas as tarefas têm opções de controle além das suas entradas de tarefas. Para obter mais informações, consulte as opções de Controle de e as propriedades comuns da tarefa.
Variáveis de saída
Nenhum.
Observações
Use essa tarefa para carregar arquivos em um computador remoto usando FTP ou com segurança com FTPS.
Observação
Há uma versão mais recente dessa tarefa disponível em FtpUpload@2.
Onde posso saber mais sobre padrões de correspondência de arquivos?
Requisitos
| Requisito | Descrição |
|---|---|
| Tipos de pipeline | YAML, build clássico, versão clássica |
| Execuções em | Agente, DeploymentGroup |
| de demandas | Nenhum |
| recursos | Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho. |
| restrições de comando | Esta tarefa é executada usando as seguintes restrições de comando : restrito |
| variáveis settable | Essa tarefa tem permissão para definir as seguintes variáveis: a configuração de variáveis está desabilitada |
| Versão do agente | 2.182.1 ou superior |
| Categoria de tarefa | Utilidade |