Condividi tramite


SSH@0 - Attività SSH v0

Usare questa attività per eseguire comandi della shell o uno script in un computer remoto usando SSH. Questa attività consente di connettersi a un computer remoto usando SSH ed eseguire comandi o uno script.

Sintassi

# SSH v0
# Run shell commands or a script on a remote machine using SSH.
- task: SSH@0
  inputs:
    sshEndpoint: # string. Required. SSH service connection. 
    runOptions: 'commands' # 'commands' | 'script' | 'inline'. Required. Run. Default: commands.
    commands: # string. Required when runOptions = commands. Commands. 
    #scriptPath: # string. Required when runOptions = script. Shell script path. 
    #inline: # string. Required when runOptions = inline. Inline Script. 
    #interpreterCommand: '/bin/bash' # string. Optional. Use when runOptions = inline. Interpreter command. Default: /bin/bash.
    #args: # string. Optional. Use when runOptions = script. Arguments. 
  # Advanced
    #failOnStdErr: true # boolean. Fail on STDERR. Default: true.
    #interactiveSession: false # boolean. Enable interactive session. Default: false.
    readyTimeout: '20000' # string. Required. SSH handshake timeout. Default: 20000.
    #interactiveKeyboardAuthentication: false # boolean. Use interactive-keyboard authentication. Default: false.
# SSH v0
# Run shell commands or a script on a remote machine using SSH.
- task: SSH@0
  inputs:
    sshEndpoint: # string. Required. SSH service connection. 
    runOptions: 'commands' # 'commands' | 'script' | 'inline'. Required. Run. Default: commands.
    commands: # string. Required when runOptions = commands. Commands. 
    #scriptPath: # string. Required when runOptions = script. Shell script path. 
    #inline: # string. Required when runOptions = inline. Inline Script. 
    #interpreterCommand: '/bin/bash' # string. Optional. Use when runOptions = inline. Interpreter command. Default: /bin/bash.
    #args: # string. Optional. Use when runOptions = script. Arguments. 
  # Advanced
    #failOnStdErr: true # boolean. Fail on STDERR. Default: true.
    #interactiveSession: false # boolean. Enable interactive session. Default: false.
    readyTimeout: '20000' # string. Required. SSH handshake timeout. Default: 20000.
# SSH v0
# Run shell commands or a script on a remote machine using SSH.
- task: SSH@0
  inputs:
    sshEndpoint: # string. Required. SSH service connection. 
    runOptions: 'commands' # 'commands' | 'script' | 'inline'. Required. Run. Default: commands.
    commands: # string. Required when runOptions = commands. Commands. 
    #scriptPath: # string. Required when runOptions = script. Shell script path. 
    #inline: # string. Required when runOptions = inline. Inline Script. 
    #args: # string. Optional. Use when runOptions = script. Arguments. 
  # Advanced
    #failOnStdErr: true # boolean. Fail on STDERR. Default: true.
    readyTimeout: '20000' # string. Required. SSH handshake timeout. Default: 20000.

Ingressi dati

sshEndpoint - connessione al servizio SSH
string. Obbligatorio.

Specifica il 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.
  • Una password può essere usata per eseguire l'autenticazione nei computer Linux remoti, ma non è supportata per i sistemi macOS o Windows.

runOptions - Esegui
string. Obbligatorio. Valori consentiti: commands, script (file script), inline (script inline). Valore predefinito: commands

Esegue i comandi della shell o uno script della shell nel computer remoto.


commands - comandi
string. Obbligatorio quando runOptions = commands.

Specifica i comandi della shell da eseguire nel computer remoto. Questo parametro è disponibile solo quando comando è selezionato per l'opzione Esegui. Immettere ogni comando insieme ai relativi argomenti in una nuova riga della casella di testo a più righe. Per eseguire più comandi insieme, immetterli nella stessa riga separata da punti e virgola. Esempio: cd /home/user/myFolder;build.

Nota

Ogni comando viene eseguito in un processo separato. Se si desidera eseguire una serie di comandi interdipendenti, ad esempio modificando la cartella corrente prima di eseguire un comando, usare l'opzione script inline.


scriptPath - percorso dello script shell
string. Obbligatorio quando runOptions = script.

Specifica il percorso del file di script della shell da eseguire nel computer remoto. Questo parametro è disponibile solo quando si seleziona script shell per l'opzione esegui .


inline - script inline
string. Obbligatorio quando runOptions = inline.

Scrive lo script della shell da eseguire nel computer remoto.


comando interprete interpreterCommand -
string. Opzionale. Usare quando runOptions = inline. Valore predefinito: /bin/bash

Specifica il percorso dell'interprete dei comandi utilizzato per eseguire lo script. Aggiunge una riga shebang all'inizio dello script. Rilevante solo per sistemi operativi simili a UNIX. Usa una stringa vuota per gli host remoti basati su Windows. Altre informazioni su shebang (#!).


args - argomenti
string. Opzionale. Usare quando runOptions = script.

Specifica gli argomenti da passare allo script della shell. Questo parametro è disponibile solo quando si seleziona script shell per l'opzione esegui .


errore di failOnStdErr - in STDERR
boolean. Valore predefinito: true

Se il valore è true, la compilazione ha esito negativo quando i comandi remoti o lo script scrivono in STDERR.


interactiveSession - Abilitare sessione interattiva
boolean. Valore predefinito: false

Avvia una sessione interattiva. Le richieste di password vengono compilate dalla password dell'utente. Le sessioni interattive possono essere utili per l'esecuzione di comandi, ad esempio sudo.


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

Specifica per quanto tempo (in millisecondi) l'attività attende il completamento dell'handshake SSH.


interactiveKeyboardAuthentication - Usare l'autenticazione tramite tastiera interattiva
boolean. Valore predefinito: false

Abilita l'autenticazione tramite tastiera interattiva. Impostare su true se il server SSH di destinazione richiede l'autenticazione tramite tastiera interattiva (PasswordAuthentication è disabilitato nel computer di destinazione/impostato su No in sshd_config).


Opzioni di controllo attività

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

Variabili di output

Nessuno.

Osservazioni:

Usare questa attività per eseguire comandi della shell o uno script in un computer remoto usando SSH. Questa attività consente di connettersi a un computer remoto usando SSH ed eseguire comandi o uno script.

Prerequisiti

  • L'attività supporta l'uso di una coppia di chiavi SSH per connettersi ai computer remoti.
  • La chiave pubblica deve essere preinstallata o copiata nei computer remoti.

Algoritmi supportati

Algoritmi di coppia di chiavi

  • RSA
  • DSA

Algoritmi di crittografia

  • AES256-CBC
  • AES192-CBC
  • AES128-CBC
  • pesce palla-cbc
  • 3DES-CBC
  • arcfour256
  • arcfour128
  • cast128-CBC
  • arcofour

Per OpenSSL v1.0.1 e versioni successive (in agente):

  • AES256-CTR
  • AES192-CTR
  • AES128-CTR

Per OpenSSL v1.0.1 e versioni successive, NodeJS v0.11.12 e versioni successive (in agente):

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 Qualunque
variabili impostabili Qualunque
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 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

Vedere anche