Перенести виртуальную машину в другую зону доступности

1. Остановите виртуальную машину (см. раздел Остановить).
2. Дождитесь, когда статус машины изменится на STOPPED.

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

По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name или --folder-id.

1. Посмотрите описание команд CLI для создания снимков:

   yc compute snapshot create --help
   

2. Выберите диск, снимок которого необходимо создать. Получить список дисков в каталоге по умолчанию можно с помощью команды:

   yc compute disk list
   

   Результат:

   +----------------------+--------------+-------------+-------------------+--------+----------------------+-----------------+-------------+
   |          ID          |     NAME     |    SIZE     |       ZONE        | STATUS |     INSTANCE IDS     | PLACEMENT GROUP | DESCRIPTION |
   +----------------------+--------------+-------------+-------------------+--------+----------------------+-----------------+-------------+
   | a7lqgbt0bb9s******** | first-disk   | 20401094656 |   ru-central1-a   | READY  | a7lcvu28njbh******** |                 |             |
   | a7lv5j5hm1p1******** | second-disk  | 21474836480 |   ru-central1-a   | READY  |                      |                 |             |
   +----------------------+--------------+-------------+-------------------+--------+----------------------+-----------------+-------------+
   

3. Создайте снимок в каталоге по умолчанию:

   yc compute snapshot create \
     --name first-snapshot \
     --description "my first snapshot via CLI" \
     --disk-id fhm4aq4hvq5g********
   

   В результате будет создан снимок диска с именем first-snapshot и описанием my first snapshot via CLI.

   Требования к имени снимка:

   • длина — от 3 до 63 символов;
   • может содержать строчные буквы латинского алфавита, цифры и дефисы;
   • первый символ — буква, последний — не дефис.

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

1. Опишите в конфигурационном файле параметры ресурса yandex_compute_snapshot.

   Пример структуры конфигурационного файла:

   resource "yandex_compute_snapshot" "snapshot-1" {
     name           = "disk-snapshot"
     source_disk_id = "<идентификатор_диска>"
   }
   

   Более подробную информацию о ресурсах, которые вы можете создать с помощью Terraform, см. в документации провайдера.

2. Проверьте корректность конфигурационных файлов.

   1. В командной строке перейдите в папку, где вы создали конфигурационный файл.

   2. Выполните проверку с помощью команды:

      terraform plan
      

   Если конфигурация описана верно, в терминале отобразится список создаваемых ресурсов и их параметров. Если в конфигурации есть ошибки, Terraform на них укажет.

3. Разверните облачные ресурсы.

   1. Если в конфигурации нет ошибок, выполните команду:

      terraform apply
      

   2. Подтвердите создание ресурсов.

   После этого в указанном каталоге будут созданы все требуемые ресурсы. Проверить появление ресурсов и их настройки можно в консоли управления.

1. Получите список дисков с помощью метода REST API list для ресурса Disk или вызова gRPC API DiskService/List.
2. Создайте снимок с помощью метода REST API create для ресурса Snapshot или вызова gRPC API SnapshotService/Create.

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

По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name или --folder-id.

1. Посмотрите описание команды CLI для создания виртуальной машины:

   yc compute instance create --help
   

2. Подготовьте снимки нужных дисков, см. раздел Создать снимок диска.

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

   yc compute snapshot list
   

   Результат:

   +----------------------+-----------------+----------------------+--------+----------------------------+
   |          ID          |       NAME      |     PRODUCT IDS      | STATUS |        DESCRIPTION         |
   +----------------------+-----------------+----------------------+--------+----------------------------+
   | fd8rlt1u2rf0l******* | first-snapshot  | f2ecl5vhsftd******** | READY  | my first snapshot via CLI  |
   | fhmolt1u2rf0******** | second-snapshot | f2eclmol5lps******** | READY  | my second snapshot via CLI |
   +----------------------+-----------------+----------------------+--------+----------------------------+
   

4. Выберите идентификатор (ID) или имя (NAME) нужных снимков.

