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


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

Входные данные

sshEndpoint - Подключение службы SSH
string. Обязательный.

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

  • Для проверки подлинности необходимо указать закрытый ключ и парольную фразу.
  • Пароль можно использовать для проверки подлинности на удаленных компьютерах 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 отключена на целевом компьютере или в sshd_config задано значение Нет).


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

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

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

Нет.

Remarks

Используйте эту задачу для выполнения команд оболочки или скрипта на удаленном компьютере с помощью 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
Требования None
Capabilities Эта задача не удовлетворяет требованиям для последующих задач в задании.
Ограничения команд Любой
Устанавливаемые переменные Любой
Версия агента 2.206.1 или более поздней версии
Категория задач Развернуть
Требование Описание
Типы конвейеров YAML, классическая сборка, классический выпуск
Выполняется в Агент, DeploymentGroup
Требования None
Capabilities Эта задача не удовлетворяет требованиям для последующих задач в задании.
Ограничения команд Любой
Устанавливаемые переменные Любой
Версия агента 2.144.0 или более поздней версии
Категория задач Развернуть
Требование Описание
Типы конвейеров YAML, классическая сборка, классический выпуск
Выполняется в Агент, DeploymentGroup
Требования None
Capabilities Эта задача не удовлетворяет требованиям для последующих задач в задании.
Ограничения команд Любой
Устанавливаемые переменные Любой
Версия агента 2.102.0 или более поздней версии
Категория задач Развернуть

См. также раздел