SSH@0 – úloha SSH v0

Článek
07/02/2024

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.

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

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

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íčů

Š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

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.144.0 nebo vyšší
Kategorie úloh	Nasadit

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.102.0 nebo vyšší
Kategorie úloh	Nasadit

Sdílet prostřednictvím

SSH@0 – úloha SSH v0

Syntax

Vstupy

Možnosti ovládání úloh

Výstupní proměnné

Poznámky

Požadavky

Podporované algoritmy

Algoritmy páru klíčů

Šifrovací algoritmy

Požadavky

Viz také

Váš názor

Další materiály