SSH@0 : SSH v0-Aufgabe

Führt Shellbefehle oder ein Skript auf einem Remotecomputer mithilfe von SSH aus. Mit dieser Aufgabe können Sie über SSH eine Verbindung mit einem Remotecomputer herstellen und Befehle oder ein Skript ausführen.

Syntax

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

Eingaben

sshEndpoint - SSH-Dienstverbindung
string. Erforderlich.

Gibt den Namen einer SSH-Dienstverbindung an, die Verbindungsdetails für den Remotecomputer enthält. Der Hostname oder die IP-Adresse des Remotecomputers, die Portnummer und der Benutzername sind erforderlich, um eine SSH-Dienstverbindung herzustellen.

• Der private Schlüssel und die Passphrase müssen für die Authentifizierung angegeben werden.
• Ein Kennwort kann zur Authentifizierung bei Linux-Remotecomputern verwendet werden, dies wird jedoch nicht für macOS- oder Windows-Systeme unterstützt.

runOptions - Ausführen
string. Erforderlich. Zulässige Werte: commands, script (Skriptdatei), inline (Inlineskript). Standardwert. commands.

Führt Shellbefehle oder ein Shellskript auf dem Remotecomputer aus.

commands - Befehle
string. Erforderlich, wenn runOptions = commands.

Gibt die Shellbefehle an, die auf dem Remotecomputer ausgeführt werden sollen. Dieser Parameter ist nur verfügbar, wenn Befehle für die Option Ausführen ausgewählt ist. Geben Sie jeden Befehl zusammen mit seinen Argumenten in eine neue Zeile des mehrzeiligen Textfelds ein. Um mehrere Befehle zusammen auszuführen, geben Sie sie in derselben Durch Semikolons getrennten Zeile ein. Beispiel: cd /home/user/myFolder;build.

Hinweis

Jeder Befehl wird in einem separaten Prozess ausgeführt. Wenn Sie eine Reihe von Befehlen ausführen möchten, die voneinander abhängig sind (z. B. ändern Sie den aktuellen Ordner vor dem Ausführen eines Befehls), verwenden Sie stattdessen die Option Inlineskript .

scriptPath - Shellskriptpfad
string. Erforderlich, wenn runOptions = script.

Gibt den Pfad zur Shellskriptdatei an, die auf dem Remotecomputer ausgeführt werden soll. Dieser Parameter ist nur verfügbar, wenn Shell script für die Option Ausführen ausgewählt ist.

inline - Inlineskript
string. Erforderlich, wenn runOptions = inline.

Schreibt das Shellskript, das auf dem Remotecomputer ausgeführt werden soll.

interpreterCommand - Interpreterbefehl
string. Optional. Verwenden Sie , wenn runOptions = inline. Standardwert. /bin/bash.

Gibt den Pfad zum Befehlsinterpreter an, der zum Ausführen des Skripts verwendet wird. Fügt am Anfang des Skripts eine Shebang-Zeile hinzu. Nur für UNIX-ähnliche Betriebssysteme relevant. Verwenden Sie eine leere Zeichenfolge für Windows-basierte Remotehosts. Erfahren Sie mehr über Shebang (#!).

args - Argumente
string. Optional. Verwenden Sie , wenn runOptions = script.

Gibt die Argumente an, die an das Shellskript übergeben werden sollen. Dieser Parameter ist nur verfügbar, wenn Shell script für die Option Ausführen ausgewählt ist.

failOnStdErr - Fehler bei STDERR
boolean. Standardwert. true.

Wenn der Wert lautet, schlägt trueder Build fehl, wenn die Remotebefehle oder das Skript in STDERRschreiben.

interactiveSession - Interaktive Sitzung aktivieren
boolean. Standardwert. false.

Startet eine interaktive Sitzung. Kennwortanforderungen werden durch das Kennwort des Benutzers ausgefüllt. Interaktive Sitzungen können zum Ausführen von Befehlen nützlich sein, z. B sudo. .

readyTimeout - SSH-Handshake-Timeout
string. Erforderlich. Standardwert. 20000.

Gibt an, wie lange (in Millisekunden) der Task wartet, bis der SSH-Handshake abgeschlossen ist.

interactiveKeyboardAuthentication - Verwenden der interaktiven Tastaturauthentifizierung
boolean. Standardwert. false.

Aktiviert die interaktive Tastaturauthentifizierung. Legen Sie auf fest true , ob Ihr ZIEL-SSH-Server die interaktive Tastaturauthentifizierung erfordert (PasswordAuthentication ist auf dem Zielcomputer deaktiviert/auf Nein in sshd_config festgelegt).

Optionen für die Vorgangskontrolle

Alle Vorgänge verfügen zusätzlich zu ihren Eingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerungsoptionen und allgemeine Aufgabeneigenschaften.

Ausgabevariablen

Keine.

Hinweise

Führt Shellbefehle oder ein Skript auf einem Remotecomputer mithilfe von SSH aus. Mit dieser Aufgabe können Sie über SSH eine Verbindung mit einem Remotecomputer herstellen und Befehle oder ein Skript ausführen.

Voraussetzungen

• Die Aufgabe unterstützt die Verwendung eines SSH-Schlüsselpaars zum Herstellen einer Verbindung mit den Remotecomputern.
• Der öffentliche Schlüssel muss vorinstalliert sein oder auf die Remotecomputer kopiert werden.

Unterstützte Algorithmen

Schlüsselpaaralgorithmen

• RSA
• DSA

Verschlüsselungsalgorithmen

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

Für OpenSSL v1.0.1 und höher (auf Agent):

• aes256-ctr
• aes192-ctr
• aes128-ctr

Für OpenSSL v1.0.1 und höher, NodeJS v0.11.12 und höher (auf Agent):

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

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, Klassischer Build, klassische Version
Wird ausgeführt auf	Agent, DeploymentGroup
Forderungen	Keine
Capabilities	Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag.
Befehlseinschränkungen	Any
Einstellbare Variablen	Any
Agent-Version	2.206.1 oder höher
Aufgabenkategorie	Bereitstellen

Weitere Informationen

• Aufgabe SSH-Schlüssel installieren
• Dateien über SSH kopieren
• Blogbeitrag SSH-Buildtask