Getting started with Packer

Packer enables you to create VM disk images and set their properties in a configuration file. This guide describes how to create a disk image in Yandex Compute Cloud using Packer.

In this scenario, Packer will create and launch a Debian 11 virtual machine from Cloud Marketplace, with a nginx web server installed on it. Following that, it will delete the VM and create an image of its boot disk. After that, it will also delete the disk.

To create an image:

1. Get your cloud ready.
2. Install Packer.
3. Prepare the image configuration.
4. Create an image.
5. Check the image.

If you no longer need the image you created, delete it.

Get your cloud readyGet your cloud ready

Sign up for Yandex Cloud and create a billing account:

1. Go to the management console and log in to Yandex Cloud or create an account if you do not have one yet.
2. On the Yandex Cloud Billing page, make sure you have a billing account linked and it has the ACTIVE or TRIAL_ACTIVE status. If you do not have a billing account, create one.

If you have an active billing account, you can go to the cloud page to create or select a folder for your infrastructure to operate in.

Learn more about clouds and folders.

Configure the environment and infrastructureConfigure the environment and infrastructure

1. Install the Yandex Cloud command line interface (CLI).

   Tip

   If you access the cloud with a federated account and want to use the CLI from within your VM, get authenticated in the CLI as a service account.

2. Create a cloud network with a single subnet in your folder.

3. Get an OAuth token for a Yandex account or an IAM token for a federated account.

Required paid resourcesRequired paid resources

The cost of creating a disk image using Packer includes:

• Fee for storing created images (see Yandex Compute Cloud pricing).
• Fee for VM computing resources (see Yandex Compute Cloud pricing).

Install and configure PackerInstall and configure Packer

You can install Packer from a mirror or the HashiCorp website:

From a mirrorFrom a mirror

Install a Packer distribution kit for your platform from a mirror:

From the HashiCorp websiteFrom the HashiCorp website

Download and install a Packer distribution kit following this guide on the Packer website.

Configure the Yandex Compute Builder pluginConfigure the Yandex Compute Builder plugin

To configure the plugin:

1. Create a file named config.pkr.hcl with the following contents:

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

2. Install the plugin:

   packer init <path_to_config.pkr.hcl>
   

   Result:

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

Prepare the image configurationPrepare the image configuration

1. Get the folder ID.

2. Get the subnet ID and the availability zone it resides in.

3. Prepare the subnet ID by running the yc vpc subnet list command.

4. Create a JSON file with any name, e.g., image.json. Add this configuration to it:

   {
     "builders": [
       {
         "type":      "yandex",
         "token":     "<OAuth_token_or_IAM_token>",
         "folder_id": "<folder_ID>",
         "zone":      "<availability_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":           "<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"
         ]
       }
     ]
   }
   

   Where:

   • <availability_zone>: Availability zone where you are going to create the VM, e.g., ru-central1-d.
   • token: OAuth token for a Yandex account or an IAM token for a federated account.
   • folder_id: ID of the folder where you are going to create the VM and its image.
   • subnet_id: ID of the subnet where you are going to create the VM and its image.

You can learn more about image configuration properties in this Yandex Compute Builder overview article.

Create an imageCreate an image

1. Build the image using the configuration properties:

   packer build image.json
   

2. Wait for the build to complete:

   ...
   ==> 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
   

Check the imageCheck the image

Make sure you created the image:

yc compute image list

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

Delete the resources you createdDelete the resources you created

If you no longer need the image you created, delete it.

Delete the subnet and cloud network if you created them specifically to follow this tutorial.