Поделиться через

SSH@0 — задача SSH v0

  • Статья

Используйте эту задачу для выполнения команд оболочки или скрипта на удаленном компьютере с помощью SSH. Эта задача позволяет подключаться к удаленному компьютеру с помощью SSH и выполнять команды или скрипт.

Синтаксис

# 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 sshEndpoint -
string. Обязательное.

Указывает имя подключения службы SSH, содержащего сведения о подключении для удаленного компьютера. Имя узла или IP-адрес удаленного компьютера, номер порта и имя пользователя необходимы для создания подключения службы SSH.

  • Для проверки подлинности необходимо указать закрытый ключ и парольную фразу.
  • Пароль можно использовать для проверки подлинности на удаленных компьютерах Linux, но это не поддерживается для macOS или систем Windows.

runOptions - запуск
string. Обязательное. Допустимые значения: commands, script (файл скрипта), inline (встроенный скрипт). Значение по умолчанию: commands.

Выполняет команды оболочки или скрипт оболочки на удаленном компьютере.


команды commands -
string. Требуется, если runOptions = commands.

Указывает команды оболочки, выполняемые на удаленном компьютере. Этот параметр доступен только в том случае, если команды выбраны для параметра запуска. Введите каждую команду вместе с его аргументами в новой строке многострочного текстового поля. Чтобы выполнить несколько команд вместе, введите их в одной строке, разделенной точкой с запятой. Пример: cd /home/user/myFolder;build.

Примечание.

Каждая команда выполняется в отдельном процессе. Если вы хотите выполнить ряд команд, которые являются взаимозависимыми (например, изменение текущей папки перед выполнением команды), используйте вместо этого параметр встроенный скрипт.


Путь к скрипту scriptPath - оболочки
string. Требуется, если runOptions = script.

Указывает путь к файлу скрипта оболочки для запуска на удаленном компьютере. Этот параметр доступен только в том случае, если скрипт оболочки выбран для параметра запуска.


inline - встроенный скрипт
string. Требуется, если runOptions = inline.

Записывает скрипт оболочки для запуска на удаленном компьютере.


команда интерпретатора interpreterCommand -
string. Необязательно. Используется при runOptions = inline. Значение по умолчанию: /bin/bash.

Указывает путь к интерпретатору команд, используемому для выполнения скрипта. Добавляет строку shebang в начало сценария. Применимо только для операционных систем, таких как UNIX. Используйте пустую строку для удаленных узлов под управлением Windows. Дополнительные сведения о shebang (#!).


args - аргументы
string. Необязательно. Используется при runOptions = script.

Указывает аргументы для передачи в скрипт оболочки. Этот параметр доступен только в том случае, если скрипт оболочки выбран для параметра запуска.


failOnStdErr - Сбой STDERR
boolean. Значение по умолчанию: true.

Если значение true, сборка завершается ошибкой, если удаленные команды или скрипт записываются в STDERR.


interactiveSession - Включить интерактивный сеанс
boolean. Значение по умолчанию: false.

Запускает интерактивный сеанс. Запросы паролей заполняются паролем пользователя. Интерактивные сеансы могут быть полезны для выполнения команд, таких как sudo.


readyTimeout - время ожидания подтверждения SSH
string. Обязательное. Значение по умолчанию: 20000.

Указывает, сколько времени (в миллисекундах) задача ожидает завершения подтверждения SSH.


interactiveKeyboardAuthentication - использование интерактивной проверки подлинности с помощью клавиатуры
boolean. Значение по умолчанию: false.

Включает интерактивную проверку подлинности клавиатуры. Установите значение true, если целевой сервер SSH требует интерактивной проверки подлинности клавиатуры (PasswordAuthentication отключен на целевом компьютере или имеет значение No в sshd_config).


Параметры управления задачами

Помимо входных данных, все задачи имеют параметры управления. Дополнительные сведения см. в разделе Параметры управления и общие свойства задач.

Выходные переменные

Нет.

Замечания

Используйте эту задачу для выполнения команд оболочки или скрипта на удаленном компьютере с помощью SSH. Эта задача позволяет подключаться к удаленному компьютеру с помощью SSH и выполнять команды или скрипт.

Предпосылки

  • Задача поддерживает использование пары ключей SSH для подключения к удаленному компьютеру.
  • Открытый ключ должен быть предварительно установлен или скопирован на удаленный компьютер.

Поддерживаемые алгоритмы

Алгоритмы пар ключей

  • RSA
  • DSA

Алгоритмы шифрования

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

Для OpenSSL версии 1.0.1 и выше (для агента):

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

Для OpenSSL версии 1.0.1 и более поздних версий NodeJS версии 0.11.12 и выше (в агенте):

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

Требования

Требование Описание
Типы конвейеров YAML, классическая сборка, классический выпуск
Выполняется в Агент, DeploymentGroup
требования Нет
возможностей Эта задача не удовлетворяет требованиям к последующим задачам в задании.
ограничения команд Любое
переменные settable Любое
Версия агента 2.206.1 или более поздней версии
Категория задач Внедрять
Требование Описание
Типы конвейеров YAML, классическая сборка, классический выпуск
Выполняется в Агент, DeploymentGroup
требования Нет
возможностей Эта задача не удовлетворяет требованиям к последующим задачам в задании.
ограничения команд Любое
переменные settable Любое
Версия агента 2.144.0 или более поздней версии
Категория задач Внедрять
Требование Описание
Типы конвейеров YAML, классическая сборка, классический выпуск
Выполняется в Агент, DeploymentGroup
требования Нет
возможностей Эта задача не удовлетворяет требованиям к последующим задачам в задании.
ограничения команд Любое
переменные settable Любое
Версия агента 2.102.0 или более поздней версии
Категория задач Внедрять

См. также