Compartilhar via


CopyFilesOverSSH@0 – Copiar arquivos na tarefa SSH v0

Copiar arquivos ou compilar artefatos para um computador remoto 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.
# 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.
    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.

Entradas

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 o computador remoto.

  • O nome do host ou endereço IP do computador remoto, 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 o computador remoto. Quando vazia, a raiz do repositório (build) ou do diretório de artefatos (versão) é usada, que é $(System.DefaultWorkingDirectory). Use variáveis se os arquivos não estiverem no repositório. Exemplo: $(Agent.BuildDirectory).


contents - Contents
string. Obrigatório Valor padrão: **.

Os caminhos de arquivo a serem incluídos como parte da cópia. Dá suporte a várias linhas de padrões de minimatch de . O valor padrão é **, que inclui todos os arquivos (incluindo subpasta) na pasta de origem.

  • Exemplo: **/*.*(jar|war) inclui todos os arquivos .jar e .war (incluindo subpasta) na pasta de origem.
  • Exemplo: "** \n !**/*.xml" inclui todos os arquivos (incluindo subpasta) na pasta de origem, mas exclui arquivos xml.

de pasta de destino targetFolder -
string.

A pasta de destino no computador remoto, onde os arquivos serão copiados. Exemplo: /home/user/MySite. Prefácio com um bloco (~) para especificar o diretório base do usuário.


isWindowsOnTarget - computador de destino executando o Windows
boolean. Valor padrão: false.

Verifica se o computador de destino está executando o Windows.


cleanTargetFolder - limpar de 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 do handshake SSH
string. Obrigatório Valor padrão: 20000.

Quanto tempo (em milissegundos) aguardar a conclusão do handshake SSH.


overwrite - substituir
boolean. Valor padrão: true.

Substitui arquivos existentes dentro e abaixo da pasta de destino.


failOnEmptySource - Falhar 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.


de pastas de nivelar flattenFolders -
boolean. Valor padrão: false.

Nivela a estrutura de pastas e copia todos os arquivos na pasta de destino especificada no computador remoto.


concurrentUploads - Número de uploads simultâneos ao copiar arquivos
string. Valor padrão: 10.

Número de uploads simultâneos ao copiar arquivos. O padrão é 10.


delayBetweenUploads - Atraso entre uploads de fila (em milissegundos)
string. Valor padrão: 50.

Atraso entre uploads de fila (em milissegundos). O padrão é 50.


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.

Requisitos

Requisito Descrição
Tipos de pipeline YAML, build clássico, versão clássica
Execuções em Agent, 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.206.1 ou superior
Categoria de tarefa Implantar
Requisito Descrição
Tipos de pipeline YAML, build clássico, versão clássica
Execuções em Agent, 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 Implantar
Requisito Descrição
Tipos de pipeline YAML, build clássico, versão clássica
Execuções em Agent, DeploymentGroup
de demandas Nenhum
recursos Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
restrições de comando Qualquer
variáveis settable Qualquer
Versão do agente 2.144.0 ou superior
Categoria de tarefa Implantar
Requisito Descrição
Tipos de pipeline YAML, build clássico, versão clássica
Execuções em Agent, DeploymentGroup
de demandas Nenhum
recursos Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
restrições de comando Qualquer
variáveis settable Qualquer
Versão do agente 2.102.0 ou superior
Categoria de tarefa Implantar