SSH@0 – úloha SSH v0

Pomocí této úlohy můžete spouštět 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.

Syntaxe

# 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

připojení ke službě SSH sshEndpoint -
string. Povinné.

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 zadaný privátní klíč a heslo.
• Heslo se dá použít k ověřování na vzdálených počítačích s Linuxem, ale pro systémy macOS nebo Windows se toto heslo nepodporuje.

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

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

příkazů commands -
string. Požadováno při 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 Spustit vybrán příkazy. Každý příkaz zadejte společně s argumenty na novém řádku víceřádkového textového pole. Pokud chcete spustit více příkazů společně, 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 běží v samostatném procesu. Pokud chcete spustit řadu příkazů, které jsou vzájemně závislé (například změna aktuální složky před spuštěním příkazu), použijte místo toho možnost vložený skript.

cesta ke skriptu prostředí scriptPath -
string. Požadováno při 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 vybrán skript prostředí.

inline - vložený skript
string. Požadováno při runOptions = inline.

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

interpreterCommand - interpretu
string. Volitelný. Používá se při runOptions = inline. Výchozí hodnota: /bin/bash.

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

argumentů
string. Volitelný. Používá se při 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 vybrán skript prostředí.

Selhání failOnStdErr - v STDERR
boolean. Výchozí hodnota: true.

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

interactiveSession - Povolit interaktivní relaci
boolean. Výchozí hodnota: false.

Spustí interaktivní relaci. Žádosti o heslo jsou vyplněny heslem uživatele. Interaktivní relace mohou být užitečné pro spouštění příkazů, například sudo.

readyTimeout - vypršení časového limitu handshake SSH
string. Povinné. Výchozí hodnota: 20000.

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

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

Povolí interaktivní ověřování pomocí klávesnice. Nastavte na true, pokud 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 nastavené na ne v sshd_config).

Možnosti ovládání úloh

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

Výstupní proměnné

Žádné.

Poznámky

Pomocí této úlohy můžete spouštět 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írovaný 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 řekl:
• arcfour128 řekl:
• cast128-cbc
• ArcFour

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

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

Pro OpenSSL verze 1.0.1 a vyšší nodeJS v0.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é sestavení, 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ů	Jakýkoliv
nastavitelné proměnné	Jakýkoliv
Verze agenta	2.206.1 nebo novější
Kategorie úkolu	Nasadit

Viz také

• instalace úlohy klíče SSH
• kopírování souborů přes SSH
• Blog příspěvek úlohy sestavení SSH