[Документация Yandex Cloud](../../../index.md) > [Yandex Compute Cloud](../../index.md) > [Пошаговые инструкции](../index.md) > Виртуальные машины > Создание > Создать ВМ Linux # Создать виртуальную машину из публичного образа Linux {% note info %} Чтобы создавать, изменять и редактировать [ВМ](../../concepts/vm.md), необходима _минимальная_ [роль](../../security/index.md#compute-editor) `compute.editor` на [каталоге](../../../resource-manager/concepts/resources-hierarchy.md#folder). Для создания ВМ с лицензируемым образом дополнительно потребуется [роль](../../../marketplace/security/index.md#license-manager-viewer) `license-manager.viewer`. Для создания ВМ с [публичным IP-адресом](../../../vpc/concepts/address.md#public-addresses) дополнительно потребуется [роль](../../../vpc/security/index.md#vpc-public-admin) `vpc.publicAdmin`. {% endnote %} {% list tabs group=instructions %} - Консоль управления {#console} @[youtube](PN3b26KXb78) [Смотреть видео в Yandex Cloud Video](https://runtime.strm.yandex.ru/player/video/vplv2quzqpa76crq4el5?autoplay=0&mute=0). 1. В [консоли управления](https://kz.console.yandex.cloud) выберите [каталог](../../../resource-manager/concepts/resources-hierarchy.md#folder), в котором будет создана ВМ. 1. [Перейдите](https://kz.console.yandex.cloud/link/compute) в сервис **Compute Cloud**. 1. На панели слева выберите ![image](../../../_assets/console-icons/server.svg) **Виртуальные машины**. 1. Нажмите кнопку **Создать виртуальную машину**. 1. В блоке **Образ загрузочного диска** выберите один из [образов](../../concepts/image.md) и версию операционной системы на базе Linux. Если вы хотите создать ВМ из существующего загрузочного диска, перейдите на вкладку **Пользовательский** и выберите нужный загрузочный диск. Нажмите ![image](../../../_assets/console-icons/pencil.svg) напротив имени диска, если вы хотите изменить его настройки. 1. В блоке **Расположение** выберите [зону доступности](../../../overview/concepts/geo-scope.md), в которой будет находиться ВМ. 1. (Опционально) В блоке **Диски и файловые хранилища** настройте загрузочный [диск](../../concepts/disk.md): * Выберите [тип диска](../../concepts/disk.md#disks_types). * Задайте нужный размер диска. * (Опционально) Чтобы [зашифровать](../../concepts/encryption.md) загрузочный или дополнительный диск, в блоке **Диски и файловые хранилища** справа от имени диска нажмите значок ![image](../../../_assets/console-icons/pencil.svg) и задайте параметры шифрования для диска: * Выберите опцию **Зашифрованный диск**. * В поле **Ключ KMS** выберите [ключ](../../../kms/concepts/key.md), которым вы хотите зашифровать диск. Чтобы [создать](../../../kms/operations/key.md#create) новый ключ, нажмите кнопку **Создать**. Для создания зашифрованного диска нужна [роль](../../../kms/security/index.md#kms-keys-user) `kms.keys.user` или выше. {% note warning %} Задать настройки шифрования можно только при создании диска. Шифрование диска нельзя будет отключить или изменить. Также нельзя будет включить шифрование для уже созданного диска. {% endnote %} Если деактивировать ключ, которым были зашифрованы диск, снимок или образ, доступ к данным будет приостановлен, пока ключ не будет снова активирован. {% note alert %} Если удалить ключ или его [версию](../../../kms/concepts/version.md), которыми были зашифрованы диск, снимок или образ, то доступ к данным будет безвозвратно потерян. Подробнее смотрите [Удаление версии ключа](../../../kms/concepts/version.md#version-distruct). {% endnote %} Если вы создаете ВМ из существующего загрузочного диска, измените настройки этого диска на вкладке **Пользовательский** в блоке **Образ загрузочного диска** вверху формы. 1. (Опционально) Добавьте дополнительный [диск](../../concepts/disk.md): * В блоке **Диски и файловые хранилища** нажмите кнопку **Добавить**. * В открывшемся окне выберите **Диск**. Вы можете выбрать существующий диск или создать новый диск — пустой или из снимка / образа. Например, чтобы создать новый пустой диск: * Выберите `Создать новый`. * В поле **Наполнение** выберите `Пустой`. * Укажите имя диска. * Выберите [тип диска](../../concepts/disk.md#disks_types). * Задайте нужные размер диска и размер блока. * (Опционально) В поле **Дополнительно** включите опцию **Удалять вместе с виртуальной машиной**, если вы хотите автоматически удалять этот диск при удалении ВМ. * Нажмите кнопку **Добавить диск**. 1. (Опционально) Подключите [файловое хранилище](../../concepts/filesystem.md): * В блоке **Диски и файловые хранилища** нажмите кнопку **Добавить**. * В открывшемся окне выберите **Файловое хранилище** и в появившемся списке выберите хранилище, которое требуется подключить. * Нажмите кнопку **Добавить файловое хранилище**. 1. В блоке **Вычислительные ресурсы** выберите одну из готовых конфигураций или создайте свою. Чтобы создать свою конфигурацию: * Перейдите на вкладку **Своя конфигурация**. * Выберите [платформу](../../concepts/vm-platforms.md). * Укажите [гарантированную долю](../../concepts/performance-levels.md) и необходимое количество vCPU, а также объем RAM. * При необходимости включите [программно ускоренную сеть](../../concepts/software-accelerated-network.md). * При необходимости сделайте ВМ [прерываемой](../../concepts/preemptible-vm.md). 1. В блоке **Сетевые настройки**: * В поле **Подсеть** укажите идентификатор подсети в зоне доступности создаваемой ВМ или выберите [облачную сеть](../../../vpc/concepts/network.md#network) из списка. * У каждой сети должна быть как минимум одна [подсеть](../../../vpc/concepts/network.md#subnet). Если подсети нет, создайте ее, выбрав **Создать подсеть**. * Если сети нет, нажмите **Создать сеть** и создайте ее: * В открывшемся окне укажите имя сети и выберите каталог, в котором она будет создана. * (Опционально) Выберите опцию **Создать подсети**, чтобы автоматически создать подсети во всех зонах доступности. * Нажмите **Создать сеть**. * В поле **Публичный IP-адрес** выберите способ назначения адреса: * `Автоматически` — чтобы назначить случайный IP-адрес из пула адресов Yandex Cloud. В этом случае можно включить [защиту от DDoS-атак](../../../vpc/ddos-protection/index.md) при помощи опции ниже. * `Список` — чтобы выбрать публичный IP-адрес из списка зарезервированных заранее статических адресов. Подробнее читайте в разделе [Сделать динамический публичный IP-адрес статическим](../../../vpc/operations/set-static-ip.md). * `Без адреса` — чтобы не назначать публичный IP-адрес. {% note info %} Учитывайте следующие особенности ВМ без публичного IP-адреса: * К такой ВМ нельзя будет подключиться из интернета, например по SSH. * Подключиться к ВМ можно будет с другой ВМ в той же [облачной сети](../../../vpc/concepts/network.md#network) по приватному IP-адресу. * Чтобы предоставить такой ВМ исходящий доступ в интернет, используйте [NAT-шлюз](../../../vpc/concepts/gateways.md#nat-gateway) или [NAT-инстанс](../../../tutorials/routing/nat-instance/index.md). {% endnote %} За использование публичного IP-адреса взимается плата согласно [правилам тарификации Yandex Virtual Private Cloud](../../../vpc/pricing.md). * Выберите [подходящие группы безопасности](../../../vpc/concepts/security-groups.md): * Чтобы подключаться к виртуальной машине по `SSH`, группа безопасности должна разрешать входящий сетевой трафик по протоколам `TCP` и `UDP` на порт `22`. * Чтобы подключаться к виртуальной машине по `RDP`, группа безопасности должна разрешать входящий сетевой трафик по протоколам `TCP` и `UDP` на порт `3389`. Если оставить поле пустым, виртуальной машине будет автоматически назначена [группа безопасности по умолчанию](../../../vpc/concepts/security-groups.md#default-security-group), позволяющая подключаться к ВМ по `SSH` и `RDP`. * Разверните блок **Дополнительно** и в поле **Внутренний IPv4 адрес** выберите способ назначения внутренних адресов: * `Автоматически` — чтобы назначить случайный IP-адрес из пула адресов, доступных в выбранной подсети. * `Вручную` — чтобы задать внутренний IP-адрес ВМ вручную. * При необходимости включите опцию **Защита от DDoS-атак**. Опция доступна, если ранее в настройках публичного адреса вы выбрали автоматический способ назначения адреса. * (Опционально) Создайте записи для ВМ в [зоне DNS](../../../dns/concepts/dns-zone.md): * Разверните блок **Настройки DNS для внутренних адресов** и нажмите **Добавить запись**. * Укажите зону, FQDN и время жизни записи. При указании FQDN для зоны доступна опция `Определять автоматически`. Вы можете добавить несколько записей во [внутренние зоны](../../../dns/concepts/dns-zone.md) DNS. Подробнее в разделе [Интеграция Cloud DNS с Compute Cloud](../../../dns/concepts/compute-integration.md). * Чтобы создать еще одну запись, нажмите кнопку **Добавить запись**. Если вы хотите добавить на ВМ дополнительный [сетевой интерфейс](../../concepts/network.md), нажмите кнопку **Добавить сетевой интерфейс** и в появившемся блоке настроек нового интерфейса повторите действия, описанные выше в этом шаге. На одну ВМ можно добавить до восьми сетевых интерфейсов. 1. В блоке **Доступ**: * Выберите **Доступ по OS Login**, чтобы [подключаться](../vm-connect/os-login.md) к создаваемой ВМ и управлять доступом к ней с помощью [OS Login](../../../organization/concepts/os-login.md) в Yandex Identity Hub. Используя OS Login, вы сможете подключаться к ВМ по SSH-ключам и SSH-сертификатам с помощью стандартного SSH-клиента или [интерфейса командной строки Yandex Cloud](../../../cli/quickstart.md). OS Login позволяет ротировать SSH-ключи, используемые для доступа к ВМ, и является наиболее [безопасным](../../../security/domains/iaas-checklist.md#vm-security) вариантом доступа. * Если доступ по OS Login вам не подходит, выберите вариант **SSH-ключ** и укажите данные для доступа к ВМ: * В поле **Логин** введите имя пользователя. {% note alert %} Не используйте логин `root` или другие [имена, зарезервированные ОС](https://github.com/canonical/subiquity/blob/main/reserved-usernames). Для выполнения операций, требующих прав суперпользователя, используйте команду `sudo`. {% endnote %} * В поле **SSH-ключ** выберите SSH-ключ, сохраненный в вашем профиле [пользователя организации](../../../organization/concepts/membership.md). Если в вашем профиле нет сохраненных SSH-ключей или вы хотите добавить новый ключ: 1. Нажмите кнопку **Добавить ключ**. 1. Задайте имя SSH-ключа. 1. Выберите вариант: * `Ввести вручную` — вставьте содержимое открытого [SSH](../../../glossary/ssh-keygen.md)-ключа. Пару SSH-ключей необходимо [создать](../vm-connect/ssh.md#creating-ssh-keys) самостоятельно. * `Загрузить из файла` — загрузите открытую часть SSH-ключа. Пару SSH-ключей необходимо создать самостоятельно. * `Сгенерировать ключ` — автоматическое создание пары SSH-ключей. При добавлении сгенерированного SSH-ключа будет создан и загружен архив с парой ключей. В ОС на базе Linux или macOS распакуйте архив в папку `/home/<имя_пользователя>/.ssh`. В ОС Windows распакуйте архив в папку `C:\Users\<имя_пользователя>/.ssh`. Дополнительно вводить открытый ключ в консоли управления не требуется. 1. Нажмите кнопку **Добавить**. SSH-ключ будет добавлен в ваш профиль пользователя организации. Если в организации [отключена](../../../organization/operations/os-login-access.md) возможность добавления пользователями SSH-ключей в свои профили, добавленный открытый SSH-ключ будет сохранен только в профиле пользователя внутри создаваемого ресурса. Если вы хотите добавить на ВМ одновременно нескольких пользователей с SSH-ключами, [задайте](../../concepts/metadata/sending-metadata.md) данные этих пользователей в блоке **Метаданные**. С помощью метаданных вы также можете [установить дополнительное ПО](create-with-cloud-init-scripts.md) на ВМ при ее создании. В публичных образах Linux, предоставляемых Yandex Cloud, возможность подключения по протоколу SSH с использованием логина и пароля по умолчанию отключена. 1. (Опционально) Активируйте резервное копирование: 1. Включите опцию **Резервное копирование**. 1. Выберите вариант **Cloud Backup**. 1. В секции **Cloud Backup** нажмите кнопку **Выберите политику** ![chevron-down](../../../_assets/console-icons/chevron-down.svg) и в открывшемся списке выберите [политику резервного копирования](../../../backup/concepts/policy.md), которая будет использоваться Cloud Backup для работы с ВМ. При необходимости нажмите ![circle-plus](../../../_assets/console-icons/circle-plus.svg) **Создать политику**, чтобы создать новую политику. Чтобы создать новую ВМ с подключением к Cloud Backup, вашему аккаунту должна быть назначена [роль](../../../backup/security/index.md#backup-user) `backup.user` или выше на [каталог](../../../resource-manager/concepts/resources-hierarchy.md#folder), в котором вы создаете ВМ. {% note info %} Если у вашего аккаунта нет назначенной роли `backup.user` или выше, вы можете подключить ВМ к Cloud Backup с помощью [сервисного аккаунта](../../../iam/concepts/users/service-accounts.md), которому назначена такая роль. Для этого разверните блок **Дополнительно** и в поле **Сервисный аккаунт** выберите подходящий сервисный аккаунт. При необходимости [создайте](../../../iam/operations/sa/create.md) новый сервисный аккаунт и [назначьте](../../../iam/operations/sa/assign-role-for-sa.md) ему [роль](../../../backup/security/index.md#backup-user) `backup.user`. {% endnote %} Подробнее читайте в разделе [Подключение виртуальных машин Yandex Compute Cloud к Cloud Backup](../../../backup/concepts/vm-connection/compute.md). 1. В блоке **Общая информация** задайте имя ВМ: * длина — от 3 до 63 символов; * может содержать строчные буквы латинского алфавита, цифры и дефисы; * первый символ — буква, последний — не дефис. {% note info %} Имя виртуальной машины используется для генерации [внутреннего FQDN](../../concepts/network.md#hostname) единожды — при создании ВМ. Если для вас важен внутренний FQDN, учитывайте это и задавайте нужное имя ВМ при создании. {% endnote %} 1. В блоке **Дополнительно**: * (Опционально) Выберите или создайте [сервисный аккаунт](../../../iam/concepts/users/service-accounts.md). Использование сервисного аккаунта позволяет гибко настраивать права доступа к ресурсам. * (Опционально) Разрешите доступ к [серийной консоли](../../concepts/serial-console.md). * (Опционально) Чтобы настроить поставку [системных метрик Linux](../../../monitoring/operations/unified-agent/linux_metrics.md) и дополнительных метрик ваших приложений, в блоке **Мониторинг** включите опцию **Агент сбора метрик** и выберите: * **Yandex Monitoring** — [установить агент](../../../monitoring/concepts/data-collection/unified-agent/index.md) для сбора дополнительных метрик ВМ и приложений. * **Yandex Managed Service for Prometheus®** — [установить и настроить агент](../../../monitoring/operations/prometheus/ingestion/prometheus-agent.md) для сбора дополнительных метрик ВМ и приложений в формате Prometheus: * Выберите или создайте воркспейс, в котором будут храниться метрики. * (Опционально) Опишите в формате JSON [параметры поставки](../../../monitoring/operations/prometheus/ingestion/prometheus-agent.md) собственных метрик. * (Опционально) В блоке **Размещение** выберите [группу размещения](../../concepts/placement-groups.md) ВМ. 1. Нажмите кнопку **Создать ВМ**. ВМ появится в списке. При создании ВМ назначаются [IP-адрес](../../../vpc/concepts/address.md) и [имя хоста](../../../vpc/concepts/address.md#fqdn) (FQDN). _© 2025 Linux Foundation. Все права защищены. Linux Foundation зарегистрировала товарные знаки и использует товарные знаки. Список товарных знаков Linux Foundation приведен на странице [Trademark Usage](https://www.linuxfoundation.org/legal/trademark-usage)._ - CLI {#cli} Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), [установите и инициализируйте его](../../../cli/quickstart.md#install). По умолчанию используется каталог, указанный при [создании](../../../cli/operations/profile/profile-create.md) профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду `yc config set folder-id <идентификатор_каталога>`. Также для любой команды вы можете указать другой каталог с помощью параметров `--folder-name` или `--folder-id`. Если вы обращаетесь к ресурсу по имени, поиск будет выполнен в каталоге по умолчанию. Если вы обращаетесь к ресурсу по идентификатору, поиск будет выполнен глобально — во всех каталогах с учетом прав доступа. 1. Посмотрите описание команды [CLI](../../../cli/index.md) для создания ВМ: ```bash yc compute instance create --help ``` 1. [Подготовьте](../vm-connect/ssh.md#creating-ssh-keys) пару ключей (открытый и закрытый) для [SSH-доступа](../../../glossary/ssh-keygen.md) на ВМ. 1. Выберите один из публичных [образов](../images-with-pre-installed-software/get-list.md) [Yandex Cloud Marketplace](../../../marketplace/index.md) на базе операционной системы Linux (например, [CentOS 7](https://yandex.cloud/ru-kz/marketplace/products/yc/centos-7)). Чтобы получить список доступных образов с помощью CLI, выполните команду: ```bash yc compute image list --folder-id standard-images ``` Результат: ```text +----------------------+-------------------------------------+--------------------------+----------------------+--------+ | ID | NAME | FAMILY | PRODUCT IDS | STATUS | +----------------------+-------------------------------------+--------------------------+----------------------+--------+ ... | fdvk34al8k5n******** | centos-7-1549279494 | centos-7 | dqni65lfhvv2******** | READY | | fdv7ooobjfl3******** | windows-2016-gvlk-1548913814 | windows-2016-gvlk | dqnnc72gj2is******** | READY | | fdv4f5kv5cvf******** | ubuntu-1604-lts-1549457823 | ubuntu-1604-lts | dqnnb6dc7640******** | READY | ... +----------------------+-------------------------------------+--------------------------+----------------------+--------+ ``` Где: * `ID` — идентификатор образа. * `NAME` — имя образа. * `FAMILY` — идентификатор [семейства образов](../../concepts/image.md#family), к которому относится образ. * `PRODUCT IDS` — идентификаторы [продуктов](../../../marketplace/concepts/product.md) Yandex Cloud Marketplace, связанных с образом. * `STATUS` — текущий статус образа. Может принимать одно из значений: * `STATUS_UNSPECIFIED` — статус образа не определен. * `CREATING` — образ в процессе создания. * `READY` — образ готов к использованию. * `ERROR` — образ нельзя использовать из-за возникшей с ним проблемы. * `DELETING` — образ в процессе удаления. 1. Выберите [подсеть](../../../vpc/concepts/network.md#subnet): ```bash yc vpc subnet list ``` Результат: ```text +----------------------+---------------------------+----------------------+----------------+-------------------+-----------------+ | ID | NAME | NETWORK ID | ROUTE TABLE ID | ZONE | RANGE | +----------------------+---------------------------+----------------------+----------------+-------------------+-----------------+ | e9bnlm18l70a******** | default-kz1-a | enpe3m3fa00u******** | | kz1-a | [10.128.0.0/24] | +----------------------+---------------------------+----------------------+----------------+-------------------+-----------------+ ``` 1. Создайте ВМ в [каталоге](../../../resource-manager/concepts/resources-hierarchy.md#folder) по умолчанию: ```bash yc compute instance create \ --name first-instance \ --hostname first-instance \ --zone kz1-a \ --network-interface subnet-name=default-kz1-a,nat-ip-version=ipv4 \ --create-boot-disk image-folder-id=standard-images,image-family=centos-7,kms-key-id=<идентификатор_ключа>,auto-delete=true \ --ssh-key ~/.ssh/id_ed25519.pub ``` Где: * `--name` — имя ВМ. Требования к имени: * длина — от 3 до 63 символов; * может содержать строчные буквы латинского алфавита, цифры и дефисы; * первый символ — буква, последний — не дефис. {% note info %} Имя виртуальной машины используется для генерации [внутреннего FQDN](../../concepts/network.md#hostname) единожды — при создании ВМ. Если для вас важен внутренний FQDN, учитывайте это и задавайте нужное имя ВМ при создании. {% endnote %} * `--hostname` — имя хоста ВМ. Задает [внутренний FQDN](../../concepts/network.md#hostname), по которому ВМ будет доступна в облачной сети. Необязательный параметр. Если не указать, FQDN формируется из имени ВМ по правилам, описанным в разделе [Имя хоста и внутренний FQDN](../../concepts/network.md#hostname). Поменять имя хоста и внутренний FQDN после создания ВМ нельзя. * `--zone` — [зона доступности](../../../overview/concepts/geo-scope.md), которая соответствует выбранной подсети. * `--network-interface` — настройки [сетевого интерфейса](../../concepts/network.md) ВМ: * `subnet-name` — имя выбранной подсети. * `nat-ip-version=ipv4` – [публичный IP-адрес](../../../vpc/concepts/address.md#public-addresses). Чтобы создать ВМ без публичного IP-адреса, исключите параметр. Если вы хотите добавить на ВМ несколько [сетевых интерфейсов](../../concepts/network.md), задайте параметр `--network-interface` необходимое количество раз. На одну ВМ можно добавить до восьми сетевых интерфейсов. * `--create-boot-disk` — настройки загрузочного диска ВМ: * `auto-delete` — настройка автоудаления загрузочного диска вместе с ВМ. Смотрите [Автоудаление дисков](../../concepts/disk.md#autodelete-disks). * `image-family` — [семейство образов](../../concepts/image.md#family), например, `centos-7`. Эта опция позволит установить последнюю версию ОС из указанного семейства. * `kms-key-id` — идентификатор [симметричного ключа KMS](../../../kms/concepts/key.md) для создания зашифрованного загрузочного диска. Необязательный параметр. Для создания зашифрованного диска нужна [роль](../../../kms/security/index.md#kms-keys-user) `kms.keys.user` или выше. {% note warning %} Задать настройки шифрования можно только при создании диска. Шифрование диска нельзя будет отключить или изменить. Также нельзя будет включить шифрование для уже созданного диска. {% endnote %} Если деактивировать ключ, которым были зашифрованы диск, снимок или образ, доступ к данным будет приостановлен, пока ключ не будет снова активирован. {% note alert %} Если удалить ключ или его [версию](../../../kms/concepts/version.md), которыми были зашифрованы диск, снимок или образ, то доступ к данным будет безвозвратно потерян. Подробнее смотрите [Удаление версии ключа](../../../kms/concepts/version.md#version-distruct). {% endnote %} * `--ssh-key` — путь к файлу с [публичным SSH-ключом](../vm-connect/ssh.md#creating-ssh-keys). Для этого ключа на ВМ будет автоматически создан пользователь `yc-user`. При создании ВМ из публичного образа [Yandex Cloud Marketplace](https://yandex.cloud/ru-kz/marketplace) обязательно передавайте в ВМ SSH-ключ, поскольку доступ по протоколу SSH с использованием логина и пароля для таких образов по умолчанию отключен. Если вы хотите добавить на ВМ одновременно нескольких пользователей с SSH-ключами, [задайте](../../concepts/vm-metadata.md#how-to-send-metadata) данные этих пользователей с помощью параметра `--metadata-from-file`. С помощью метаданных вы также можете [установить дополнительное ПО](create-with-cloud-init-scripts.md) на ВМ при ее создании. При создании виртуальной машине назначаются [IP-адрес](../../../vpc/concepts/address.md#public-addresses) и [доменное имя](../../../vpc/concepts/address.md#fqdn) (FQDN). - Terraform {#tf} Если у вас еще нет Terraform, [установите его и настройте провайдер Yandex Cloud](../../../tutorials/infrastructure-management/terraform-quickstart.md#install-terraform). Чтобы управлять инфраструктурой с помощью Terraform от имени сервисного аккаунта или пользовательских аккаунтов: аккаунта на Яндексе, федеративного аккаунта и локального пользователя, [аутентифицируйтесь](../../../terraform/authentication.md) соответствующим способом. 1. Опишите в конфигурационном файле параметры ресурсов, которые необходимо создать: ```hcl resource "yandex_compute_disk" "boot-disk" { name = "<имя_диска>" type = "<тип_диска>" zone = "<зона_доступности>" size = "<размер_диска>" image_id = "<идентификатор_образа>" } resource "yandex_compute_instance" "vm-1" { name = "linux-vm" allow_stopping_for_update = true platform_id = "standard-v3" zone = "<зона_доступности>" resources { cores = "<количество_ядер_vCPU>" memory = "<объем_RAM_ГБ>" } boot_disk { auto_delete = true disk_id = yandex_compute_disk.boot-disk.id } network_interface { subnet_id = "${yandex_vpc_subnet.subnet-1.id}" nat = true } metadata = { ssh-keys = "<имя_пользователя>:<содержимое_SSH-ключа>" } } resource "yandex_vpc_network" "network-1" { name = "network1" } resource "yandex_vpc_subnet" "subnet-1" { name = "subnet1" zone = "<зона_доступности>" v4_cidr_blocks = ["192.168.10.0/24"] network_id = "${yandex_vpc_network.network-1.id}" } ``` Где: * `yandex_compute_disk` — описание загрузочного [диска](../../concepts/disk.md): * `name` — имя диска. * `type` — тип создаваемого диска. * `zone` — [зона доступности](../../../overview/concepts/geo-scope.md), в которой будет находиться диск. * `size` — размер диска в ГБ. * `image_id` — идентификатор образа для ВМ. Вы можете получить идентификатор образа из [списка публичных образов](../images-with-pre-installed-software/get-list.md). Идентификаторы образа также можно посмотреть в [консоли управления](https://kz.console.yandex.cloud) при создании ВМ или в [Cloud Marketplace](https://yandex.cloud/ru-kz/marketplace) на странице образа в блоке **Идентификаторы продукта**. * `yandex_compute_instance` — описание ВМ: * `name` — имя ВМ. * `allow_stopping_for_update` — разрешение на остановку работы виртуальной машины для внесения изменений. Установите значение `true`, если планируете изменять сетевые настройки или вычислительные ресурсы ВМ с помощью Terraform. Значение по умолчанию `false`. * `platform_id` — [платформа](../../concepts/vm-platforms.md). * `zone` — зона доступности, в которой будет находиться ВМ. * `resources` — количество ядер vCPU и объем RAM, доступные ВМ. Значения должны соответствовать выбранной [платформе](../../concepts/vm-platforms.md). * `boot_disk` — настройки загрузочного диска. Укажите идентификатор диска. * `auto_delete` — настройка автоудаления загрузочного диска вместе с ВМ. Смотрите [Автоудаление дисков](../../concepts/disk.md#autodelete-disks). * `network_interface` — настройки [сетевого интерфейса](../../concepts/network.md) ВМ. Укажите идентификатор выбранной [подсети](../../../vpc/concepts/network.md#subnet). Чтобы автоматически назначить ВМ [публичный IP-адрес](../../../vpc/concepts/address.md#public-addresses), укажите `nat = true`. Если вы хотите добавить на ВМ несколько [сетевых интерфейсов](../../concepts/network.md), задайте блок `network_interface` необходимое количество раз. * `metadata` — в метаданных необходимо передать открытый SSH-ключ для доступа на ВМ. Подробнее в разделе [Метаданные виртуальной машины](../../concepts/vm-metadata.md). Если вы хотите добавить на ВМ одновременно нескольких пользователей с SSH-ключами, [задайте](../../concepts/vm-metadata.md#how-to-send-metadata) данные этих пользователей в файле и передайте в блоке `metadata`. С помощью метаданных вы также можете [установить дополнительное ПО](create-with-cloud-init-scripts.md) на ВМ при ее создании. * `yandex_vpc_network` — описание облачной сети. * `yandex_vpc_subnet` — описание подсети, к которой будет подключена ВМ. {% note info %} Если у вас уже есть подходящие ресурсы (облачная сеть и подсеть), описывать их повторно не нужно. Используйте их имена и идентификаторы в соответствующих параметрах. {% endnote %} Более подробную информацию о ресурсах, которые вы можете создать с помощью Terraform, читайте в [документации провайдера](../../../terraform/index.md). 1. Создайте ресурсы: 1. В терминале перейдите в директорию с конфигурационным файлом. 1. Проверьте корректность конфигурации с помощью команды: ```bash terraform validate ``` Если конфигурация является корректной, появится сообщение: ```bash Success! The configuration is valid. ``` 1. Выполните команду: ```bash terraform plan ``` В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет. 1. Примените изменения конфигурации: ```bash terraform apply ``` 1. Подтвердите изменения: введите в терминале слово `yes` и нажмите **Enter**. После этого в указанном каталоге будут созданы все требуемые ресурсы. Проверить появление ресурсов и их настройки можно в [консоли управления](https://kz.console.yandex.cloud). При создании виртуальной машине назначаются [IP-адрес](../../../vpc/concepts/address.md#public-addresses) и [доменное имя](../../../vpc/concepts/address.md#fqdn) (FQDN). - API {#api} Создайте ВМ с помощью метода REST API [create](../../api-ref/Instance/create.md) для ресурса [Instance](../../api-ref/Instance/index.md): 1. [Подготовьте](../vm-connect/ssh.md#creating-ssh-keys) пару ключей (открытый и закрытый) для [SSH-доступа](../../../glossary/ssh-keygen.md) на ВМ. 1. Получите [IAM-токен](../../../iam/concepts/authorization/iam-token.md), используемый для аутентификации в примерах: * [Инструкция](../../../iam/operations/iam-token/create.md) для пользователя с аккаунтом на Яндексе. * [Инструкция](../../../iam/operations/iam-token/create-for-sa.md) для [сервисного аккаунта](../../../iam/concepts/users/service-accounts.md). * [Инструкция](../../../iam/operations/iam-token/create-for-federation.md) для федеративного аккаунта. * [Инструкция](../../../iam/operations/iam-token/create-for-local.md) для локального аккаунта. 1. [Получите идентификатор](../../../resource-manager/operations/folder/get-id.md) [каталога](../../../resource-manager/concepts/resources-hierarchy.md#folder). 1. Получите информацию об [образе](../../concepts/image.md), из которого надо создать ВМ (идентификатор образа и минимальный размер [диска](../../concepts/disk.md)): * Если вы знаете [семейство образа](../../concepts/image.md#family), получите информации о последнем образе в этом семействе: ```bash export IAM_TOKEN=CggaATEVAgA... export FAMILY=ubuntu-1804 curl \ --header "Authorization: Bearer ${IAM_TOKEN}" \ "https://compute.api.yandexcloud.kz/compute/v1/images:latestByFamily?folderId=standard-images&family=${FAMILY}" ``` * Вы можете получить информацию об образе из [списка публичных образов](../images-with-pre-installed-software/get-list.md). 1. Получите идентификатор [подсети](../../../vpc/concepts/network.md#subnet) и идентификатор [зоны доступности](../../../overview/concepts/geo-scope.md). В запросе укажите идентификатор каталога, в котором создана подсеть: ```bash export IAM_TOKEN=CggaATEVAgA... export FOLDER_ID=b1gvmob95yys******** curl \ --header "Authorization: Bearer ${IAM_TOKEN}" \ "https://vpc.api.yandexcloud.kz/vpc/v1/subnets?folderId=${FOLDER_ID}" ``` Результат: ``` { "subnets": [ { "v4CidrBlocks": [ "10.130.0.0/24" ], "id": "b0c6n43ftldh********", "folderId": "b1gvmob95yys********", "createdAt": "2018-09-23T12:15:00Z", "name": "default-kz1-a", "description": "Auto-created default subnet for zone kz1-a", "networkId": "enpe3m3faglu********", "zoneId": "kz1-a" }, ... ] } ``` 1. Создайте файл с телом запроса на создание ВМ, например, `body.json`: ```json { "folderId": "b1gvmob95yys********", "name": "instance-demo-no-pwauth", "zoneId": "kz1-a", "platformId": "standard-v3", "resourcesSpec": { "memory": "2147483648", "cores": "2" }, "metadata": { "user-data": "#cloud-config\nusers:\n - name: user\n groups: sudo\n shell: /bin/bash\n sudo: 'ALL=(ALL) NOPASSWD:ALL'\n ssh_authorized_keys:\n - ssh-ed25519 AAAAB3N... user@example.com" }, "bootDiskSpec": { "autoDelete": true, "diskSpec": { "size": "8589934592", "imageId": "fd8rc75pn12f********" } }, "networkInterfaceSpecs": [ { "subnetId": "b0c6n43ftldh********", "primaryV4AddressSpec": { "oneToOneNatSpec": { "ipVersion": "IPV4" } } } ] } ``` Где: * `folderId` — идентификатор каталога. * `name` — имя, которое будет присвоено ВМ при создании. * `zoneId` — зона доступности, которая соответствует выбранной подсети. * `platformId` — [платформа](../../concepts/vm-platforms.md). * `resourcesSpec` — ресурсы, доступные ВМ. Значения должны соответствовать выбранной платформе. * `metadata` — в метаданных необходимо передать открытый ключ для SSH-доступа на ВМ. Подробнее в разделе [Метаданные виртуальной машины](../../concepts/vm-metadata.md). * `bootDiskSpec` — настройки загрузочного диска. Укажите идентификатор выбранного образа и размер диска. * `autoDelete` — настройка автоудаления загрузочного диска вместе с ВМ. Смотрите [Автоудаление дисков](../../concepts/disk.md#autodelete-disks). Идентификаторы образа также можно посмотреть в [консоли управления](https://kz.console.yandex.cloud) при создании ВМ или в [Cloud Marketplace](https://yandex.cloud/ru-kz/marketplace) на странице образа в блоке **Идентификаторы продукта**. Размер диска должен быть не меньше минимального размера диска, указанного в информации об образе. * `networkInterfaceSpecs` — настройки [сетевого интерфейса](../../concepts/network.md) ВМ: * `subnetId` — идентификатор выбранной подсети. * `primaryV4AddressSpec` — IP-адрес, который будет присвоен ВМ. Чтобы добавить [публичный IP-адрес](../../../vpc/concepts/address.md#public-addresses) ВМ, укажите: ```json "primaryV4AddressSpec": { "oneToOneNatSpec": { "ipVersion": "IPV4" } } ``` Если вы хотите добавить на ВМ несколько [сетевых интерфейсов](../../concepts/network.md), передайте в `networkInterfaceSpecs` массив с необходимым количеством объектов с настройками сетевых интерфейсов. На одну ВМ можно добавить до восьми сетевых интерфейсов. Подробнее про формат тела запроса в [справочнике API](../../api-ref/Instance/create.md). 1. Создайте ВМ: ```bash export IAM_TOKEN=CggaATEVAgA... curl \ --request POST \ --header "Content-Type: application/json" \ --header "Authorization: Bearer ${IAM_TOKEN}" \ --data '@body.json' \ https://compute.api.yandexcloud.kz/compute/v1/instances ``` При создании виртуальной машине назначаются [IP-адрес](../../../vpc/concepts/address.md#public-addresses) и [доменное имя](../../../vpc/concepts/address.md#fqdn) (FQDN). {% endlist %} #### Полезные ссылки {#see-also} * [Подключиться к виртуальной машине Linux по SSH](../vm-connect/ssh.md).