packer-cn/website/source/docs/builders/oneandone.html.md

67 lines
1.7 KiB
Markdown
Raw Normal View History

2016-11-13 17:34:36 -05:00
---
2017-06-14 21:04:16 -04:00
description: 'The 1&1 builder is able to create images for 1&1 cloud.'
2016-11-13 17:34:36 -05:00
layout: docs
2017-06-14 21:04:16 -04:00
page_title: '1&1 - Builders'
sidebar_current: 'docs-builders-oneandone'
---
2016-11-13 17:34:36 -05:00
# 1&1 Builder
Type: `oneandone`
2018-10-26 20:02:51 -04:00
The 1&1 Builder is able to create virtual machines for
[1&1](https://www.1and1.com/).
2016-11-13 17:34:36 -05:00
## Configuration Reference
There are many configuration options available for the builder. They are
segmented below into two categories: required and optional parameters. Within
each category, the available configuration keys are alphabetized.
In addition to the options listed here, a
[communicator](/docs/templates/communicator.html) can be configured for this
builder.
### Required
2017-06-14 21:04:16 -04:00
- `source_image_name` (string) - 1&1 Server Appliance name of type `IMAGE`.
2016-11-13 17:34:36 -05:00
2018-10-26 20:02:51 -04:00
- `token` (string) - 1&1 REST API Token. This can be specified via
environment variable `ONEANDONE_TOKEN`
2016-11-13 17:34:36 -05:00
### Optional
2018-10-26 20:02:51 -04:00
- `data_center_name` - Name of virtual data center. Possible values "ES",
"US", "GB", "DE". Default value "US"
2018-10-26 20:02:51 -04:00
- `disk_size` (string) - Amount of disk space for this image in GB. Defaults
to "50"
2016-11-13 17:34:36 -05:00
2018-10-26 20:02:51 -04:00
- `image_name` (string) - Resulting image. If "image\_name" is not provided
Packer will generate it
2016-11-13 17:34:36 -05:00
2018-10-26 20:02:51 -04:00
- `retries` (number) - Number of retries Packer will make status requests
while waiting for the build to complete. Default value "600".
2016-11-13 17:34:36 -05:00
2018-10-26 20:02:51 -04:00
- `url` (string) - Endpoint for the 1&1 REST API. Default URL
"<https://cloudpanel-api.1and1.com/v1>"
2016-11-13 17:34:36 -05:00
## Example
Here is a basic example:
2017-06-14 21:04:16 -04:00
``` json
2016-11-13 17:34:36 -05:00
{
"builders":[
{
"type":"oneandone",
"disk_size":"50",
"image_name":"test5",
"source_image_name":"ubuntu1604-64min",
2017-06-05 21:19:09 -04:00
"ssh_username" :"root",
"ssh_private_key_file" : "/path/to/private/ssh/key"
}
]
2016-11-13 17:34:36 -05:00
}
```