Начало работы с серийной консолью

Серийная консоль — это способ получить доступ к виртуальной машине вне зависимости от состояния сети или операционной системы. Таким образом, вы можете использовать консоль, например, для устранения неисправностей ВМ или при возникновении проблем с доступом через SSH.

Для работы с серийной консолью необходима роль сompute.admin или editor.

По умолчанию доступ к серийной консоли отключен.

Перед началом работыПеред началом работы

Перед тем, как включить доступ к серийной консоли на ВМ:

1. Подготовьте пару ключей (открытый и закрытый) для SSH-доступа на ВМ. Серийная консоль аутентифицирует пользователей с помощью SSH-ключей.

2. Создайте текстовый файл (например, sshkeys.txt) и укажите следующие данные:

   <имя_пользователя>:<открытый_SSH-ключ_пользователя>
   

   Пример текстового файла для пользователя yc-user:

   yc-user:ssh-ed25519 AAAAB3Nza......OjbSMRX yc-user@example.com
   

   По умолчанию пользовательские SSH-ключи хранятся в каталоге ~/.ssh этого пользователя. Получить открытый ключ можно с помощью команды cat ~/.ssh/<имя_открытого_ключа>.pub.

Включение консоли при создании ВМ из публичного образаВключение консоли при создании ВМ из публичного образа

Чтобы включить доступ к серийной консоли при создании ВМ, установите в метаданных параметр serial-port-enable в значение 1.

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.

Включение консоли при изменении ВМВключение консоли при изменении ВМ

Чтобы включить доступ к серийной консоли при изменении ВМ, установите в метаданных параметр serial-port-enable в значение 1.

1. Получите список ВМ в каталоге по умолчанию:

   yc compute instance list
   

   Результат:

   +----------------------+-----------------+---------------+---------+----------------------+
   |          ID          |       NAME      |    ZONE ID    | STATUS  |     DESCRIPTION      |
   +----------------------+-----------------+---------------+---------+----------------------+
   | fhm0b28lgfp4******** | first-instance  | ru-central1-a | RUNNING | my first vm via CLI  |
   | fhm9gk85nj7g******** | second-instance | ru-central1-a | RUNNING | my second vm via CLI |
   +----------------------+-----------------+---------------+---------+----------------------+
   

2. Выберите идентификатор (ID) или имя (NAME) нужной ВМ, например first-instance.

3. Установите в метаданных ВМ параметр serial-port-enable=1:

   yc compute instance add-metadata \
     --name first-instance \
     --metadata-from-file ssh-keys=sshkeys.txt \
     --metadata serial-port-enable=1
   

   Команда запустит операцию активации серийной консоли на ВМ с именем first-instance.

Настройка ВМ для доступа через серийный портНастройка ВМ для доступа через серийный порт

Для настройки доступа через серийную консоль у ВМ должен быть публичный IP-адрес. Вы можете посмотреть адрес в консоли управления в разделе Compute Cloud на странице Виртуальные машины. Если вы создали ВМ без публичного IP-адреса, вы можете привязать его. После настройки адрес можно отвязать, для подключения через серийную консоль он не нужен.

Чтобы серийная консоль была доступна со стороны ОС, ОС должна быть настроена соответствующим образом.

LinuxLinux

Чтобы подключаться к серийной консоли Linux, убедитесь, что отключена парольная аутентификация для SSH, и при необходимости задайте пароль для нужного пользователя ОС.

Отключите SSH-аутентификацию по паролюОтключите SSH-аутентификацию по паролю

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

Чтобы отключить парольную аутентификацию по SSH:

1. Откройте файл конфигурации SSH-сервера, по умолчанию /etc/ssh/sshd_config. Файл доступен для чтения и редактирования только суперпользователю.

2. Задайте для опции PasswordAuthentication значение no.

3. Перезапустите SSH-сервер:

   sudo systemctl restart ssh*
   

Создайте пароль для пользователя LinuxСоздайте пароль для пользователя Linux

Некоторые ОС могут запрашивать данные пользователя для доступа на ВМ. Поэтому перед подключением к таким ВМ необходимо создать локальный пароль для пользователя по умолчанию.

Чтобы создать локальный пароль, используйте CLI.

