»Yandex Compute Builder

Type: yandex

The yandex Packer builder is able to create images for use with Yandex Compute Cloud based on existing images.

»Authentication

Yandex.Cloud services authentication requires one of the following security credentials:

  • OAuth token
  • File with Service Account Key

»Authentication Using Token

To authenticate with an OAuth token only token config key is needed. Or use the YC_TOKEN environment variable.

»Authentication Using Service Account Key File

To authenticate with a service account credential, only service_account_key_file is needed. Or use the YC_SERVICE_ACCOUNT_KEY_FILE environment variable.

»Basic Example

{
  "type": "yandex",
  "token": "YOUR OAUTH TOKEN",
  "folder_id": "YOUR FOLDER ID",
  "source_image_family": "ubuntu-1804-lts",
  "ssh_username": "ubuntu",
  "use_ipv4_nat": "true"
}

»Configuration Reference

Configuration options are organized below into two categories: required and optional. Within each category, the available options are alphabetized and described.

In addition to the options listed here, a communicator can be configured for this builder.

»Required:

  • folder_id (string) - The folder ID that will be used to launch instances and store images. Alternatively you may set value by environment variable YC_FOLDER_ID. To use a different folder for looking up the source image or saving the target image to check options 'source_image_folder_id' and 'target_image_folder_id'.
  • token (string) - OAuth token to use to authenticate to Yandex.Cloud. Alternatively you may set value by environment variable YC_TOKEN.
  • source_image_family (string) - The source image family to create the new image from. You can also specify source_image_id instead. Just one of a source_image_id or source_image_family must be specified. Example: ubuntu-1804-lts

»Optional:

  • endpoint (string) - Non standard api endpoint URL.

  • service_account_key_file (string) - Path to file with Service Account key in json format. This is an alternative method to authenticate to Yandex.Cloud. Alternatively you may set environment variable YC_SERVICE_ACCOUNT_KEY_FILE.

  • service_account_id (string) - Service account identifier to assign to instance

  • disk_name (string) - The name of the disk, if unset the instance name will be used.

  • disk_size_gb (int) - The size of the disk in GB. This defaults to 10, which is 10GB.

  • disk_type (string) - Specify disk type for the launched instance. Defaults to network-hdd.

  • image_description (string) - The description of the resulting image.

  • image_family (string) - The family name of the resulting image.

  • image_labels (map[string]string) - Key/value pair labels to apply to the created image.

  • image_name (string) - The unique name of the resulting image. Defaults to packer-{{timestamp}}.

  • image_product_ids ([]string) - License IDs that indicate which licenses are attached to resulting image.

  • instance_cores (int) - The number of cores available to the instance.

  • instance_gpus (int) - The number of GPU available to the instance.

  • instance_mem_gb (int) - The amount of memory available to the instance, specified in gigabytes.

  • instance_name (string) - The name assigned to the instance.

  • labels (map[string]string) - Key/value pair labels to apply to the launched instance.

  • platform_id (string) - Identifier of the hardware platform configuration for the instance. This defaults to standard-v1.

  • max_retries (int) - The maximum number of times an API request is being executed

  • metadata (map[string]string) - Metadata applied to the launched instance.

  • metadata_from_file (map[string]string) - Metadata applied to the launched instance. Value are file paths.

  • preemptible (bool) - Launch a preemptible instance. This defaults to false.

  • serial_log_file (string) - File path to save serial port output of the launched instance.

  • source_image_folder_id (string) - The ID of the folder containing the source image.

  • source_image_id (string) - The source image ID to use to create the new image from.

  • source_image_name (string) - The source image name to use to create the new image from. Name will be looked up in source_image_folder_id.

  • subnet_id (string) - The Yandex VPC subnet id to use for the launched instance. Note, the zone of the subnet must match the zone in which the VM is launched.

  • target_image_folder_id (string) - The ID of the folder to save built image in. This defaults to value of 'folder_id'.

  • use_ipv4_nat (bool) - If set to true, then launched instance will have external internet access.

  • use_ipv6 (bool) - Set to true to enable IPv6 for the instance being created. This defaults to false, or not enabled.

  • use_internal_ip (bool) - If true, use the instance's internal IP address instead of its external IP during building.

  • zone (string) - The name of the zone to launch the instance. This defaults to ru-central1-a.

  • state_timeout (duration string | ex: "1h5m2s") - The time to wait for instance state changes. Defaults to 5m.