Partilhar via


CopyFilesOverSSH@0 - Copiar ficheiros através da tarefa SSH v0

Copie ficheiros ou crie artefactos para um computador remoto através de SSH.

Syntax

# 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.
# 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
    #cleanTargetFolder: false # boolean. Clean target folder. Default: false.
    #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
    #cleanTargetFolder: false # boolean. Clean target folder. Default: false.
    #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 - Ligação do serviço SSH
string. Obrigatório.

O nome de uma ligação de serviço SSH que contém detalhes de ligação para o computador remoto.

  • O nome de anfitrião ou endereço IP do computador remoto, o número da porta e o nome de utilizador são necessários para criar uma ligação de serviço SSH.
  • A chave privada e a frase de acesso têm de ser especificadas para autenticação.

sourceFolder - Pasta de origem
string.

A pasta de origem dos ficheiros a copiar para o computador remoto. Quando estiver vazia, é utilizada a raiz do diretório de repositório (compilação) ou artefactos (versão), que é $(System.DefaultWorkingDirectory). Utilize variáveis se os ficheiros não estiverem no repositório. Exemplo: $(Agent.BuildDirectory).


contents - Conteúdo
string. Obrigatório. Valor predefinido: **.

Os caminhos de ficheiro a incluir como parte da cópia. Suporta várias linhas de padrões de minimatch. O valor predefinido é **, que inclui todos os ficheiros (incluindo subpastas) na pasta de origem.

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

targetFolder - Pasta de destino
string.

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


isWindowsOnTarget - Computador de destino a executar o Windows
boolean. Valor predefinido: false.

Verifica se o computador de destino está a executar o Windows.


cleanTargetFolder - Limpar pasta de destino
boolean. Valor predefinido: false.

Elimina todos os ficheiros e subpastas existentes na pasta de destino antes de copiar.


cleanHiddenFilesInTarget - Remover ficheiros ocultos na pasta de destino
boolean. Opcional. Utilize quando cleanTargetFolder = true. Valor predefinido: false.

Quando definido como true, remove ficheiros ocultos na pasta de destino.


readyTimeout - Tempo limite do handshake SSH
string. Obrigatório. Valor predefinido: 20000.

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


overwrite - Substituir
boolean. Valor predefinido: true.

Substitui os ficheiros existentes dentro e abaixo da pasta de destino.


failOnEmptySource - Falha se não forem encontrados ficheiros para copiar
boolean. Valor predefinido: false.

Falha se não forem encontrados ficheiros correspondentes na pasta de origem.


flattenFolders - Aplanar pastas
boolean. Valor predefinido: false.

Aplana a estrutura da pasta e copia todos os ficheiros para a pasta de destino especificada no computador remoto.


Opções de controlo de tarefas

Todas as tarefas têm opções de controlo para além das entradas de tarefas. Para obter mais informações, veja Opções de controlo e propriedades de tarefas comuns.

Variáveis de saída

Nenhum.

Requisitos

Requisito Description
Tipos de pipeline YAML, Compilação clássica, Versão clássica
É executado em Agente, DeploymentGroup
Exigências Nenhuma
Capacidades Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes na tarefa.
Restrições de comandos Esta tarefa é executada com as seguintes restrições de comandos: restritas
Variáveis de tabelas definidas Esta tarefa tem permissão para definir as seguintes variáveis: A definição de variáveis está desativada
Versão do agente 2.206.1 ou superior
Categoria da tarefa Implementar
Requisito Description
Tipos de pipeline YAML, Compilação clássica, Versão clássica
É executado em Agente, DeploymentGroup
Exigências Nenhuma
Capacidades Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes na tarefa.
Restrições de comandos Esta tarefa é executada com as seguintes restrições de comandos: restritas
Variáveis de tabelas definidas Esta tarefa tem permissão para definir as seguintes variáveis: A definição de variáveis está desativada
Versão do agente 2.182.1 ou superior
Categoria da tarefa Implementar
Requisito Description
Tipos de pipeline YAML, Compilação clássica, Versão clássica
É executado em Agente, DeploymentGroup
Exigências Nenhuma
Capacidades Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes na tarefa.
Restrições de comandos Qualquer
Variáveis de definição Qualquer
Versão do agente 2.144.0 ou superior
Categoria da tarefa Implementar
Requisito Description
Tipos de pipeline YAML, Compilação clássica, Versão clássica
É executado em Agent, DeploymentGroup
Exigências Nenhuma
Capacidades Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes na tarefa.
Restrições de comandos Qualquer
Variáveis de definição Qualquer
Versão do agente 2.102.0 ou superior
Categoria da tarefa Implementação