Начало работы с 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. Установите интерфейс командной строки Yandex Cloud.

   Совет

   Если вы работаете с облаком с помощью федеративного аккаунта и хотите использовать CLI изнутри ВМ, аутентифицируйтесь в CLI от имени сервисного аккаунта.

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

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

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

В стоимость создания образа диска с помощью 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. Подготовьте идентификатор подсети, выполнив команду yc vpc subnet list.

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

   {
     "builders": [
       {
         "type":      "yandex",
         "token":     "<OAuth-токен_или_IAM-токен>",
         "folder_id": "<идентификатор_каталога>",
         "zone":      "ru-central1-a",
   
         "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 — идентификатор каталога, в котором будет создана ВМ и ее образ.
   • 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  |
+----------------------+--------------------------------------+-------------------+----------------------+--------+

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

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

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