Condividi tramite

SSH@0 - Attività SSH v0

  • Articolo

Usare questa attività per eseguire comandi shell o uno script in un computer remoto tramite 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.

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

Input

sshEndpoint - Connessione del servizio SSH
string. Obbligatorio.

Specifica il nome di una connessione del 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 ai computer Linux remoti, ma non è supportata per i sistemi macOS o Windows.

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

Esegue comandi 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 i comandi vengono selezionati 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 vuole eseguire una serie di comandi interdipendenti ,ad esempio modificando la cartella corrente prima di eseguire un comando, usare invece l'opzione Script inline .


scriptPath - Percorso 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 lo script shell è selezionato per l'opzione Esegui .


inline - Inline Script
string. Obbligatorio quando runOptions = inline.

Scrive lo script della shell da eseguire nel computer remoto.


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

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


args - Argomenti
string. facoltativo. Usare quando runOptions = script.

Specifica gli argomenti da passare allo script della shell. Questo parametro è disponibile solo quando lo script shell è selezionato per l'opzione Esegui .


failOnStdErr - Errore 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 la sessione interattiva
boolean. Valore predefinito: false.

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


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

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


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

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


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.

Osservazioni

Usare questa attività per eseguire comandi shell o uno script in un computer remoto tramite 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 chiave

  • RSA
  • DSA

Algoritmi di crittografia

  • aes256-cbc
  • aes192-cbc
  • aes128-cbc
  • blowfish-cbc
  • 3des-cbc
  • arcfour256
  • arcfour128
  • cast128-cbc
  • arcfour

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):

  • aes128-gcm
  • aes128-gcm@openssh.com
  • aes256-gcm
  • aes256-gcm@openssh.com

Requisiti

Requisito Descrizione
Tipi di pipeline YAML, build classica, versione classica
Viene eseguito 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.206.1 o versione successiva
Categoria attività Distribuisci
Requisito Descrizione
Tipi di pipeline YAML, build classica, versione classica
Viene eseguito 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
Viene eseguito 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à Distribuisci

Vedi anche