5. Создайте виртуальную машину в каталоге по умолчанию:

   yc compute instance create \
     --name first-instance \
     --zone ru-central1-a \
     --public-ip \
     --create-boot-disk snapshot-name=first-snapshot \
     --create-disk snapshot-name=second-snapshot \
     --ssh-key ~/.ssh/id_ed25519.pub
   

   Данная команда создаст виртуальную машину именем first-instance в зоне ru-central1-a, с публичным IP и дисками из снимков.

   Примечание

   Имя виртуальной машины используется для генерации внутреннего FQDN единожды — при создании ВМ. Если для вас важен внутренний FQDN, учитывайте это и задавайте нужное имя ВМ при создании.

   Чтобы создать виртуальную машину без публичного IP, исключите флаг --public-ip.

   Если вы хотите добавить на ВМ несколько сетевых интерфейсов, задайте параметр --network-interface необходимое количество раз. На одну ВМ можно добавить до восьми сетевых интерфейсов.

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

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

По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name или --folder-id.

1. Посмотрите описание команды CLI для удаления ВМ:

   yc compute instance delete --help
   

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

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

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

4. Удалите ВМ:

   yc compute instance delete first-instance
   

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

Если вы создавали ВМ с помощью Terraform, вы можете удалить ее:

1. В командной строке перейдите в папку, где расположен конфигурационный файл Terraform.

2. Удалите ресурсы с помощью команды:

   terraform destroy
   

   Внимание

   Terraform удалит все ресурсы, созданные в текущей конфигурации: кластеры, сети, подсети, ВМ и т. д.

3. Введите слово yes и нажмите Enter.

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

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

По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name или --folder-id.

1. Посмотрите описание команды CLI для переноса виртуальной машины в другую зону доступности:

   yc compute instance relocate --help
   

2. Получите список всех подсетей в каталоге по умолчанию:

   yc vpc subnet list
   

   Результат:

   +----------------------+-----------------------+----------------------+----------------+---------------+-------------------+
   |          ID          |         NAME          |      NETWORK ID      | ROUTE TABLE ID |     ZONE      |       RANGE       |
   +----------------------+-----------------------+----------------------+----------------+---------------+-------------------+
   | bucqps2lt75g******** | subnet-ru-central1-a1 | c64pv6m0aqq6******** |                | ru-central1-a | [192.168.11.0/24] |
   | e2lrucutusnd******** | subnet-ru-central1-a2 | c64pv6m0aqq6******** |                | ru-central1-a | [192.168.12.0/24] |
   | e2lv9c6aek1d******** | subnet-ru-central1-a3 | c64pv6m0aqq6******** |                | ru-central1-a | [192.168.13.0/24] |
   | bltign9kcffv******** | default-ru-central1-b | c64pv6m0aqq6******** |                | ru-central1-b | [192.168.1.0/24]  |
   +----------------------+-----------------------+----------------------+----------------+---------------+-------------------+
   

3. Получите список всех групп безопасности в каталоге по умолчанию:

   yc vpc sg list
   

   Результат:

   +----------------------+---------------------------------+--------------------------------+----------------------+
   |          ID          |              NAME               |          DESCRIPTION           |      NETWORK-ID      |
   +----------------------+---------------------------------+--------------------------------+----------------------+
   | c646ev94tb6k******** | my-sg-group                     |                                | c64pv6m0aqq6******** |
   | c64r84tbt32j******** | default-sg-c64pv6m0aqq6******** | Default security group for     | c64pv6m0aqq6******** |
   |                      |                                 | network                        |                      |
   +----------------------+---------------------------------+--------------------------------+----------------------+
   

4. Получите список всех виртуальных машин в каталоге по умолчанию:

   yc compute instance list
   

   Результат:

   +----------------------+---------+---------------+---------+---------------+-------------+
   |          ID          |  NAME   |    ZONE ID    | STATUS  |  EXTERNAL IP  | INTERNAL IP |
   +----------------------+---------+---------------+---------+---------------+-------------+
   | a7lh48f5jvlk******** | my-vm-1 | ru-central1-a | RUNNING |               | 192.168.0.7 |
   | epdsj30mndgj******** | my-vm-2 | ru-central1-b | RUNNING |               | 192.168.1.7 |
   +----------------------+---------+---------------+---------+---------------+-------------+
   

5. Получите список сетевых интерфейсов нужной ВМ, указав ее идентификатор:

   yc compute instance get <идентификатор_ВМ>
   

   Результат:

   ...
   network_interfaces:
     - index: "0"
       mac_address: d0:0d:24:**:**:**
       subnet_id: bucqps2lt75g********
       primary_v4_address:
         address: 192.168.11.23
         one_to_one_nat:
           address: 158.160.**.***
           ip_version: IPV4
     - index: "1"
       mac_address: d0:1d:24:**:**:**
       subnet_id: e2lrucutusnd********
       primary_v4_address:
         address: 192.168.12.32
     - index: "2"
       mac_address: d0:2d:24:**:**:**
       subnet_id: e2lv9c6aek1d********
       primary_v4_address:
         address: 192.168.13.26
   ...
   