1. Получите список ВМ в каталоге по умолчанию:

   yc compute instance list
   

   Результат:

   +----------------------+-----------------+---------------+---------+----------------------+
   |          ID          |       NAME      |    ZONE ID    | STATUS  |     DESCRIPTION      |
   +----------------------+-----------------+---------------+---------+----------------------+
   | fhm0b28lgfp4******** | first-instance  | ru-central1-a | RUNNING | my first vm via CLI  |
   | fhm9gk85nj7g******** | second-instance | ru-central1-a | RUNNING | my second vm via CLI |
   +----------------------+-----------------+---------------+---------+----------------------+
   

2. Выберите идентификатор (ID) или имя (NAME) нужной ВМ, например first-instance.

3. Получите публичный IP-адрес ВМ.

   yc compute instance get first-instance
   

   В выводе команды найдите адрес ВМ в блоке one_to_one_nat:

   ...
   one_to_one_nat:
     address: <публичный_IP-адрес>
     ip_version: IPV4
   ...
   

4. Подключитесь к ВМ. Подробнее читайте в разделе Подключение к ВМ.

5. Создайте локальный пароль. В OC Linux задать пароль можно с помощью команды passwd:

   sudo passwd <имя_пользователя>
   

   Пример для пользователя yc-user:

   sudo passwd yc-user
   

6. Завершите SSH-сессию с помощью команды exit.

Включите нужный способ авторизацииВключите нужный способ авторизации

yc compute instance update \
  --name <имя_ВМ> \
  --serial-port-settings ssh-authorization=INSTANCE_METADATA

done (6s)
id: fhm0b28lgfp4********
folder_id: b1g9d2k0itu4********
created_at: "2024-03-28T19:53:23Z"
name: first-instance
zone_id: ru-central1-a
platform_id: standard-v3
resources:
  memory: "1073741824"
  cores: "2"
  core_fraction: "20"
status: RUNNING
metadata_options:
  gce_http_endpoint: ENABLED
  aws_v1_http_endpoint: ENABLED
  gce_http_token: ENABLED
  aws_v1_http_token: DISABLED
boot_disk:
  mode: READ_WRITE
  device_name: epdu3ce920e7********
  auto_delete: true
  disk_id: epdu3ce920e7********
network_interfaces:
  - index: "0"
    mac_address: d0:0d:5c:**:**:**
    subnet_id: e2luhnr3rhf8********
    primary_v4_address:
      address: 192.168.1.21
      one_to_one_nat:
        address: 51.250.***.***
        ip_version: IPV4
    security_group_ids:
      - enpjauvetqfb********
serial_port_settings:
  ssh_authorization: INSTANCE_METADATA
gpu_settings: {}
fqdn: sample-vm.ru-central1.internal
scheduling_policy:
  preemptible: true
network_settings:
  type: STANDARD
placement_policy: {}
hardware_generation:
  legacy_features:
    pci_topology: PCI_TOPOLOGY_V1

yc compute instance update \
  --name <имя_ВМ> \
  --serial-port-settings ssh-authorization=OS_LOGIN

done (6s)
id: fhm0b28lgfp4********
folder_id: b1g9d2k0itu4********
created_at: "2024-03-28T19:53:23Z"
name: first-instance
zone_id: ru-central1-a
platform_id: standard-v3
resources:
  memory: "1073741824"
  cores: "2"
  core_fraction: "20"
status: RUNNING
metadata_options:
  gce_http_endpoint: ENABLED
  aws_v1_http_endpoint: ENABLED
  gce_http_token: ENABLED
  aws_v1_http_token: DISABLED
boot_disk:
  mode: READ_WRITE
  device_name: epdu3ce920e7********
  auto_delete: true
  disk_id: epdu3ce920e7********
network_interfaces:
  - index: "0"
    mac_address: d0:0d:5c:**:**:**
    subnet_id: e2luhnr3rhf8********
    primary_v4_address:
      address: 192.168.1.21
      one_to_one_nat:
        address: 51.250.***.***
        ip_version: IPV4
    security_group_ids:
      - enpjauvetqfb********
serial_port_settings:
  ssh_authorization: OS_LOGIN
gpu_settings: {}
fqdn: sample-vm.ru-central1.internal
scheduling_policy:
  preemptible: true
network_settings:
  type: STANDARD
placement_policy: {}
hardware_generation:
  legacy_features:
    pci_topology: PCI_TOPOLOGY_V1