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

Input

sshEndpoint - Connessione del servizio SSH
string. Obbligatorio.

Nome di una connessione al servizio SSH contenente i dettagli di 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 la directory degli artefatti (versione), ovvero $(System.DefaultWorkingDirectory). Usare le variabili se i file non sono presenti 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 minimatch. Il valore predefinito è **, che include tutti i file (incluse le sottocartelle) nella cartella di origine.

  • Esempio: **/*.*(jar|war) include tutti i file di .jar e con estensione 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 una tilde (~) per specificare la home directory dell'utente.


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

Verifica se il computer di destinazione esegue Windows.


cleanTargetFolder - Pulire la cartella di destinazione
boolean. Valore predefinito: false.

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


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

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


readyTimeout - Timeout handshake SSH
string. Obbligatorio. Valore predefinito: 20000.

Quanto tempo (in millisecondi) per attendere il completamento dell'handshake SSH.


overwrite - Sovrascrivere
boolean. Valore predefinito: true.

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


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

Non riesce se non vengono copiati file corrispondenti nella cartella di origine.


flattenFolders - Cartelle flat
boolean. Valore predefinito: false.

Esegue l'flating della struttura di cartelle e copia tutti i file nella cartella di destinazione specificata nel computer remoto.


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
Esecuzione in Agente, DeploymentGroup
Richieste Nessuno
Capabilities Questa attività non soddisfa le richieste per le attività successive nel processo.
Restrizioni dei comandi Questa attività viene eseguita usando le restrizioni di comando seguenti: limitato
Variabili impostabili Questa attività dispone dell'autorizzazione per impostare le variabili seguenti: l'impostazione delle variabili è disabilitata
Versione agente 2.206.1 o versione successiva
Categoria attività Distribuisci
Requisito Descrizione
Tipi di pipeline YAML, build classica, versione classica
Esecuzione in Agente, DeploymentGroup
Richieste Nessuno
Capabilities Questa attività non soddisfa le richieste per le attività successive nel processo.
Restrizioni dei comandi Questa attività viene eseguita usando le restrizioni di comando seguenti: limitato
Variabili impostabili Questa attività dispone dell'autorizzazione per impostare le variabili seguenti: l'impostazione delle variabili è disabilitata
Versione agente 2.182.1 o versione successiva
Categoria attività Distribuisci
Requisito Descrizione
Tipi di pipeline YAML, build classica, versione classica
Esecuzione in Agente, DeploymentGroup
Richieste Nessuno
Capabilities Questa attività non soddisfa le richieste per le attività successive nel processo.
Restrizioni dei comandi Qualsiasi
Variabili impostabili Qualsiasi
Versione agente 2.144.0 o versione successiva
Categoria attività Distribuisci
Requisito Descrizione
Tipi di pipeline YAML, build classica, versione classica
Esecuzione in Agente, DeploymentGroup
Richieste Nessuno
Capabilities Questa attività non soddisfa le richieste per le attività successive nel processo.
Restrizioni dei comandi Qualsiasi
Variabili impostabili Qualsiasi
Versione agente 2.102.0 o versione successiva
Categoria attività Distribuire