Remove 'yandex.html.md', 'yandex.html.md.erb' would be used
Signed-off-by: Gennady Lipenkov <xgen@yandex-team.ru>
This commit is contained in:
Gennady Lipenkov
parent
d070b4868a
commit
ad7feedb08
|
|
@ -1,150 +0,0 @@
|
|||
---
|
||||
description: |
|
||||
The yandex Packer builder is able to create images for use with
|
||||
Yandex.Cloud based on existing images.
|
||||
layout: docs
|
||||
page_title: 'Yandex Compute - Builders'
|
||||
sidebar_current: 'docs-builders-yandex'
|
||||
---
|
||||
|
||||
# Yandex Compute Builder
|
||||
|
||||
Type: `yandex`
|
||||
|
||||
The `yandex` Packer builder is able to create
|
||||
[images](https://cloud.yandex.com/docs/compute/concepts/images) for use with
|
||||
[Yandex Compute Cloud](https://cloud.yandex.com/docs/compute/)
|
||||
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
|
||||
|
||||
``` json
|
||||
{
|
||||
"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](/docs/templates/communicator.html)
|
||||
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`.
|
||||
|
||||
- `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.
|
||||
|
||||
- `instance_cores` (number) - The number of cores available to the instance.
|
||||
|
||||
- `instance_gpus` (number) - The number of GPU available to the instance.
|
||||
|
||||
- `instance_mem_gb` (number) - The amount of memory available to the instance, specified in gigabytes.
|
||||
|
||||
- `disk_name` (string) - The name of the disk, if unset the instance name
|
||||
will be used.
|
||||
|
||||
- `disk_size_gb` (number) - 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` (object of key/value strings) - 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` (list) - License IDs that indicate which licenses are attached to resulting image.
|
||||
|
||||
- `instance_name` (string) - The name assigned to the instance.
|
||||
|
||||
- `labels` (object of key/value strings) - 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` (number) - The maximum number of times an API request is being executed.
|
||||
|
||||
- `metadata` (object of key/value strings) - Metadata applied to the launched
|
||||
instance.
|
||||
|
||||
- `serial_log_file` (string) - File path to save serial port output of the launched instance.
|
||||
|
||||
- `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`.
|
||||
|
||||
- `source_image_family` (string) - The source image family to create
|
||||
the new image from. The image family always returns its latest image that
|
||||
is not deprecated. Example: `ubuntu-1804-lts`.
|
||||
|
||||
- `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.
|
||||
|
||||
- `use_internal_ip` (boolean) - If true, use the instance's internal IP address
|
||||
instead of its external IP during building.
|
||||
|
||||
- `use_ipv4_nat` (boolean) - If set to `true`, then launched instance will have external internet
|
||||
access.
|
||||
|
||||
- `use_ipv6` (boolean) - Set to `true` to enable IPv6 for the instance being
|
||||
created. This defaults to `false`, or not enabled.
|
||||
|
||||
\-> **Note:** Usage of IPv6 will be available in the future.
|
||||
|
||||
- `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`.
|
||||
|
||||
- `state_timeout` (string) - The time to wait for instance state changes.
|
||||
Defaults to `5m`.
|
||||
|
||||
- `zone` (string) - The name of the zone to launch the instance. This defaults to `ru-central1-a`.
|
||||
Loading…
Reference in New Issue