Condividi tramite


CopyFilesOverSSH@0 - Copiare file tramite l'attività SSH v0

Copiare file o creare artefatti in un computer remoto tramite SSH.

Sintassi

# 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.

Ingressi dati

sshEndpoint - connessione al servizio SSH
string. Obbligatorio.

Nome di una connessione al servizio SSH contenente i dettagli della connessione per il computer remoto.

  • Il nome host o l'indirizzo IP del computer remoto, il numero di porta e il nome utente sono necessari per creare una connessione al servizio SSH.
  • La chiave privata e la passphrase devono essere specificate per l'autenticazione.

sourceFolder - cartella di origine
string.

Cartella di origine dei file da copiare nel computer remoto. Se vuoto, viene usata la radice del repository (build) o della directory degli artefatti (versione), che è $(System.DefaultWorkingDirectory). Usare variabili se i file non si trovano nel repository. Esempio: $(Agent.BuildDirectory).


contents - contenuto
string. Obbligatorio. Valore predefinito: **

Percorsi di file da includere come parte della copia. Supporta più righe di modelli di minimatch. Il valore predefinito è **, che include tutti i file (incluse le sottocartelle) nella cartella di origine.

  • Esempio: **/*.*(jar|war) include tutti i file .jar e war (incluse le sottocartelle) nella cartella di origine.
  • Esempio: "** \n !**/*.xml" include tutti i file (incluse le sottocartelle) nella cartella di origine, ma esclude i file xml.

targetFolder - Cartella di destinazione
string.

Cartella di destinazione nel computer remoto, in cui verranno copiati i file. Esempio: /home/user/MySite. Prefazione con un (~) tilde per specificare la home directory dell'utente.


isWindowsOnTarget - computer di destinazione che esegue Windows
boolean. Valore predefinito: false

Controlla se il computer di destinazione esegue Windows.


cleanTargetFolder - cartella di destinazione pulita
boolean. Valore predefinito: false

Elimina tutti i file e le sottocartelle esistenti nella cartella di destinazione prima della copia.


cleanHiddenFilesInTarget - Rimuovere i file nascosti nella cartella di destinazione
boolean. Opzionale. Usare quando cleanTargetFolder = true. Valore predefinito: false

Se impostato su true, rimuove i file nascosti nella cartella di destinazione.


readyTimeout - timeout dell'handshake SSH
string. Obbligatorio. Valore predefinito: 20000

Tempo (in millisecondi) di attesa del completamento dell'handshake SSH.


overwrite - Sovrascrivere
boolean. Valore predefinito: true

Sostituisce i file esistenti in e sotto la cartella di destinazione.


failOnEmptySource - Esito negativo se non sono stati trovati file da copiare
boolean. Valore predefinito: false

Ha esito negativo se non vengono trovati file corrispondenti da copiare nella cartella di origine.


flattenFolders - flat cartelle
boolean. Valore predefinito: false

Rende flat la struttura di cartelle e copia tutti i file nella cartella di destinazione specificata nel computer remoto.


concurrentUploads - Numero di caricamenti simultanei durante la copia di file
string. Valore predefinito: 10

Numero di caricamenti simultanei durante la copia dei file. Il valore predefinito è 10.


delayBetweenUploads - Ritardo tra caricamenti in coda (in millisecondi)
string. Valore predefinito: 50

Ritardo tra caricamenti in coda (in millisecondi). Il valore predefinito è 50.


Opzioni di controllo delle attività

Tutte le attività dispongono di opzioni di controllo oltre ai relativi input attività. Per altre informazioni, vedere Opzioni di controllo e proprietà comuni delle attività.

Variabili di output

Nessuno.

Requisiti

Requisito Descrizione
Tipi di pipeline YAML, build classica, versione classica
Viene eseguito in Agente, DeploymentGroup
richieste Nessuno
funzionalità di Questa attività non soddisfa alcuna richiesta di attività successive nel processo.
restrizioni dei comandi Questa attività viene eseguita usando le restrizioni del comando seguenti: con restrizioni
variabili impostabili Questa attività dispone dell'autorizzazione per impostare le variabili seguenti: L'impostazione delle variabili è disabilitata
Versione dell'agente 2.206.1 o versione successiva
Categoria attività Distribuire
Requisito Descrizione
Tipi di pipeline YAML, build classica, versione classica
Viene eseguito in Agente, DeploymentGroup
richieste Nessuno
funzionalità di Questa attività non soddisfa alcuna richiesta di attività successive nel processo.
restrizioni dei comandi Questa attività viene eseguita usando le restrizioni del comando seguenti: con restrizioni
variabili impostabili Questa attività dispone dell'autorizzazione per impostare le variabili seguenti: L'impostazione delle variabili è disabilitata
Versione dell'agente 2.182.1 o versione successiva
Categoria attività Distribuire
Requisito Descrizione
Tipi di pipeline YAML, build classica, versione classica
Viene eseguito in Agente, DeploymentGroup
richieste Nessuno
funzionalità di Questa attività non soddisfa alcuna richiesta di attività successive nel processo.
restrizioni dei comandi Qualunque
variabili impostabili Qualunque
Versione dell'agente 2.144.0 o versione successiva
Categoria attività Distribuire
Requisito Descrizione
Tipi di pipeline YAML, build classica, versione classica
Viene eseguito in Agente, DeploymentGroup
richieste Nessuno
funzionalità di Questa attività non soddisfa alcuna richiesta di attività successive nel processo.
restrizioni dei comandi Qualunque
variabili impostabili Qualunque
Versione dell'agente 2.102.0 o versione successiva
Categoria attività Distribuire