6. Перенесите нужную виртуальную машину в другую зону доступности:

   yc compute instance relocate <идентификатор_ВМ> \
     --destination-zone-id <идентификатор_зоны_доступности> \
     --network-interface subnet-id=<идентификатор_подсети>,security-group-ids=<идентификатор_группы_безопасности>
   

   Где:

   • <идентификатор_ВМ> — идентификатор ВМ, которую требуется перенести в другую зону доступности.

   • --destination-zone-id — идентификатор зоны доступности, в которую требуется перенести ВМ.

   • --network-interface — настройки сетевого интерфейса ВМ:

     • subnet-id — идентификатор подсети, соответствующей зоне доступности, в которую требуется перенести ВМ.
     • security-group-ids — идентификатор группы безопасности, которую требуется привязать к переносимой ВМ. К одной ВМ можно привязать одновременно несколько групп безопасности, в этом случае передайте их идентификаторы через запятую в формате [id1,id2].

     Если у ВМ несколько сетевых интерфейсов, задайте параметр --network-interface необходимое количество раз (для каждого сетевого интерфейса).

   Подробнее о команде yc compute instance relocate см. в справочнике CLI.

   Пример:

   yc compute instance relocate a7lh48f5jvlk******** \
     --destination-zone-id ru-central1-b \
     --network-interface \
       subnet-id=bltign9kcffv********,security-group-ids=c646ev94tb6k********
   

   В этом примере ВМ my-vm-1 переносится из зоны доступности ru-central1-a в зону доступности ru-central1-b.

   Результат:

   done (3m15s)
   id: a7lh48f5jvlk********
   folder_id: aoeg2e07onia********
   created_at: "2023-10-13T19:47:40Z"
   name: my-vm-1
   zone_id: ru-central1-b
   platform_id: standard-v3
   resources:
     memory: "2147483648"
     cores: "2"
     core_fraction: "100"
   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: a7lp7jpslu59********
     auto_delete: true
     disk_id: a7lp7jpslu59********
   network_interfaces:
     - index: "0"
       mac_address: d0:0d:11:**:**:**
       subnet_id: bltign9kcffv********
       primary_v4_address:
         address: 192.168.1.17
       security_group_ids:
         - c646ev94tb6k********
   gpu_settings: {}
   fqdn: my-vm-1.ru-central1.internal
   scheduling_policy: {}
   network_settings:
     type: STANDARD
   placement_policy: {}
   

   Если вы переносите ВМ с диском в группе размещения, используйте команду:

   yc compute instance relocate <идентификатор_ВМ> \
     --destination-zone-id <идентификатор_зоны_доступности> \
     --network-interface subnet-id=<идентификатор_подсети>,security-group-ids=<идентификатор_группы_безопасности> \
     --boot-disk-placement-group-id <идентификатор_группы_размещения_дисков> \
     --boot-disk-placement-group-partition <номер_раздела> \
     --secondary-disk-placement disk-name=<имя_диска>,disk-placement-group-id=<идентификатор_группы_размещения_дисков>,disk-placement-group-partition=<номер_раздела>
   

   Где:

   • --boot-disk-placement-group-id — идентификатор группы размещения дисков.

   • --boot-disk-placement-group-partition — номер раздела в группе размещения дисков со стратегией размещения разделами.

   • --secondary-disk-placement — политика размещения для дополнительных дисков. Параметры:

     • disk-name — имя диска.
     • disk-placement-group-id — идентификатор группы размещения дисков, в которую необходимо поместить диск.
     • disk-placement-group-partition — номер раздела в группе размещения дисков.

   Подробнее о команде yc compute instance relocate см. в справочнике CLI.

Обратите внимание, что при подключении сетевых интерфейсов ВМ к новым подсетям изменится адресация. Если для сетевых интерфейсов ВМ требуется указать внутренние IP-адреса, используйте свойство ipv4-address=<внутренний_IP-адрес>, если публичные IP-адреса — свойство nat-address=<публичный_IP-адрес> параметра network-interface. В остальном установка параметров сетевых интерфейсов при переносе ВМ в другую зону доступности аналогична установке таких параметров при создании ВМ.