SSH@0 – úloha SSH v0

Pomocí této úlohy můžete spustit příkazy prostředí nebo skript na vzdáleném počítači pomocí SSH. Tato úloha umožňuje připojit se ke vzdálenému počítači pomocí SSH a spustit příkazy nebo skript.

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.

Vstupy

sshEndpoint - Připojení služby SSH
string. Povinná hodnota.

Určuje název připojení služby SSH obsahující podrobnosti o připojení pro vzdálený počítač. K vytvoření připojení služby SSH se vyžaduje název hostitele nebo IP adresa vzdáleného počítače, číslo portu a uživatelské jméno.

• Pro ověřování musí být zadán privátní klíč a heslo.
• Heslo se dá použít k ověření na vzdálených počítačích s Linuxem, ale v systémech macOS ani Windows se to nepodporuje.

runOptions - Spustit
string. Povinná hodnota. Povolené hodnoty: commands, script (soubor skriptu), inline (vložený skript). Výchozí hodnota: commands.

Spustí příkazy prostředí nebo skript prostředí na vzdáleném počítači.

commands - Příkazy
string. Vyžaduje se, když runOptions = commands.

Určuje příkazy prostředí, které se mají spustit na vzdáleném počítači. Tento parametr je k dispozici pouze v případě, že je pro možnost Spustitvybrána možnost Příkazy. Zadejte každý příkaz společně s argumenty na nový řádek víceřádkového textového pole. Pokud chcete spustit více příkazů najednou, zadejte je na stejném řádku odděleném středníky. Příklad: cd /home/user/myFolder;build.

Poznámka

Každý příkaz se spouští v samostatném procesu. Pokud chcete spustit řadu příkazů, které jsou vzájemně závislé (například změnit aktuální složku před spuštěním příkazu), použijte místo toho možnost Vložený skript .

scriptPath - Cesta ke skriptu prostředí
string. Vyžaduje se, když runOptions = script.

Určuje cestu k souboru skriptu prostředí, který se má spustit na vzdáleném počítači. Tento parametr je k dispozici pouze v případě, že je pro možnost Spustit vybraný skript prostředí.

inline - Vložený skript
string. Vyžaduje se, když runOptions = inline.

Zapíše skript prostředí, který se má spustit na vzdáleném počítači.

interpreterCommand - Příkaz interpretu
string. Nepovinný parametr. Použijte, když runOptions = inline. Výchozí hodnota: /bin/bash.

Určuje cestu k interpretu příkazů použitému ke spuštění skriptu. Přidá čáru shebang na začátek skriptu. Relevantní pouze pro operační systémy typu UNIX. Pro vzdálené hostitele se systémem Windows použijte prázdný řetězec. Další informace o shebangu (#!)

args - Argumenty
string. Nepovinný parametr. Použijte, když runOptions = script.

Určuje argumenty, které se mají předat skriptu prostředí. Tento parametr je k dispozici pouze v případě, že je pro možnost Spustit vybraný skript prostředí.

failOnStdErr - Selhání při STDERR
boolean. Výchozí hodnota: true.

Pokud je truehodnota , sestavení selže, když vzdálené příkazy nebo skript zapisují do STDERR.

interactiveSession - Povolení interaktivní relace
boolean. Výchozí hodnota: false.

Spustí interaktivní relaci. Žádosti o heslo se vyplňují heslem uživatele. Interaktivní relace můžou být užitečné pro spouštění příkazů, jako sudoje .

readyTimeout - Časový limit metody handshake SSH
string. Povinná hodnota. Výchozí hodnota: 20000.

Určuje, jak dlouho (v milisekundách) úkol čeká na dokončení metody handshake SSH.

interactiveKeyboardAuthentication - Použití interaktivního ověřování pomocí klávesnice
boolean. Výchozí hodnota: false.

Umožňuje ověřování pomocí interaktivní klávesnice. Nastavte na hodnotu true , pokud váš cílový server SSH vyžaduje interaktivní ověřování pomocí klávesnice (PasswordAuthentication je na cílovém počítači zakázané nebo v sshd_config nastaveno na Ne).

Možnosti ovládání úloh

Všechny úlohy mají kromě vstupů také možnosti ovládání. Další informace najdete v tématu Možnosti ovládacího prvku a běžné vlastnosti úlohy.

Výstupní proměnné

Žádné

Poznámky

Pomocí této úlohy můžete spustit příkazy prostředí nebo skript na vzdáleném počítači pomocí SSH. Tato úloha umožňuje připojit se ke vzdálenému počítači pomocí SSH a spustit příkazy nebo skript.

Požadavky

• Úloha podporuje použití páru klíčů SSH pro připojení ke vzdáleným počítačům.
• Veřejný klíč musí být předinstalovaný nebo zkopírováný do vzdálených počítačů.

Podporované algoritmy

Algoritmy páru klíčů

• RSA
• DSA

Šifrovací algoritmy

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

Pro OpenSSL v1.0.1 a novější (v agentu):

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

Pro OpenSSL verze 1.0.1 a vyšší, NodeJS verze 0.11.12 a vyšší (v agentu):

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

Požadavky

Požadavek	Popis
Typy kanálů	YAML, klasický build, klasická verze
Běží na	Agent, DeploymentGroup
Požadavky	Žádné
Možnosti	Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze.
Omezení příkazů	Všechny
Nastavitelné proměnné	Všechny
Verze agenta	2.206.1 nebo vyšší
Kategorie úloh	Nasadit

Viz také

• Úloha instalace klíče SSH
• Kopírování souborů přes SSH
• Blogové příspěvky – úloha sestavení SSH