Partilhar via


CopyFilesOverSSH@0 - Copiar arquivos sobre a tarefa SSH v0

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