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.
Copie arquivos ou construa artefatos para uma máquina remota por SSH.
Sintaxe
# Copy files over SSH v0
# Copy files or build artifacts to a remote machine over SSH.
- task: CopyFilesOverSSH@0
inputs:
sshEndpoint: # string. Required. SSH service connection.
#sourceFolder: # string. Source folder.
contents: '**' # string. Required. Contents. Default: **.
#targetFolder: # string. Target folder.
# Advanced
#isWindowsOnTarget: false # boolean. Target machine running Windows. Default: false.
#cleanTargetFolder: false # boolean. Clean target folder. Default: false.
#cleanHiddenFilesInTarget: false # boolean. Optional. Use when cleanTargetFolder = true. Remove hidden files in target folder. Default: false.
readyTimeout: '20000' # string. Required. SSH handshake timeout. Default: 20000.
#overwrite: true # boolean. Overwrite. Default: true.
#failOnEmptySource: false # boolean. Fail if no files found to copy. Default: false.
#flattenFolders: false # boolean. Flatten folders. Default: false.
#concurrentUploads: '10' # string. Number of concurrent uploads when copying files. Default: 10.
#delayBetweenUploads: '50' # string. Delay between queueing uploads (in milliseconds). Default: 50.
# Copy files over SSH v0
# Copy files or build artifacts to a remote machine over SSH.
- task: CopyFilesOverSSH@0
inputs:
sshEndpoint: # string. Required. SSH service connection.
#sourceFolder: # string. Source folder.
contents: '**' # string. Required. Contents. Default: **.
#targetFolder: # string. Target folder.
# Advanced
#isWindowsOnTarget: false # boolean. Target machine running Windows. Default: false.
#cleanTargetFolder: false # boolean. Clean target folder. Default: false.
#cleanHiddenFilesInTarget: false # boolean. Optional. Use when cleanTargetFolder = true. Remove hidden files in target folder. Default: false.
readyTimeout: '20000' # string. Required. SSH handshake timeout. Default: 20000.
#overwrite: true # boolean. Overwrite. Default: true.
#failOnEmptySource: false # boolean. Fail if no files found to copy. Default: false.
#flattenFolders: false # boolean. Flatten folders. Default: false.
Insumos
sshEndpoint
-
de conexão de serviço SSH
string. Obrigatório.
O nome de uma conexão de serviço SSH contendo detalhes de conexão para a máquina remota.
- O nome do host ou endereço IP da máquina remota, o número da porta e o nome de usuário são necessários para criar uma conexão de serviço SSH.
- A chave privada e a frase secreta devem ser especificadas para autenticação.
sourceFolder
-
pasta de origem
string.
A pasta de origem dos arquivos a serem copiados para a máquina remota. Quando vazio, a raiz do repositório (build) ou diretório de artefatos (release) é usada, que é $(System.DefaultWorkingDirectory). Use variáveis se os arquivos não estiverem no repositório. Exemplo: $(Agent.BuildDirectory).
contents
-
Conteúdo
string. Obrigatório. Valor padrão: **.
Os caminhos de arquivo a serem incluídos como parte da cópia. Suporta várias linhas de padrões de minicorrespondência. O valor padrão é **, que inclui todos os arquivos (incluindo subpastas) na pasta de origem.
- Exemplo:
**/*.*(jar|war)inclui todos os arquivos .jar e .war (incluindo subpastas) na pasta de origem. - Exemplo:
"** \n !**/*.xml"inclui todos os arquivos (incluindo subpastas) na pasta de origem, mas exclui arquivos xml.
targetFolder
-
Pasta de destino
string.
A pasta de destino na máquina remota, onde os arquivos serão copiados. Exemplo: /home/user/MySite. Prefácio com um til (~) para especificar o diretório base do usuário.
isWindowsOnTarget
-
máquina de destino que executa o Windows
boolean. Valor padrão: false.
Verifica se a máquina de destino está executando o Windows.
cleanTargetFolder
-
Limpar pasta de destino
boolean. Valor padrão: false.
Exclui todos os arquivos e subpastas existentes na pasta de destino antes de copiar.
cleanHiddenFilesInTarget
-
Remover arquivos ocultos na pasta de destino
boolean. Opcional. Use quando cleanTargetFolder = true. Valor padrão: false.
Quando definido como true, remove arquivos ocultos na pasta de destino.
readyTimeout
-
tempo limite de aperto de mão SSH
string. Obrigatório. Valor padrão: 20000.
Quanto tempo (em milissegundos) esperar até que o aperto de mão SSH seja concluído.
overwrite
-
Substituir
boolean. Valor padrão: true.
Substitui os arquivos existentes dentro e abaixo da pasta de destino.
failOnEmptySource
-
Falha se nenhum arquivo encontrado para copiar
boolean. Valor padrão: false.
Falha se nenhum arquivo correspondente a ser copiado for encontrado na pasta de origem.
flattenFolders
-
Nivelar pastas
boolean. Valor padrão: false.
Nivela a estrutura de pastas e copia todos os arquivos para a pasta de destino especificada na máquina remota.
concurrentUploads
-
Número de uploads simultâneos ao copiar arquivos
string. Valor padrão: 10.
Número de carregamentos simultâneos ao copiar ficheiros. O padrão é 10.
delayBetweenUploads
-
Atraso entre carregamentos enfileirados (em milissegundos)
string. Valor padrão: 50.
Atraso entre carregamentos enfileirados (em milissegundos). O padrão é 50.
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.
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.206.1 ou superior |
| Categoria de tarefa | Desplegar |
| 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 | Desplegar |