Быстрый старт

Создайте неизменяемый образ ВМ с помощью Packer и плагина mws и начните с ним работать:

1. Установите Packer.
2. Установите плагин mws для Packer.
3. Создайте образ с помощью плагина.

1. Получите учетные данные для авторизации плагина в облачной платформе MWS одним из способов:

   • получите файл с авторизованным ключом сервисного аккаунта;
   • получите IAM-токен.

   Если ни один из способов авторизации не задан, а Packer запущен на виртуальной машине в сервисе Compute с привязанным сервисным аккаунтом, плагин автоматически возьмет учетные данные из сервиса метаданных.

2. Убедитесь, что текущих квот достаточно для работы Packer. Packer автоматически создает вспомогательные ресурсы, если они не указаны в конфигурации. Все ресурсы, созданные Packer, расходуют квоты. Минимально для работы Packer необходимы виртуальная машина, сеть, подсеть и сетевой диск.

1. Установите Packer с зеркала MWS или используйте официальный дистрибутив.

2. Проверьте установку:

   1
   packer version

   Пример вывода:

   1
   Packer v1.16.0

1. Создайте файл конфигурации Packer и добавьте в него блок packer с указанием плагина:

   1
   packer {
   2
     required_plugins {
   3
       mws = {
   4
         version = ">= 0.6.0"
   5
         source  = "github.com/mws-cloud-platform/mws"
   6
       }
   7
     }
   8
   }

2. Установите плагин mws:

   1
   packer init <путь к файлу конфигурации Packer>

   Packer скачает бинарный файл плагина нужной версии и установит его.

1. Дополните конфигурацию Packer параметрами создаваемого образа:

   1
   packer {
   2
     required_plugins {
   3
       mws = {
   4
         version = ">= 0.6.0"
   5
         source  = "github.com/mws-cloud-platform/mws"
   6
       }
   7
     }
   8
   }
   9
   
   10
   variable "project" {
   11
     type = string
   12
   }
   13
   
   14
   variable "service_account_authorized_key_path" {
   15
     type = string
   16
   }
   17
   
   18
   variable "token" {
   19
     type = string
   20
   }
   21
   
   22
   source "mws" "example" {
   23
     project = var.project
   24
   
   25
     # Используйте для авторизации с ключом сервисного аккаунта
   26
     service_account_authorized_key_path = var.service_account_authorized_key_path
   27
   
   28
     # Используйте для авторизации с IAM-токеном
   29
     token = var.token
   30
   
   31
     source_project = "<имя проекта-источника — например, mws-ubuntu>"
   32
     source_image   = "<имя образа-источника — например, mws-ubuntu-2404-lts-v20260324>"
   33
   
   34
     vm_type = "<тип виртуальной машины — например, gen-2-8>"
   35
   
   36
     disk_type = "nbs-pl2"
   37
     disk_size = "<объем диска — например, 10 GB>"
   38
     disk_iops = <количество IOPS — например, 1000>
   39
   
   40
     use_external_address = true
   41
   
   42
     cleanup_timeout = "<тайм-аут удаления временных ресурсов — например, 1h>"
   43
   }
   44
   
   45
   build {
   46
     sources = ["source.mws.example"]
   47
   
   48
     provisioner "shell" {
   49
       inline = [
   50
         "<команды для выполнения во временной ВМ — например, sudo snap install hello-world>",
   51
       ]
   52
     }
   53
   }

   Полный список полей сборщика в репозитории плагина.

2. Запустите сборку, выполнив команду для выбранного способа авторизации:

   • Ключ сервисного аккаунта
   • IAM-токен
   • Метаданные ВМ

   1
   packer build \
   2
     -var project=<идентификатор целевого проекта> \
   3
     -var service_account_authorized_key_path=<путь к файлу с ключом сервисного аккаунта> \
   4
     <путь к конфигурации Packer>

   1
   packer build \
   2
     -var project=<идентификатор целевого проекта> \
   3
     -var token=<IAM-токен> \
   4
     <путь к конфигурации Packer>

   1
   packer build \
   2
     -var project=<идентификатор целевого проекта> \
   3
     <путь к конфигурации Packer>

   Packer создаст временную ВМ из образа-источника, выполнит команды, заданные в блоках provisioner в конфигурации, и сохранит диск ВМ в качестве нового образа.

   Вы можете следить за процессом создания образа прямо в терминале. Packer выведет информацию о ходе создания ресурсов, а также потоки stdout и stderr для команд из блока provisioner "shell".

   По завершении сборки временные ресурсы, созданные Packer — ВМ, сеть, подсеть, сетевой диск, ключи шифрования — будут удалены в течение заданного тайм-аута очистки (по умолчанию — 1 час).

3. Выведите информацию об образе, чтобы проверить его успешное создание.