Заметка
Доступ к этой странице требует авторизации. Вы можете попробовать войти в систему или изменить каталог.
Доступ к этой странице требует авторизации. Вы можете попробовать сменить директорию.
Используйте эту задачу для выполнения команд оболочки или скрипта на удаленном компьютере с помощью 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 для подключения к удаленному компьютеру.
- Открытый ключ должен быть предварительно установлен или скопирован на удаленный компьютер.
Поддерживаемые алгоритмы
Алгоритмы пар ключей
- ЮАР
- Суточные
Алгоритмы шифрования
- AES256-CBC
- AES192-CBC
- AES128-CBC
- Иглобрюх-CBC
- 3DES-CBC
- АРКЧЕТЫРЕ256
- АРКЧЕТЫРЕ128
- В ролях128-CBC
- Арк Фур
Для 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 или более поздней версии |
| Категория задач | Внедрять |