Начало работы с Packer

Packer позволяет создавать образы дисков виртуальных машин с заданными в конфигурационном файле параметрами. Руководство описывает создание образа диска в Yandex Compute Cloud с помощью Packer.

Packer создаст и запустит виртуальную машину с ОС Debian 11 из Cloud Marketplace, на которую будет установлен веб-сервер nginx. Затем ВМ будет удалена и будет создан образ ее загрузочного диска. После этого диск тоже будет удален.

Чтобы создать образ:

1. Подготовьте облако к работе.
2. Установите Packer.
3. Подготовьте конфигурацию образа.
4. Создайте образ.
5. Проверьте образ.

Если созданный образ больше не нужен, удалите его.

Подготовьте облако к работеПодготовьте облако к работе

Зарегистрируйтесь в Yandex Cloud и создайте платежный аккаунт:

1. Перейдите в консоль управления, затем войдите в Yandex Cloud или зарегистрируйтесь.
2. На странице Yandex Cloud Billing убедитесь, что у вас подключен платежный аккаунт, и он находится в статусе ACTIVE или TRIAL_ACTIVE. Если платежного аккаунта нет, создайте его и привяжите к нему облако.

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

Подробнее об облаках и каталогах.

Настройте окружение и инфраструктуруНастройте окружение и инфраструктуру

1. Создайте в вашем каталоге облачную сеть с одной подсетью.

2. В зависимости от типа аккаунта, от имени которого вы работаете, получите:

   • OAuth-токен для аккаунта на Яндексе.
   • IAM-токен для федеративного или сервисного аккаунтов.

3. Убедитесь, что у вашего аккаунта достаточно прав для создания ресурсов в сервисе Compute Cloud. У вас должна быть минимальная роль compute.editor на каталог.

   Если вы работаете от имени сервисного аккаунта, назначьте ему роль compute.editor на каталог.

   Если вы хотите создавать ресурсы в других сервисах Yandex Cloud, например подсети в VPC, то также назначьте соответствующие сервисные роли.

Необходимые платные ресурсыНеобходимые платные ресурсы

В стоимость создания образа диска с помощью Packer входит:

• плата за хранение созданных образов (см. тарифы Yandex Compute Cloud);
• плата за вычислительные ресурсы ВМ (см. тарифы Yandex Compute Cloud).

Установите и настройте PackerУстановите и настройте Packer

Вы можете установить Packer из зеркала или с сайта HashiCorp.

Из зеркалаИз зеркала

Установите дистрибутив Packer для вашей платформы из зеркала:

С сайта HashiCorpС сайта HashiCorp

Скачайте и установите дистрибутив Packer по инструкции на официальном сайте.

Настройте плагин Yandex Compute BuilderНастройте плагин Yandex Compute Builder

Чтобы настроить плагин:

1. Создайте файл config.pkr.hcl со следующим содержанием:

   packer {
     required_plugins {
       yandex = {
         version = ">= 1.1.2"
         source  = "github.com/hashicorp/yandex"
       }
     }
   }
   

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

   packer init <путь_к_файлу_config.pkr.hcl>
   

   Результат:

   Installed plugin github.com/hashicorp/yandex v1.1.2 in ...
   

Подготовьте конфигурацию образаПодготовьте конфигурацию образа

1. Узнайте идентификатор каталога.

2. Узнайте идентификатор подсети и зону доступности, в которой она расположена.

3. Создайте JSON-файл с любым именем, например: image.json. Запишите туда следующую конфигурацию:

   {
     "builders": [
       {
         "type":      "yandex",
         "token":     "<OAuth-токен_или_IAM-токен>",
         "folder_id": "<идентификатор_каталога>",
         "zone":      "<зона_доступности>",
   
         "image_name":        "debian-11-nginx-{{isotime | clean_resource_name}}",
         "image_family":      "debian-web-server",
         "image_description": "my custom debian with nginx",
   
         "source_image_family": "debian-11",
         "subnet_id":           "<идентификатор_подсети>",
         "use_ipv4_nat":        true,
         "disk_type":           "network-ssd",
         "ssh_username":        "debian"
       }
     ],
     "provisioners": [
       {
         "type": "shell",
         "inline": [
           "echo 'updating APT'",
           "sudo apt-get update -y",
           "sudo apt-get install -y nginx",
           "sudo su -",
           "sudo systemctl enable nginx.service",
           "curl localhost"
         ]
       }
     ]
   }
   

   Где:

   • token — OAuth-токен для аккаунта на Яндексе или IAM-токен для федеративного или сервисного аккаунтов.
   • folder_id — идентификатор каталога, в котором будет создана ВМ и ее образ.
   • zone — зона доступности, в которой будет создана ВМ. Например: ru-central1-d.
   • subnet_id — идентификатор подсети, в которой будет создана ВМ и ее образ.

Подробнее о параметрах конфигурации образа см. в документации Yandex Compute Builder.

Создайте образСоздайте образ

1. Запустите сборку образа с указанными в конфигурации параметрами:

   packer build image.json
   

2. Дождитесь завершения сборки:

   ...
   ==> Wait completed after 2 minutes 43 seconds
   ==> Builds finished. The artifacts of successful builds are:
   --> yandex: A disk image was created: debian-11-nginx-2024-08-26t15-30-39z (id: fd82d63b9bgc********) with family name debian-web-server
   

Проверьте созданный образПроверьте созданный образ

Убедитесь, что образ создан:

yc compute image list

+----------------------+--------------------------------------+-------------------+----------------------+--------+
|          ID          |                 NAME                 |      FAMILY       |     PRODUCT IDS      | STATUS |
+----------------------+--------------------------------------+-------------------+----------------------+--------+
| fd82d63b9bgc******** | debian-11-nginx-2024-08-26t15-30-39z | debian-web-server | f2eerqfup7lg******** | READY  |
+----------------------+--------------------------------------+-------------------+----------------------+--------+

Удалите созданные ресурсыУдалите созданные ресурсы

Чтобы перестать платить за созданные ресурсы:

• Удалите созданный образ.
• Удалите подсеть и облачную сеть, если вы их создавали специально для выполнения руководства.