Создать виртуальную машину в группе размещения

Статья создана

Yandex Cloud

Улучшена

Обновлена 15 октября 2025 г.

Примечание

В регионе Казахстан доступна только зона доступности kz1-a.

Создайте ВМ в группе размещения.

Работа с группами размещения со стратегией размещения разделами доступна с помощью CLI и API.

Примечание

Чтобы создавать, изменять и редактировать ВМ, необходима минимальная роль compute.editor на каталоге. Для создания ВМ с лицензируемым образом дополнительно потребуется роль license-manager.viewer.

Для создания ВМ с публичным IP-адресом дополнительно потребуется роль vpc.publicAdmin.

CLI

Terraform

API

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

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

Посмотрите описание команды CLI для создания группы размещения:
```
yc compute placement-group create --help
```
Создайте группу размещения в каталоге по умолчанию с одной из стратегий размещения:
- Распределенное размещение (spread):
```
yc compute placement-group create \
  --spread-strategy \
  --name <имя_группы_размещения>
```
  Где:
  - --spread-strategy — выбор стратегии распределенного размещения.
  - --name — имя группы размещения.
- Размещение разделами (partition):
```
yc compute placement-group create \
  --partitions <количество_разделов> \
  --name <имя_группы_размещения>
```
  Где:
  - --partitions — выбор стратегии размещения разделами с указанием количества разделов: от 1 до 5.
  - --name — имя группы размещения.
Посмотрите описание команды CLI для создания ВМ:
```
yc compute instance create --help
```
Создайте ВМ:
```
yc compute instance create \
  --zone kz1-a \
  --name instance-in-group-1 \
  --placement-group-name my-group \
  --placement-group-partition <номер_раздела>
```
Где:
- --zone — зона доступности, в которой будет размещена ВМ.
- --name — имя ВМ.
- --placement-group-name — имя группы размещения.
- --placement-group-partition — номер раздела в группе размещения со стратегией размещения разделами.
  
  Примечание
  
  Если не указать номер раздела при создании ВМ в группе с размещением разделами, ВМ добавится в случайный раздел.
Результат:
```
id: epdep2kq6dt5********
...
placement_policy:
  placement_group_id: fd83bv4rnsna********
```

Проверьте, что ВМ создана и добавлена в группу размещения:

yc compute placement-group list-instances --name my-group

Где --name — имя группы размещения.

Результат:

+----------------------+---------------------+-------------------+---------+-------------+-------------+
|          ID          |        NAME         |      ZONE ID      | STATUS  | EXTERNAL IP | INTERNAL IP |
+----------------------+---------------------+-------------------+---------+-------------+-------------+
| epdep2kq6dt5******** | instance-in-group-1 | kz1-a | RUNNING |             | 10.129.0.5  |
+----------------------+---------------------+-------------------+---------+-------------+-------------+

Terraform позволяет быстро создать облачную инфраструктуру в Yandex Cloud и управлять ею с помощью файлов конфигураций. В файлах конфигураций хранится описание инфраструктуры на языке HCL (HashiCorp Configuration Language). При изменении файлов конфигураций Terraform автоматически определяет, какая часть вашей конфигурации уже развернута, что следует добавить или удалить.

Terraform распространяется под лицензией Business Source License, а провайдер Yandex Cloud для Terraform — под лицензией MPL-2.0.

Подробную информацию о ресурсах провайдера смотрите в документации на сайте Terraform или в зеркале.

Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.

Чтобы создать ВМ в группе размещения:

Опишите в конфигурационном файле параметры ВМ с указанием на ресурс yandex_compute_placement_group в поле placement_group_id. Параметры ВМ описывает ресурс yandex_compute_instance.

Пример структуры конфигурационного файла:
```
...
resource "yandex_compute_instance" "vm-1" {
  name        = "linux-vm"
  platform_id = "standard-v3"
  placement_policy {
    placement_group_id = "${yandex_compute_placement_group.group1.id}"
  }
}

resource "yandex_compute_placement_group" "group1" {
  name = "test-pg"
}
...
```
Где placement_group_id — идентификатор группы размещения.

Более подробную информацию о параметрах ресурсов yandex_compute_instance и yandex_compute_placement_group в Terraform см. в документации провайдера.
В командной строке перейдите в папку, где расположен файл конфигурации Terraform.
Проверьте конфигурацию командой:
```
terraform validate
```
Если конфигурация является корректной, появится сообщение:
```
Success! The configuration is valid.
```
Выполните команду:
```
terraform plan
```
В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.
Примените изменения конфигурации:
```
terraform apply
```
Подтвердите изменения: введите в терминал слово yes и нажмите Enter.

После этого в указанном каталоге будут созданы все требуемые ресурсы. Проверить, что ВМ создана и добавлена в группу размещения, можно в консоли управления.

Воспользуйтесь методом REST API create для ресурса Instance или вызовом gRPC API InstanceService/Create.

Смотрите также

Как добавить ВМ в группу размещения.

Создать виртуальную машину в группе размещения

Смотрите такжеСмотрите также

Была ли статья полезна?

Смотрите также