Compare commits
	
		
			9 Commits
		
	
	
		
			master
			...
			backport/n
		
	
	| Author | SHA1 | Date | |
|---|---|---|---|
|  | 7900ed99cc | ||
|  | 69c080165f | ||
|  | dc5fd80b09 | ||
|  | e557af14b3 | ||
|  | ba47ee8efd | ||
|  | 2e78193cc8 | ||
|  | 5ade0dc87b | ||
|  | 85b56043c3 | ||
|  | 3a9cc74e64 | 
							
								
								
									
										14
									
								
								.github/workflows/linkchecker.yml
									
									
									
									
										vendored
									
									
										Normal file
									
								
							
							
						
						
									
										14
									
								
								.github/workflows/linkchecker.yml
									
									
									
									
										vendored
									
									
										Normal file
									
								
							| @ -0,0 +1,14 @@ | |||||||
|  | on: [pull_request] | ||||||
|  | name: Check Markdown links for modified files | ||||||
|  | jobs: | ||||||
|  |   markdown-link-check: | ||||||
|  |     runs-on: ubuntu-latest | ||||||
|  |     steps: | ||||||
|  |     - uses: actions/checkout@master | ||||||
|  |     - uses: gaurav-nelson/github-action-markdown-link-check@v1 | ||||||
|  |       with: | ||||||
|  |         use-quiet-mode: 'yes' | ||||||
|  |         file-extension: 'mdx' | ||||||
|  |         check-modified-files-only: 'yes' | ||||||
|  |         folder-path: 'website/content' | ||||||
|  | 
 | ||||||
							
								
								
									
										14
									
								
								.github/workflows/scheduled-link-checker.yml
									
									
									
									
										vendored
									
									
										Normal file
									
								
							
							
						
						
									
										14
									
								
								.github/workflows/scheduled-link-checker.yml
									
									
									
									
										vendored
									
									
										Normal file
									
								
							| @ -0,0 +1,14 @@ | |||||||
|  | on: | ||||||
|  |   schedule: | ||||||
|  |   - cron: "45 0 * * *" | ||||||
|  | name: Check Markdown links on main branch | ||||||
|  | jobs: | ||||||
|  |   markdown-link-check: | ||||||
|  |     runs-on: ubuntu-latest | ||||||
|  |     steps: | ||||||
|  |     - uses: actions/checkout@master | ||||||
|  |     - uses: gaurav-nelson/github-action-markdown-link-check@v1 | ||||||
|  |       with: | ||||||
|  |         use-quiet-mode: 'yes' | ||||||
|  |         file-extension: 'mdx' | ||||||
|  |         folder-path: 'website/content' | ||||||
| @ -85,7 +85,7 @@ type RunConfig struct { | |||||||
| 	BlockDurationMinutes int64 `mapstructure:"block_duration_minutes" required:"false"` | 	BlockDurationMinutes int64 `mapstructure:"block_duration_minutes" required:"false"` | ||||||
| 	// Packer normally stops the build instance after all provisioners have | 	// Packer normally stops the build instance after all provisioners have | ||||||
| 	// run. For Windows instances, it is sometimes desirable to [run | 	// run. For Windows instances, it is sometimes desirable to [run | ||||||
| 	// Sysprep](http://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/ami-create-standard.html) | 	// Sysprep](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/Creating_EBSbacked_WinAMI.html) | ||||||
| 	// which will stop the instance for you. If this is set to `true`, Packer | 	// which will stop the instance for you. If this is set to `true`, Packer | ||||||
| 	// *will not* stop the instance but will assume that you will send the stop | 	// *will not* stop the instance but will assume that you will send the stop | ||||||
| 	// signal yourself through your final provisioner. You can do this with a | 	// signal yourself through your final provisioner. You can do this with a | ||||||
|  | |||||||
| @ -196,20 +196,20 @@ type Config struct { | |||||||
| 	// Image Definition won't use this Image Version. | 	// Image Definition won't use this Image Version. | ||||||
| 	SharedGalleryImageVersionExcludeFromLatest bool `mapstructure:"shared_gallery_image_version_exclude_from_latest" required:"false"` | 	SharedGalleryImageVersionExcludeFromLatest bool `mapstructure:"shared_gallery_image_version_exclude_from_latest" required:"false"` | ||||||
| 	// Name of the publisher to use for your base image (Azure Marketplace Images only). See | 	// Name of the publisher to use for your base image (Azure Marketplace Images only). See | ||||||
| 	// [documentation](https://azure.microsoft.com/en-us/documentation/articles/resource-groups-vm-searching/) | 	// [documentation](https://docs.microsoft.com/en-us/cli/azure/vm/image) | ||||||
| 	// for details. | 	// for details. | ||||||
| 	// | 	// | ||||||
| 	// CLI example `az vm image list-publishers --location westus` | 	// CLI example `az vm image list-publishers --location westus` | ||||||
| 	ImagePublisher string `mapstructure:"image_publisher" required:"true"` | 	ImagePublisher string `mapstructure:"image_publisher" required:"true"` | ||||||
| 	// Name of the publisher's offer to use for your base image (Azure Marketplace Images only). See | 	// Name of the publisher's offer to use for your base image (Azure Marketplace Images only). See | ||||||
| 	// [documentation](https://azure.microsoft.com/en-us/documentation/articles/resource-groups-vm-searching/) | 	// [documentation](https://docs.microsoft.com/en-us/cli/azure/vm/image) | ||||||
| 	// for details. | 	// for details. | ||||||
| 	// | 	// | ||||||
| 	// CLI example | 	// CLI example | ||||||
| 	// `az vm image list-offers --location westus --publisher Canonical` | 	// `az vm image list-offers --location westus --publisher Canonical` | ||||||
| 	ImageOffer string `mapstructure:"image_offer" required:"true"` | 	ImageOffer string `mapstructure:"image_offer" required:"true"` | ||||||
| 	// SKU of the image offer to use for your base image (Azure Marketplace Images only). See | 	// SKU of the image offer to use for your base image (Azure Marketplace Images only). See | ||||||
| 	// [documentation](https://azure.microsoft.com/en-us/documentation/articles/resource-groups-vm-searching/) | 	// [documentation](https://docs.microsoft.com/en-us/cli/azure/vm/image) | ||||||
| 	// for details. | 	// for details. | ||||||
| 	// | 	// | ||||||
| 	// CLI example | 	// CLI example | ||||||
|  | |||||||
| @ -143,20 +143,20 @@ type Config struct { | |||||||
| 	SharedGalleryTimeout time.Duration `mapstructure:"shared_image_gallery_timeout"` | 	SharedGalleryTimeout time.Duration `mapstructure:"shared_image_gallery_timeout"` | ||||||
| 
 | 
 | ||||||
| 	// PublisherName for your base image. See | 	// PublisherName for your base image. See | ||||||
| 	// [documentation](https://azure.microsoft.com/en-us/documentation/articles/resource-groups-vm-searching/) | 	// [documentation](https://docs.microsoft.com/en-us/cli/azure/vm/image) | ||||||
| 	// for details. | 	// for details. | ||||||
| 	// | 	// | ||||||
| 	// CLI example `az vm image list-publishers --location westus` | 	// CLI example `az vm image list-publishers --location westus` | ||||||
| 	ImagePublisher string `mapstructure:"image_publisher"` | 	ImagePublisher string `mapstructure:"image_publisher"` | ||||||
| 	// Offer for your base image. See | 	// Offer for your base image. See | ||||||
| 	// [documentation](https://azure.microsoft.com/en-us/documentation/articles/resource-groups-vm-searching/) | 	// [documentation](https://docs.microsoft.com/en-us/cli/azure/vm/image) | ||||||
| 	// for details. | 	// for details. | ||||||
| 	// | 	// | ||||||
| 	// CLI example | 	// CLI example | ||||||
| 	// `az vm image list-offers --location westus --publisher Canonical` | 	// `az vm image list-offers --location westus --publisher Canonical` | ||||||
| 	ImageOffer string `mapstructure:"image_offer"` | 	ImageOffer string `mapstructure:"image_offer"` | ||||||
| 	// SKU for your base image. See | 	// SKU for your base image. See | ||||||
| 	// [documentation](https://azure.microsoft.com/en-us/documentation/articles/resource-groups-vm-searching/) | 	// [documentation](https://docs.microsoft.com/en-us/cli/azure/vm/image) | ||||||
| 	// for details. | 	// for details. | ||||||
| 	// | 	// | ||||||
| 	// CLI example | 	// CLI example | ||||||
|  | |||||||
| @ -71,7 +71,7 @@ type Config struct { | |||||||
| 	//  * ebfb681885ddf1234c18094a45bbeafd91467911 | 	//  * ebfb681885ddf1234c18094a45bbeafd91467911 | ||||||
| 	//  * sha256:ed363350696a726b7932db864dda019bd2017365c9e299627830f06954643f93 | 	//  * sha256:ed363350696a726b7932db864dda019bd2017365c9e299627830f06954643f93 | ||||||
| 	//  * ed363350696a726b7932db864dda019bd2017365c9e299627830f06954643f93 | 	//  * ed363350696a726b7932db864dda019bd2017365c9e299627830f06954643f93 | ||||||
| 	//  * file:http://releases.ubuntu.com/20.04/MD5SUMS | 	//  * file:http://releases.ubuntu.com/20.04/SHA256SUMS | ||||||
| 	//  * file:file://./local/path/file.sum | 	//  * file:file://./local/path/file.sum | ||||||
| 	//  * file:./local/path/file.sum | 	//  * file:./local/path/file.sum | ||||||
| 	//  * none | 	//  * none | ||||||
|  | |||||||
| @ -43,7 +43,7 @@ type Config struct { | |||||||
| 	//  * ebfb681885ddf1234c18094a45bbeafd91467911 | 	//  * ebfb681885ddf1234c18094a45bbeafd91467911 | ||||||
| 	//  * sha256:ed363350696a726b7932db864dda019bd2017365c9e299627830f06954643f93 | 	//  * sha256:ed363350696a726b7932db864dda019bd2017365c9e299627830f06954643f93 | ||||||
| 	//  * ed363350696a726b7932db864dda019bd2017365c9e299627830f06954643f93 | 	//  * ed363350696a726b7932db864dda019bd2017365c9e299627830f06954643f93 | ||||||
| 	//  * file:http://releases.ubuntu.com/20.04/MD5SUMS | 	//  * file:http://releases.ubuntu.com/20.04/SHA256SUMS | ||||||
| 	//  * file:file://./local/path/file.sum | 	//  * file:file://./local/path/file.sum | ||||||
| 	//  * file:./local/path/file.sum | 	//  * file:./local/path/file.sum | ||||||
| 	//  * none | 	//  * none | ||||||
|  | |||||||
| @ -16,7 +16,7 @@ import ( | |||||||
| 
 | 
 | ||||||
| type ConfigParamsConfig struct { | type ConfigParamsConfig struct { | ||||||
| 	// configuration_parameters is a direct passthrough to the VSphere API's | 	// configuration_parameters is a direct passthrough to the VSphere API's | ||||||
| 	// ConfigSpec: https://pubs.vmware.com/vi3/sdk/ReferenceGuide/vim.vm.ConfigSpec.html | 	// ConfigSpec: https://www.vmware.com/support/developer/vc-sdk/visdk41pubs/ApiReference/vim.vm.ConfigSpec.html | ||||||
| 	ConfigParams map[string]string `mapstructure:"configuration_parameters"` | 	ConfigParams map[string]string `mapstructure:"configuration_parameters"` | ||||||
| 
 | 
 | ||||||
| 	// Enables time synchronization with the host. Defaults to false. | 	// Enables time synchronization with the host. Defaults to false. | ||||||
|  | |||||||
							
								
								
									
										24
									
								
								mlc_config.json
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										24
									
								
								mlc_config.json
									
									
									
									
									
										Normal file
									
								
							| @ -0,0 +1,24 @@ | |||||||
|  | { | ||||||
|  |    "ignorePatterns": [ | ||||||
|  |     { | ||||||
|  |       "pattern": "^https://example.com" | ||||||
|  |     }, | ||||||
|  |     { | ||||||
|  |       "pattern": "^https://ec2.custom.endpoint.com" | ||||||
|  |     }, | ||||||
|  |     { | ||||||
|  |       "pattern": "^https://www.linode.com" | ||||||
|  |     }, | ||||||
|  |     { | ||||||
|  |       "pattern": "^https://github.com/hashicorp/packer-plugin-scaffolding" | ||||||
|  |     } | ||||||
|  |   ], | ||||||
|  |   "replacementPatterns": [ | ||||||
|  |     { | ||||||
|  |       "pattern": "^/", | ||||||
|  |       "replacement": "https://packer.io/" | ||||||
|  |     } | ||||||
|  |   ], | ||||||
|  |   "timeout": "20s", | ||||||
|  |   "retryOn429": true | ||||||
|  | } | ||||||
							
								
								
									
										1
									
								
								website/.env.production
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										1
									
								
								website/.env.production
									
									
									
									
									
										Normal file
									
								
							| @ -0,0 +1 @@ | |||||||
|  | HASHI_ENV=production | ||||||
| @ -20,6 +20,7 @@ This subdirectory contains the entire source for the [Packer Website](https://pa | |||||||
| - [Editing Markdown Content](#editing-markdown-content) | - [Editing Markdown Content](#editing-markdown-content) | ||||||
| - [Editing Navigation Sidebars](#editing-navigation-sidebars) | - [Editing Navigation Sidebars](#editing-navigation-sidebars) | ||||||
| - [Changing the Release Version](#changing-the-release-version) | - [Changing the Release Version](#changing-the-release-version) | ||||||
|  | - [Link Validation](#link-validation) | ||||||
| - [Redirects](#redirects) | - [Redirects](#redirects) | ||||||
| - [Browser Support](#browser-support) | - [Browser Support](#browser-support) | ||||||
| - [Deployment](#deployment) | - [Deployment](#deployment) | ||||||
| @ -148,7 +149,7 @@ $ curl ... | |||||||
| </Tab> | </Tab> | ||||||
| </Tabs> | </Tabs> | ||||||
| 
 | 
 | ||||||
| Contined normal markdown content | Continued normal markdown content | ||||||
| ```` | ```` | ||||||
| 
 | 
 | ||||||
| The intentionally skipped line is a limitation of the mdx parser which is being actively worked on. All tabs must have a heading, and there is no limit to the number of tabs, though it is recommended to go for a maximum of three or four. | The intentionally skipped line is a limitation of the mdx parser which is being actively worked on. All tabs must have a heading, and there is no limit to the number of tabs, though it is recommended to go for a maximum of three or four. | ||||||
| @ -376,6 +377,16 @@ You may customize the parameters in any way you'd like. To remove a prerelease f | |||||||
| <!-- BEGIN: redirects --> | <!-- BEGIN: redirects --> | ||||||
| <!-- Generated text, do not edit directly --> | <!-- Generated text, do not edit directly --> | ||||||
| 
 | 
 | ||||||
|  | ## Link Validation | ||||||
|  | 
 | ||||||
|  | The Packer GitHub repository is configured to run a [Markdown Link Check](https://github.com/gaurav-nelson/github-action-markdown-link-check#github-action---markdown-link-check-%EF%B8%8F) on a nightly basis to check for potential broken links within the Packer documentation. There is also a GitHub action that will check any modified `.mdx` files on new pull-requests. | ||||||
|  | 
 | ||||||
|  | The master configuration file for the markdown-link-checker is called `mlc_config.json` and is located under the project's root directory. | ||||||
|  | The configuration helps with relative links in the documentation that will be valid once deployed, and configures a few ignored URLs which are valid but may not return a valid 200 HTTP response code due to permissions or DDoS protection settings on the domain. | ||||||
|  | 
 | ||||||
|  | **Potential False Positives** | ||||||
|  | The link checker will prepend the BASEURL `https://packer.io/` to any relative links found within the documentation, which can be an issue when adding new `/docs` or `/guides` documents as the pages have not been deployed. To help mitigate this issue check the site preview to ensure newly added documentation pages work as expected. | ||||||
|  | 
 | ||||||
| ## Redirects | ## Redirects | ||||||
| 
 | 
 | ||||||
| This website structures URLs based on the filesystem layout. This means that if a file is moved, removed, or a folder is re-organized, links will break. If a path change is necessary, it can be mitigated using redirects. | This website structures URLs based on the filesystem layout. This means that if a file is moved, removed, or a folder is re-organized, links will break. If a path change is necessary, it can be mitigated using redirects. | ||||||
|  | |||||||
| @ -132,11 +132,11 @@ build { | |||||||
| ~> Note: Since WinRM is closed by default in the system image. If you are | ~> Note: Since WinRM is closed by default in the system image. If you are | ||||||
| planning to use Windows as the base image, you need enable it by userdata in | planning to use Windows as the base image, you need enable it by userdata in | ||||||
| order to connect to the instance, check | order to connect to the instance, check | ||||||
| [alicloud_windows.json](https://github.com/hashicorp/packer/tree/master/examples/alicloud/basic/alicloud_windows.json) | [alicloud_windows.json](https://github.com/hashicorp/packer/tree/master/builder/alicloud/examples/basic/alicloud_windows.json) | ||||||
| and | and | ||||||
| [winrm_enable_userdata.ps1](https://github.com/hashicorp/packer/tree/master/examples/alicloud/basic/winrm_enable_userdata.ps1) | [winrm_enable_userdata.ps1](https://github.com/hashicorp/packer/tree/master/builder/alicloud/examples/basic/winrm_enable_userdata.ps1) | ||||||
| for details. | for details. | ||||||
| 
 | 
 | ||||||
| See the | See the | ||||||
| [examples/alicloud](https://github.com/hashicorp/packer/tree/master/examples/alicloud) | [examples/alicloud](https://github.com/hashicorp/packer/tree/master/builder/alicloud/examples) | ||||||
| folder in the packer project for more examples. | folder in the packer project for more examples. | ||||||
|  | |||||||
| @ -234,7 +234,7 @@ means executing sysprep, and for Linux this means executing the waagent | |||||||
| deprovision process. | deprovision process. | ||||||
| 
 | 
 | ||||||
| Please refer to the Azure | Please refer to the Azure | ||||||
| [examples](https://github.com/hashicorp/packer/tree/master/examples/azure) for | [examples](https://github.com/hashicorp/packer/tree/master/builder/azure/examples) for | ||||||
| complete examples showing the deprovision process. | complete examples showing the deprovision process. | ||||||
| 
 | 
 | ||||||
| ### Windows | ### Windows | ||||||
| @ -489,5 +489,5 @@ templates and deployments. The time required to deploy a KeyVault template is | |||||||
| minimal, so overall impact is small. | minimal, so overall impact is small. | ||||||
| 
 | 
 | ||||||
| See the | See the | ||||||
| [examples/azure](https://github.com/hashicorp/packer/tree/master/examples/azure) | [examples/azure](https://github.com/hashicorp/packer/tree/master/builder/azure/examples) | ||||||
| folder in the packer project for more examples. | folder in the packer project for more examples. | ||||||
|  | |||||||
| @ -85,4 +85,4 @@ Here is a basic example for JDCloud. | |||||||
| } | } | ||||||
| ``` | ``` | ||||||
| 
 | 
 | ||||||
| [Find more examples](https://github.com/hashicorp/packer/tree/master/examples/jdcloud) | [Find more examples](https://github.com/hashicorp/packer/tree/master/builder/jdcloud/examples) | ||||||
|  | |||||||
| @ -41,6 +41,12 @@ can also be supplied to override the typical auto-generated key: | |||||||
| 
 | 
 | ||||||
| @include 'packer-plugin-sdk/communicator/SSH-Private-Key-File-not-required.mdx' | @include 'packer-plugin-sdk/communicator/SSH-Private-Key-File-not-required.mdx' | ||||||
| 
 | 
 | ||||||
|  | <!-- | ||||||
|  |   Linode.com has DDOS protection that returns 403 for the markdown link checker | ||||||
|  |   so the domain has been added to the ignorepatterns in mlc_config.json | ||||||
|  | 
 | ||||||
|  |   See https://github.com/tcort/markdown-link-check/issues/109 | ||||||
|  | --> | ||||||
| ### Required | ### Required | ||||||
| 
 | 
 | ||||||
| - `linode_token` (string) - The client TOKEN to use to access your account. | - `linode_token` (string) - The client TOKEN to use to access your account. | ||||||
|  | |||||||
| @ -45,8 +45,10 @@ can also be supplied to override the typical auto-generated key: | |||||||
| - `retries` (number) - Number of retries Packer will make status requests | - `retries` (number) - Number of retries Packer will make status requests | ||||||
|   while waiting for the build to complete. Default value "600". |   while waiting for the build to complete. Default value "600". | ||||||
| 
 | 
 | ||||||
|  | <!-- markdown-link-check-disable --> | ||||||
| - `url` (string) - Endpoint for the 1&1 REST API. Default URL | - `url` (string) - Endpoint for the 1&1 REST API. Default URL | ||||||
|   "<https://cloudpanel-api.1and1.com/v1>" |   "<https://cloudpanel-api.1and1.com/v1>" | ||||||
|  | <!-- markdown-link-check-enable --> | ||||||
| 
 | 
 | ||||||
| ## Example | ## Example | ||||||
| 
 | 
 | ||||||
|  | |||||||
| @ -17,7 +17,7 @@ image, runs any provisioning necessary on the base image after launching it, | |||||||
| and finally snapshots it creating a reusable custom image. | and finally snapshots it creating a reusable custom image. | ||||||
| 
 | 
 | ||||||
| It is recommended that you familiarise yourself with the [Key Concepts and | It is recommended that you familiarise yourself with the [Key Concepts and | ||||||
| Terminology](https://docs.oracle.com/en/cloud/iaas/compute-iaas-cloud/stcsg/terminology.html) | Terminology](https://docs.oracle.com/en/cloud/iaas-classic/compute-iaas-cloud/stcsg/getting-started-oracle-compute-cloud-service.html#GUID-6CB9D494-4F3C-4B78-BD03-127983FEC357) | ||||||
| prior to using this builder if you have not done so already. | prior to using this builder if you have not done so already. | ||||||
| 
 | 
 | ||||||
| The builder _does not_ manage images. Once it creates an image, it is up to you | The builder _does not_ manage images. Once it creates an image, it is up to you | ||||||
| @ -52,7 +52,7 @@ builder. This builder currently only works with the SSH communicator. | |||||||
| 
 | 
 | ||||||
| - `source_image_list` (string) - This is what image you want to use as your | - `source_image_list` (string) - This is what image you want to use as your | ||||||
|   base image. See the |   base image. See the | ||||||
|   [documentation](https://docs.oracle.com/en/cloud/iaas/compute-iaas-cloud/stcsg/listing-machine-images.html) |   [documentation](https://docs.oracle.com/en/cloud/iaas-classic/compute-iaas-cloud/stcsg/managing-machine-images.html#GUID-652E6797-A5B8-40A7-860F-F27FF3E42471) | ||||||
|   for more details. You may use either a public image list, or a private |   for more details. You may use either a public image list, or a private | ||||||
|   image list. To see what public image lists are available, you can use the |   image list. To see what public image lists are available, you can use the | ||||||
|   CLI, as described |   CLI, as described | ||||||
| @ -66,7 +66,7 @@ builder. This builder currently only works with the SSH communicator. | |||||||
| - `shape` (string) - The template that determines the number of CPUs, amount | - `shape` (string) - The template that determines the number of CPUs, amount | ||||||
|   of memory, and other resources allocated to a newly created instance. For |   of memory, and other resources allocated to a newly created instance. For | ||||||
|   more information about shapes, see the documentation |   more information about shapes, see the documentation | ||||||
|   [here](https://docs.oracle.com/en/cloud/iaas/compute-iaas-cloud/stcsg/machine-images-and-shapes.html). |   [here](https://docs.oracle.com/en/cloud/iaas-classic/compute-iaas-cloud/stcsg/creating-instances.html#GUID-1DD0FA71-AC7B-461C-B8C1-14892725AA69). | ||||||
| 
 | 
 | ||||||
| - `username` (string) - Your account username. | - `username` (string) - Your account username. | ||||||
| 
 | 
 | ||||||
| @ -133,10 +133,6 @@ size of the original. We connect to this instance and copy the contents of the | |||||||
| first volume into a tarball file on the second volume. We then upload this file | first volume into a tarball file on the second volume. We then upload this file | ||||||
| to Object Storage Classic, and create a new machine image with it. | to Object Storage Classic, and create a new machine image with it. | ||||||
| 
 | 
 | ||||||
| For more details, see this [blog |  | ||||||
| post](https://blogs.oracle.com/cloudmarketplace/creating-an-oracle-compute-machine-image-from-an-instance-with-persistent-boot-storage), |  | ||||||
| which discusses the strategy used here. |  | ||||||
| 
 |  | ||||||
| If this is set, a few more options become available. | If this is set, a few more options become available. | ||||||
| 
 | 
 | ||||||
| - `builder_communicator` (communicator) - This represents an | - `builder_communicator` (communicator) - This represents an | ||||||
|  | |||||||
| @ -186,12 +186,14 @@ can also be supplied to override the typical auto-generated key: | |||||||
| - `use_private_ip` (boolean) - Use private ip addresses to connect to the | - `use_private_ip` (boolean) - Use private ip addresses to connect to the | ||||||
|   instance via ssh. |   instance via ssh. | ||||||
| 
 | 
 | ||||||
|  | <!-- markdown-link-check-disable --> | ||||||
| - `metadata` (map of strings) - Metadata optionally contains custom metadata | - `metadata` (map of strings) - Metadata optionally contains custom metadata | ||||||
|   key/value pairs provided in the configuration. While this can be used to |   key/value pairs provided in the configuration. While this can be used to | ||||||
|   set metadata\["user_data"\] the explicit "user_data" and |   set metadata\["user_data"\] the explicit "user_data" and | ||||||
|   "user_data_file" values will have precedence. An instance's metadata can |   "user_data_file" values will have precedence. An instance's metadata can | ||||||
|   be obtained from at [http://169.254.169.254](http://169.254.169.254) on |   be obtained from at [http://169.254.169.254](http://169.254.169.254) on | ||||||
|   the launched instance. |   the launched instance. | ||||||
|  | <!-- markdown-link-check-enable --> | ||||||
| 
 | 
 | ||||||
| - `user_data` (string) - User data to be used by cloud-init. See [the Oracle | - `user_data` (string) - User data to be used by cloud-init. See [the Oracle | ||||||
|   docs](https://docs.us-phoenix-1.oraclecloud.com/api/#/en/iaas/20160918/LaunchInstanceDetails) |   docs](https://docs.us-phoenix-1.oraclecloud.com/api/#/en/iaas/20160918/LaunchInstanceDetails) | ||||||
|  | |||||||
| @ -158,7 +158,7 @@ each category, the available configuration keys are alphabetized. | |||||||
|   when mounting devices. Each option will be prefixed with `-o` and supplied |   when mounting devices. Each option will be prefixed with `-o` and supplied | ||||||
|   to the `mount` command ran by Packer. Because this command is ran in a |   to the `mount` command ran by Packer. Because this command is ran in a | ||||||
|   shell, user discretion is advised. See [this manual page for the mount |   shell, user discretion is advised. See [this manual page for the mount | ||||||
|   command](http://linuxcommand.org/man_pages/mount8.html) for valid file |   command](https://linux.die.net/man/8/mount) for valid file | ||||||
|   system specific options. |   system specific options. | ||||||
| 
 | 
 | ||||||
| - `nvme_device_path` (string) - When we call the mount command (by default | - `nvme_device_path` (string) - When we call the mount command (by default | ||||||
|  | |||||||
| @ -105,13 +105,13 @@ export OUTSCALE_X509KEY="the/path/to/your/x509key" | |||||||
| ### Checking that system time is current | ### Checking that system time is current | ||||||
| 
 | 
 | ||||||
| Outscale uses the current time as part of the [request signing | Outscale uses the current time as part of the [request signing | ||||||
| process](http://docs.aws.osc.com/general/latest/gr/sigv4_signing.html). If | process](https://wiki.outscale.net/display/EN/About+Signatures+of+API+Requests). If | ||||||
| your system clock is too skewed from the current time, your requests might | your system clock is too skewed from the current time, your requests might | ||||||
| fail. If that's the case, you might see an error like this: | fail. If that's the case, you might see an error like this: | ||||||
| 
 | 
 | ||||||
|     ==> osc-bsu: Error querying OMI: AuthFailure: OUTSCALE was not able to validate the provided access credentials |     ==> osc-bsu: Error querying OMI: AuthFailure: OUTSCALE was not able to validate the provided access credentials | ||||||
| 
 | 
 | ||||||
| If you suspect your system's date is wrong, you can compare it against | If you suspect your system's date is wrong, you can compare it against | ||||||
| <http://www.time.gov/>. On Linux/OS X, you can run the `date` command to get | <https://www.time.gov/>. On Linux/OS X, you can run the `date` command to get | ||||||
| the current time. If you're on Linux, you can try setting the time with ntp by | the current time. If you're on Linux, you can try setting the time with ntp by | ||||||
| running `sudo ntpd -q`. | running `sudo ntpd -q`. | ||||||
|  | |||||||
| @ -60,9 +60,10 @@ can also be supplied to override the typical auto-generated key: | |||||||
|   generate it |   generate it | ||||||
| 
 | 
 | ||||||
| - `snapshot_password` (string) - Password for the snapshot. | - `snapshot_password` (string) - Password for the snapshot. | ||||||
| 
 | <!-- markdown-link-check-disable --> | ||||||
| - `url` (string) - Endpoint for the ProfitBricks REST API. Default URL | - `url` (string) - Endpoint for the ProfitBricks REST API. Default URL | ||||||
|   "<https://api.profitbricks.com/rest/v2>" |   "<https://api.profitbricks.com/rest/v2>" | ||||||
|  | <!-- markdown-link-check-enable --> | ||||||
| 
 | 
 | ||||||
| ## Example | ## Example | ||||||
| 
 | 
 | ||||||
|  | |||||||
| @ -212,6 +212,7 @@ builder. | |||||||
|   Defaults to `lsi`. |   Defaults to `lsi`. | ||||||
| 
 | 
 | ||||||
| - `cloud_init` (bool) - If true, add a Cloud-Init CDROM drive after the virtual machine has been converted to a template. | - `cloud_init` (bool) - If true, add a Cloud-Init CDROM drive after the virtual machine has been converted to a template. | ||||||
|  |    Defaults to `false`. | ||||||
| 
 | 
 | ||||||
| - `cloud_init_storage_pool` - (string) - Name of the Proxmox storage pool | - `cloud_init_storage_pool` - (string) - Name of the Proxmox storage pool | ||||||
|   to store the Cloud-Init CDROM on. If not given, the storage pool of the boot device will be used. |   to store the Cloud-Init CDROM on. If not given, the storage pool of the boot device will be used. | ||||||
|  | |||||||
| @ -182,5 +182,5 @@ Here is a basic example for Tencentcloud. | |||||||
| ``` | ``` | ||||||
| 
 | 
 | ||||||
| See the | See the | ||||||
| [examples/tencentcloud](https://github.com/hashicorp/packer/tree/master/examples/tencentcloud) | [examples/tencentcloud](https://github.com/hashicorp/packer/tree/master/builder/tencentcloud/examples) | ||||||
| folder in the packer project for more examples. | folder in the packer project for more examples. | ||||||
|  | |||||||
| @ -56,7 +56,7 @@ configuration, with later parameters overwriting any previous configuration. | |||||||
| The exact semantics of the merge are left to the builder author. | The exact semantics of the merge are left to the builder author. | ||||||
| 
 | 
 | ||||||
| For decoding the `interface{}` into a meaningful structure, the | For decoding the `interface{}` into a meaningful structure, the | ||||||
| [mapstructure](https://github.com/mitchellh/mapstructure) library is | [mapstructure](https://godoc.org/github.com/mitchellh/mapstructure) library is | ||||||
| recommended. Mapstructure will take an `interface{}` and decode it into an | recommended. Mapstructure will take an `interface{}` and decode it into an | ||||||
| arbitrarily complex struct. If there are any errors, it generates very human | arbitrarily complex struct. If there are any errors, it generates very human | ||||||
| friendly errors that can be returned directly from the prepare method. | friendly errors that can be returned directly from the prepare method. | ||||||
| @ -88,8 +88,8 @@ And `packer.Cache` is used to store files between multiple Packer runs, and is | |||||||
| covered in more detail in the cache section below. | covered in more detail in the cache section below. | ||||||
| 
 | 
 | ||||||
| Because builder runs are typically a complex set of many steps, the | Because builder runs are typically a complex set of many steps, the | ||||||
| [multistep](https://github.com/hashicorp/packer/blob/master/helper/multistep) | [multistep](https://godoc.org/github.com/hashicorp/packer-plugin-sdk/multistep) | ||||||
| helper is recommended to bring order to the complexity. Multistep is a library | package is recommended to bring order to the complexity. Multistep is a library | ||||||
| which allows you to separate your logic into multiple distinct "steps" and | which allows you to separate your logic into multiple distinct "steps" and | ||||||
| string them together. It fully supports cancellation mid-step and so on. Please | string them together. It fully supports cancellation mid-step and so on. Please | ||||||
| check it out, it is how the built-in builders are all implemented. | check it out, it is how the built-in builders are all implemented. | ||||||
| @ -137,7 +137,7 @@ about the artifact results, so it is important it never changes. | |||||||
| 
 | 
 | ||||||
| Other than the builder ID, the rest should be self-explanatory by reading the | Other than the builder ID, the rest should be self-explanatory by reading the | ||||||
| [packer.Artifact interface | [packer.Artifact interface | ||||||
| documentation](https://github.com/hashicorp/packer/blob/master/packer/artifact.go). | documentation](https://godoc.org/github.com/hashicorp/packer-plugin-sdk/packer#Artifact). | ||||||
| 
 | 
 | ||||||
| ## Provisioning | ## Provisioning | ||||||
| 
 | 
 | ||||||
|  | |||||||
| @ -101,7 +101,7 @@ some sort) or it may be remote (in a cloud). The communicator interface | |||||||
| abstracts this away so that communication is the same overall. | abstracts this away so that communication is the same overall. | ||||||
| 
 | 
 | ||||||
| The documentation around the [code | The documentation around the [code | ||||||
| itself](https://github.com/hashicorp/packer/blob/master/packer/communicator.go) | itself](https://godoc.org/github.com/hashicorp/packer-plugin-sdk/packer#Communicator) | ||||||
| is really great as an overview of how to use the interface. You should begin by | is really great as an overview of how to use the interface. You should begin by | ||||||
| reading this. Once you have read it, you can see some example usage below: | reading this. Once you have read it, you can see some example usage below: | ||||||
| 
 | 
 | ||||||
|  | |||||||
| @ -135,7 +135,7 @@ Packer makes one named values available. | |||||||
| The following named values are available: | The following named values are available: | ||||||
| 
 | 
 | ||||||
| - `source.<SOURCE TYPE>.<NAME>` is an object representing a | - `source.<SOURCE TYPE>.<NAME>` is an object representing a | ||||||
|   [source](/docs/from-1.5/sources) of the given type |   [source](/docs/from-1.5/blocks/source) of the given type | ||||||
|   and name. |   and name. | ||||||
| 
 | 
 | ||||||
| ### Available Functions | ### Available Functions | ||||||
|  | |||||||
| @ -388,7 +388,7 @@ class Connection(SSHConnection): | |||||||
| Newer versions of Ansible require all plugins to have a documentation string. | Newer versions of Ansible require all plugins to have a documentation string. | ||||||
| You can see if there is a plugin available for the version of Ansible you are | You can see if there is a plugin available for the version of Ansible you are | ||||||
| using | using | ||||||
| [here](https://github.com/hashicorp/packer/tree/master/examples/ansible/connection-plugin). | [here](https://github.com/hashicorp/packer/tree/master/provisioner/ansible/examples/connection-plugin). | ||||||
| 
 | 
 | ||||||
| To create the plugin yourself, you will need to copy all of the `options` from | To create the plugin yourself, you will need to copy all of the `options` from | ||||||
| the `DOCUMENTATION` string from the [ssh.py Ansible connection | the `DOCUMENTATION` string from the [ssh.py Ansible connection | ||||||
|  | |||||||
| @ -109,7 +109,7 @@ configuration is actually required. | |||||||
|   windows. |   windows. | ||||||
| 
 | 
 | ||||||
| - `run_list` (array of strings) - The [run | - `run_list` (array of strings) - The [run | ||||||
|   list](http://docs.chef.io/essentials_node_object_run_lists) for Chef. |   list](https://docs.chef.io/run_lists) for Chef. | ||||||
|   By default this is empty, and will use the run list sent down by the Chef |   By default this is empty, and will use the run list sent down by the Chef | ||||||
|   Server. |   Server. | ||||||
| 
 | 
 | ||||||
|  | |||||||
| @ -84,7 +84,7 @@ listed below: | |||||||
|   ``` |   ``` | ||||||
| 
 | 
 | ||||||
| * `facter` (object of key/value strings) - Additional | * `facter` (object of key/value strings) - Additional | ||||||
|   [facts](https://puppetlabs.com/facter) to make available to the Puppet run. |   [facts](https://puppet.com/docs/puppet/latest/facter.html) to make available to the Puppet run. | ||||||
| 
 | 
 | ||||||
| * `guest_os_type` (string) - The remote host's OS type ('windows' or 'unix') | * `guest_os_type` (string) - The remote host's OS type ('windows' or 'unix') | ||||||
|   to tailor command-line and path separators. (default: unix). |   to tailor command-line and path separators. (default: unix). | ||||||
|  | |||||||
| @ -15,7 +15,7 @@ | |||||||
| 
 | 
 | ||||||
| - `disable_stop_instance` (bool) - Packer normally stops the build instance after all provisioners have | - `disable_stop_instance` (bool) - Packer normally stops the build instance after all provisioners have | ||||||
|   run. For Windows instances, it is sometimes desirable to [run |   run. For Windows instances, it is sometimes desirable to [run | ||||||
|   Sysprep](http://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/ami-create-standard.html) |   Sysprep](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/Creating_EBSbacked_WinAMI.html) | ||||||
|   which will stop the instance for you. If this is set to `true`, Packer |   which will stop the instance for you. If this is set to `true`, Packer | ||||||
|   *will not* stop the instance but will assume that you will send the stop |   *will not* stop the instance but will assume that you will send the stop | ||||||
|   signal yourself through your final provisioner. You can do this with a |   signal yourself through your final provisioner. You can do this with a | ||||||
|  | |||||||
| @ -1,20 +1,20 @@ | |||||||
| <!-- Code generated from the comments of the Config struct in builder/azure/arm/config.go; DO NOT EDIT MANUALLY --> | <!-- Code generated from the comments of the Config struct in builder/azure/arm/config.go; DO NOT EDIT MANUALLY --> | ||||||
| 
 | 
 | ||||||
| - `image_publisher` (string) - Name of the publisher to use for your base image (Azure Marketplace Images only). See | - `image_publisher` (string) - Name of the publisher to use for your base image (Azure Marketplace Images only). See | ||||||
|   [documentation](https://azure.microsoft.com/en-us/documentation/articles/resource-groups-vm-searching/) |   [documentation](https://docs.microsoft.com/en-us/cli/azure/vm/image) | ||||||
|   for details. |   for details. | ||||||
|    |    | ||||||
|   CLI example `az vm image list-publishers --location westus` |   CLI example `az vm image list-publishers --location westus` | ||||||
| 
 | 
 | ||||||
| - `image_offer` (string) - Name of the publisher's offer to use for your base image (Azure Marketplace Images only). See | - `image_offer` (string) - Name of the publisher's offer to use for your base image (Azure Marketplace Images only). See | ||||||
|   [documentation](https://azure.microsoft.com/en-us/documentation/articles/resource-groups-vm-searching/) |   [documentation](https://docs.microsoft.com/en-us/cli/azure/vm/image) | ||||||
|   for details. |   for details. | ||||||
|    |    | ||||||
|   CLI example |   CLI example | ||||||
|   `az vm image list-offers --location westus --publisher Canonical` |   `az vm image list-offers --location westus --publisher Canonical` | ||||||
| 
 | 
 | ||||||
| - `image_sku` (string) - SKU of the image offer to use for your base image (Azure Marketplace Images only). See | - `image_sku` (string) - SKU of the image offer to use for your base image (Azure Marketplace Images only). See | ||||||
|   [documentation](https://azure.microsoft.com/en-us/documentation/articles/resource-groups-vm-searching/) |   [documentation](https://docs.microsoft.com/en-us/cli/azure/vm/image) | ||||||
|   for details. |   for details. | ||||||
|    |    | ||||||
|   CLI example |   CLI example | ||||||
|  | |||||||
| @ -46,20 +46,20 @@ | |||||||
|   minutes, and `h` for hours.) |   minutes, and `h` for hours.) | ||||||
| 
 | 
 | ||||||
| - `image_publisher` (string) - PublisherName for your base image. See | - `image_publisher` (string) - PublisherName for your base image. See | ||||||
|   [documentation](https://azure.microsoft.com/en-us/documentation/articles/resource-groups-vm-searching/) |   [documentation](https://docs.microsoft.com/en-us/cli/azure/vm/image) | ||||||
|   for details. |   for details. | ||||||
|    |    | ||||||
|   CLI example `az vm image list-publishers --location westus` |   CLI example `az vm image list-publishers --location westus` | ||||||
| 
 | 
 | ||||||
| - `image_offer` (string) - Offer for your base image. See | - `image_offer` (string) - Offer for your base image. See | ||||||
|   [documentation](https://azure.microsoft.com/en-us/documentation/articles/resource-groups-vm-searching/) |   [documentation](https://docs.microsoft.com/en-us/cli/azure/vm/image) | ||||||
|   for details. |   for details. | ||||||
|    |    | ||||||
|   CLI example |   CLI example | ||||||
|   `az vm image list-offers --location westus --publisher Canonical` |   `az vm image list-offers --location westus --publisher Canonical` | ||||||
| 
 | 
 | ||||||
| - `image_sku` (string) - SKU for your base image. See | - `image_sku` (string) - SKU for your base image. See | ||||||
|   [documentation](https://azure.microsoft.com/en-us/documentation/articles/resource-groups-vm-searching/) |   [documentation](https://docs.microsoft.com/en-us/cli/azure/vm/image) | ||||||
|   for details. |   for details. | ||||||
|    |    | ||||||
|   CLI example |   CLI example | ||||||
|  | |||||||
| @ -17,7 +17,7 @@ | |||||||
|    * ebfb681885ddf1234c18094a45bbeafd91467911 |    * ebfb681885ddf1234c18094a45bbeafd91467911 | ||||||
|    * sha256:ed363350696a726b7932db864dda019bd2017365c9e299627830f06954643f93 |    * sha256:ed363350696a726b7932db864dda019bd2017365c9e299627830f06954643f93 | ||||||
|    * ed363350696a726b7932db864dda019bd2017365c9e299627830f06954643f93 |    * ed363350696a726b7932db864dda019bd2017365c9e299627830f06954643f93 | ||||||
|    * file:http://releases.ubuntu.com/20.04/MD5SUMS |    * file:http://releases.ubuntu.com/20.04/SHA256SUMS | ||||||
|    * file:file://./local/path/file.sum |    * file:file://./local/path/file.sum | ||||||
|    * file:./local/path/file.sum |    * file:./local/path/file.sum | ||||||
|    * none |    * none | ||||||
|  | |||||||
| @ -13,7 +13,7 @@ | |||||||
|    * ebfb681885ddf1234c18094a45bbeafd91467911 |    * ebfb681885ddf1234c18094a45bbeafd91467911 | ||||||
|    * sha256:ed363350696a726b7932db864dda019bd2017365c9e299627830f06954643f93 |    * sha256:ed363350696a726b7932db864dda019bd2017365c9e299627830f06954643f93 | ||||||
|    * ed363350696a726b7932db864dda019bd2017365c9e299627830f06954643f93 |    * ed363350696a726b7932db864dda019bd2017365c9e299627830f06954643f93 | ||||||
|    * file:http://releases.ubuntu.com/20.04/MD5SUMS |    * file:http://releases.ubuntu.com/20.04/SHA256SUMS | ||||||
|    * file:file://./local/path/file.sum |    * file:file://./local/path/file.sum | ||||||
|    * file:./local/path/file.sum |    * file:./local/path/file.sum | ||||||
|    * none |    * none | ||||||
|  | |||||||
| @ -1,7 +1,7 @@ | |||||||
| <!-- Code generated from the comments of the ConfigParamsConfig struct in builder/vsphere/common/step_config_params.go; DO NOT EDIT MANUALLY --> | <!-- Code generated from the comments of the ConfigParamsConfig struct in builder/vsphere/common/step_config_params.go; DO NOT EDIT MANUALLY --> | ||||||
| 
 | 
 | ||||||
| - `configuration_parameters` (map[string]string) - configuration_parameters is a direct passthrough to the VSphere API's | - `configuration_parameters` (map[string]string) - configuration_parameters is a direct passthrough to the VSphere API's | ||||||
|   ConfigSpec: https://pubs.vmware.com/vi3/sdk/ReferenceGuide/vim.vm.ConfigSpec.html |   ConfigSpec: https://www.vmware.com/support/developer/vc-sdk/visdk41pubs/ApiReference/vim.vm.ConfigSpec.html | ||||||
| 
 | 
 | ||||||
| - `tools_sync_time` (bool) - Enables time synchronization with the host. Defaults to false. | - `tools_sync_time` (bool) - Enables time synchronization with the host. Defaults to false. | ||||||
| 
 | 
 | ||||||
|  | |||||||
| @ -1,4 +1,4 @@ | |||||||
| <!-- Code generated from the comments of the BootConfig struct in packer-plugin-sdk/bootcommand/config.go; DO NOT EDIT MANUALLY --> | <!-- Code generated from the comments of the BootConfig struct in bootcommand/config.go; DO NOT EDIT MANUALLY --> | ||||||
| 
 | 
 | ||||||
| - `boot_keygroup_interval` (duration string | ex: "1h5m2s") - Time to wait after sending a group of key pressses. The value of this | - `boot_keygroup_interval` (duration string | ex: "1h5m2s") - Time to wait after sending a group of key pressses. The value of this | ||||||
|   should be a duration. Examples are `5s` and `1m30s` which will cause |   should be a duration. Examples are `5s` and `1m30s` which will cause | ||||||
|  | |||||||
| @ -1,4 +1,4 @@ | |||||||
| <!-- Code generated from the comments of the BootConfig struct in packer-plugin-sdk/bootcommand/config.go; DO NOT EDIT MANUALLY --> | <!-- Code generated from the comments of the BootConfig struct in bootcommand/config.go; DO NOT EDIT MANUALLY --> | ||||||
| 
 | 
 | ||||||
| The boot configuration is very important: `boot_command` specifies the keys | The boot configuration is very important: `boot_command` specifies the keys | ||||||
| to type when the virtual machine is first booted in order to start the OS | to type when the virtual machine is first booted in order to start the OS | ||||||
| @ -11,62 +11,62 @@ sequence. It is an array only to improve readability within the template. | |||||||
| There are a set of special keys available. If these are in your boot | There are a set of special keys available. If these are in your boot | ||||||
| command, they will be replaced by the proper key: | command, they will be replaced by the proper key: | ||||||
| 
 | 
 | ||||||
| - `<bs>` - Backspace | -   `<bs>` - Backspace | ||||||
| 
 | 
 | ||||||
| - `<del>` - Delete | -   `<del>` - Delete | ||||||
| 
 | 
 | ||||||
| - `<enter> <return>` - Simulates an actual "enter" or "return" keypress. | -   `<enter> <return>` - Simulates an actual "enter" or "return" keypress. | ||||||
| 
 | 
 | ||||||
| - `<esc>` - Simulates pressing the escape key. | -   `<esc>` - Simulates pressing the escape key. | ||||||
| 
 | 
 | ||||||
| - `<tab>` - Simulates pressing the tab key. | -   `<tab>` - Simulates pressing the tab key. | ||||||
| 
 | 
 | ||||||
| - `<f1> - <f12>` - Simulates pressing a function key. | -   `<f1> - <f12>` - Simulates pressing a function key. | ||||||
| 
 | 
 | ||||||
| - `<up> <down> <left> <right>` - Simulates pressing an arrow key. | -   `<up> <down> <left> <right>` - Simulates pressing an arrow key. | ||||||
| 
 | 
 | ||||||
| - `<spacebar>` - Simulates pressing the spacebar. | -   `<spacebar>` - Simulates pressing the spacebar. | ||||||
| 
 | 
 | ||||||
| - `<insert>` - Simulates pressing the insert key. | -   `<insert>` - Simulates pressing the insert key. | ||||||
| 
 | 
 | ||||||
| - `<home> <end>` - Simulates pressing the home and end keys. | -   `<home> <end>` - Simulates pressing the home and end keys. | ||||||
| 
 | 
 | ||||||
| - `<pageUp> <pageDown>` - Simulates pressing the page up and page down | -   `<pageUp> <pageDown>` - Simulates pressing the page up and page down | ||||||
|   keys. |     keys. | ||||||
| 
 | 
 | ||||||
| - `<menu>` - Simulates pressing the Menu key. | -   `<menu>` - Simulates pressing the Menu key. | ||||||
| 
 | 
 | ||||||
| - `<leftAlt> <rightAlt>` - Simulates pressing the alt key. | -   `<leftAlt> <rightAlt>` - Simulates pressing the alt key. | ||||||
| 
 | 
 | ||||||
| - `<leftCtrl> <rightCtrl>` - Simulates pressing the ctrl key. | -   `<leftCtrl> <rightCtrl>` - Simulates pressing the ctrl key. | ||||||
| 
 | 
 | ||||||
| - `<leftShift> <rightShift>` - Simulates pressing the shift key. | -   `<leftShift> <rightShift>` - Simulates pressing the shift key. | ||||||
| 
 | 
 | ||||||
| - `<leftSuper> <rightSuper>` - Simulates pressing the ⌘ or Windows key. | -   `<leftSuper> <rightSuper>` - Simulates pressing the ⌘ or Windows key. | ||||||
| 
 | 
 | ||||||
| - `<wait> <wait5> <wait10>` - Adds a 1, 5 or 10 second pause before | -   `<wait> <wait5> <wait10>` - Adds a 1, 5 or 10 second pause before | ||||||
|   sending any additional keys. This is useful if you have to generally |     sending any additional keys. This is useful if you have to generally | ||||||
|   wait for the UI to update before typing more. |     wait for the UI to update before typing more. | ||||||
| 
 | 
 | ||||||
| - `<waitXX>` - Add an arbitrary pause before sending any additional keys. | -   `<waitXX>` - Add an arbitrary pause before sending any additional keys. | ||||||
|   The format of `XX` is a sequence of positive decimal numbers, each with |     The format of `XX` is a sequence of positive decimal numbers, each with | ||||||
|   optional fraction and a unit suffix, such as `300ms`, `1.5h` or `2h45m`. |     optional fraction and a unit suffix, such as `300ms`, `1.5h` or `2h45m`. | ||||||
|   Valid time units are `ns`, `us` (or `µs`), `ms`, `s`, `m`, `h`. For |     Valid time units are `ns`, `us` (or `µs`), `ms`, `s`, `m`, `h`. For | ||||||
|   example `<wait10m>` or `<wait1m20s>`. |     example `<wait10m>` or `<wait1m20s>`. | ||||||
| 
 | 
 | ||||||
| - `<XXXOn> <XXXOff>` - Any printable keyboard character, and of these | -   `<XXXOn> <XXXOff>` - Any printable keyboard character, and of these | ||||||
|   "special" expressions, with the exception of the `<wait>` types, can |      "special" expressions, with the exception of the `<wait>` types, can | ||||||
|   also be toggled on or off. For example, to simulate ctrl+c, use |      also be toggled on or off. For example, to simulate ctrl+c, use | ||||||
|   `<leftCtrlOn>c<leftCtrlOff>`. Be sure to release them, otherwise they |      `<leftCtrlOn>c<leftCtrlOff>`. Be sure to release them, otherwise they | ||||||
|   will be held down until the machine reboots. To hold the `c` key down, |      will be held down until the machine reboots. To hold the `c` key down, | ||||||
|   you would use `<cOn>`. Likewise, `<cOff>` to release. |      you would use `<cOn>`. Likewise, `<cOff>` to release. | ||||||
| 
 | 
 | ||||||
| - `{{ .HTTPIP }} {{ .HTTPPort }}` - The IP and port, respectively of an | -   `{{ .HTTPIP }} {{ .HTTPPort }}` - The IP and port, respectively of an | ||||||
|   HTTP server that is started serving the directory specified by the |     HTTP server that is started serving the directory specified by the | ||||||
|   `http_directory` configuration parameter. If `http_directory` isn't |     `http_directory` configuration parameter. If `http_directory` isn't | ||||||
|   specified, these will be blank! |     specified, these will be blank! | ||||||
| 
 | 
 | ||||||
| - `{{ .Name }}` - The name of the VM. | -   `{{ .Name }}` - The name of the VM. | ||||||
| 
 | 
 | ||||||
| Example boot command. This is actually a working boot command used to start an | Example boot command. This is actually a working boot command used to start an | ||||||
| CentOS 6.4 installer: | CentOS 6.4 installer: | ||||||
|  | |||||||
| @ -1,4 +1,4 @@ | |||||||
| <!-- Code generated from the comments of the VNCConfig struct in packer-plugin-sdk/bootcommand/config.go; DO NOT EDIT MANUALLY --> | <!-- Code generated from the comments of the VNCConfig struct in bootcommand/config.go; DO NOT EDIT MANUALLY --> | ||||||
| 
 | 
 | ||||||
| - `disable_vnc` (bool) - Whether to create a VNC connection or not. A boot_command cannot be used | - `disable_vnc` (bool) - Whether to create a VNC connection or not. A boot_command cannot be used | ||||||
|   when this is true. Defaults to false. |   when this is true. Defaults to false. | ||||||
|  | |||||||
| @ -1,4 +1,4 @@ | |||||||
| <!-- Code generated from the comments of the VNCConfig struct in packer-plugin-sdk/bootcommand/config.go; DO NOT EDIT MANUALLY --> | <!-- Code generated from the comments of the VNCConfig struct in bootcommand/config.go; DO NOT EDIT MANUALLY --> | ||||||
| 
 | 
 | ||||||
| The boot command "typed" character for character over a VNC connection to | The boot command "typed" character for character over a VNC connection to | ||||||
| the machine, simulating a human actually typing the keyboard. | the machine, simulating a human actually typing the keyboard. | ||||||
|  | |||||||
| @ -1,15 +1,15 @@ | |||||||
| <!-- Code generated from the comments of the Config struct in packer-plugin-sdk/communicator/config.go; DO NOT EDIT MANUALLY --> | <!-- Code generated from the comments of the Config struct in communicator/config.go; DO NOT EDIT MANUALLY --> | ||||||
| 
 | 
 | ||||||
| - `communicator` (string) - Packer currently supports three kinds of communicators: | - `communicator` (string) - Packer currently supports three kinds of communicators: | ||||||
| 
 |    | ||||||
|   - `none` - No communicator will be used. If this is set, most |   -   `none` - No communicator will be used. If this is set, most | ||||||
|     provisioners also can't be used. |       provisioners also can't be used. | ||||||
| 
 |    | ||||||
|   - `ssh` - An SSH connection will be established to the machine. This |   -   `ssh` - An SSH connection will be established to the machine. This | ||||||
|     is usually the default. |       is usually the default. | ||||||
| 
 |    | ||||||
|   - `winrm` - A WinRM connection will be established. |   -   `winrm` - A WinRM connection will be established. | ||||||
| 
 |    | ||||||
|   In addition to the above, some builders have custom communicators they |   In addition to the above, some builders have custom communicators they | ||||||
|   can use. For example, the Docker builder has a "docker" communicator |   can use. For example, the Docker builder has a "docker" communicator | ||||||
|   that uses `docker exec` and `docker cp` to execute scripts and copy |   that uses `docker exec` and `docker cp` to execute scripts and copy | ||||||
| @ -19,7 +19,7 @@ | |||||||
|   guest's bootstrap script, but sometimes you may have a race condition |   guest's bootstrap script, but sometimes you may have a race condition | ||||||
|   where you need Packer to wait before attempting to connect to your |   where you need Packer to wait before attempting to connect to your | ||||||
|   guest. |   guest. | ||||||
| 
 |    | ||||||
|   If you end up in this situation, you can use the template option |   If you end up in this situation, you can use the template option | ||||||
|   `pause_before_connecting`. By default, there is no pause. For example if |   `pause_before_connecting`. By default, there is no pause. For example if | ||||||
|   you set `pause_before_connecting` to `10m` Packer will check whether it |   you set `pause_before_connecting` to `10m` Packer will check whether it | ||||||
|  | |||||||
| @ -1,4 +1,5 @@ | |||||||
| <!-- Code generated from the comments of the Config struct in packer-plugin-sdk/communicator/config.go; DO NOT EDIT MANUALLY --> | <!-- Code generated from the comments of the Config struct in communicator/config.go; DO NOT EDIT MANUALLY --> | ||||||
| 
 | 
 | ||||||
| Config is the common configuration that communicators allow within | Config is the common configuration a builder uses to define and configure a Packer | ||||||
| a builder. | communicator. Embed this struct in your builder config to implement | ||||||
|  | communicator support. | ||||||
|  | |||||||
| @ -1,4 +1,4 @@ | |||||||
| <!-- Code generated from the comments of the SSH struct in packer-plugin-sdk/communicator/config.go; DO NOT EDIT MANUALLY --> | <!-- Code generated from the comments of the SSH struct in communicator/config.go; DO NOT EDIT MANUALLY --> | ||||||
| 
 | 
 | ||||||
| - `ssh_host` (string) - The address to SSH to. This usually is automatically configured by the | - `ssh_host` (string) - The address to SSH to. This usually is automatically configured by the | ||||||
|   builder. |   builder. | ||||||
| @ -11,11 +11,11 @@ | |||||||
| 
 | 
 | ||||||
| - `ssh_ciphers` ([]string) - This overrides the value of ciphers supported by default by golang. | - `ssh_ciphers` ([]string) - This overrides the value of ciphers supported by default by golang. | ||||||
|   The default value is [ |   The default value is [ | ||||||
|   "aes128-gcm@openssh.com", |     "aes128-gcm@openssh.com", | ||||||
|   "chacha20-poly1305@openssh.com", |     "chacha20-poly1305@openssh.com", | ||||||
|   "aes128-ctr", "aes192-ctr", "aes256-ctr", |     "aes128-ctr", "aes192-ctr", "aes256-ctr", | ||||||
|   ] |   ] | ||||||
| 
 |    | ||||||
|   Valid options for ciphers include: |   Valid options for ciphers include: | ||||||
|   "aes128-ctr", "aes192-ctr", "aes256-ctr", "aes128-gcm@openssh.com", |   "aes128-ctr", "aes192-ctr", "aes256-ctr", "aes128-gcm@openssh.com", | ||||||
|   "chacha20-poly1305@openssh.com", |   "chacha20-poly1305@openssh.com", | ||||||
| @ -89,6 +89,6 @@ | |||||||
|   useful if, for example, packer hangs on a connection after a reboot. |   useful if, for example, packer hangs on a connection after a reboot. | ||||||
|   Example: `5m`. Disabled by default. |   Example: `5m`. Disabled by default. | ||||||
| 
 | 
 | ||||||
| - `ssh_remote_tunnels` ([]string) - | - `ssh_remote_tunnels` ([]string) -  | ||||||
| 
 | 
 | ||||||
| - `ssh_local_tunnels` ([]string) - | - `ssh_local_tunnels` ([]string) -  | ||||||
|  | |||||||
| @ -1,4 +1,4 @@ | |||||||
| <!-- Code generated from the comments of the SSHInterface struct in packer-plugin-sdk/communicator/config.go; DO NOT EDIT MANUALLY --> | <!-- Code generated from the comments of the SSHInterface struct in communicator/config.go; DO NOT EDIT MANUALLY --> | ||||||
| 
 | 
 | ||||||
| - `ssh_interface` (string) - One of `public_ip`, `private_ip`, `public_dns`, or `private_dns`. If | - `ssh_interface` (string) - One of `public_ip`, `private_ip`, `public_dns`, or `private_dns`. If | ||||||
|   set, either the public IP address, private IP address, public DNS name |   set, either the public IP address, private IP address, public DNS name | ||||||
| @ -6,7 +6,7 @@ | |||||||
|   if inside a VPC is to use the public IP address if available, otherwise |   if inside a VPC is to use the public IP address if available, otherwise | ||||||
|   the private IP address will be used. If not in a VPC the public DNS name |   the private IP address will be used. If not in a VPC the public DNS name | ||||||
|   will be used. Also works for WinRM. |   will be used. Also works for WinRM. | ||||||
| 
 |    | ||||||
|   Where Packer is configured for an outbound proxy but WinRM traffic |   Where Packer is configured for an outbound proxy but WinRM traffic | ||||||
|   should be direct, `ssh_interface` must be set to `private_dns` and |   should be direct, `ssh_interface` must be set to `private_dns` and | ||||||
|   `<region>.compute.internal` included in the `NO_PROXY` environment |   `<region>.compute.internal` included in the `NO_PROXY` environment | ||||||
|  | |||||||
| @ -1,7 +1,7 @@ | |||||||
| <!-- Code generated from the comments of the SSHTemporaryKeyPair struct in packer-plugin-sdk/communicator/config.go; DO NOT EDIT MANUALLY --> | <!-- Code generated from the comments of the SSHTemporaryKeyPair struct in communicator/config.go; DO NOT EDIT MANUALLY --> | ||||||
| 
 | 
 | ||||||
| - `temporary_key_pair_type` (string) - `dsa` | `ecdsa` | `ed25519` | `rsa` ( the default ) | - `temporary_key_pair_type` (string) - `dsa` | `ecdsa` | `ed25519` | `rsa` ( the default ) | ||||||
| 
 |    | ||||||
|   Specifies the type of key to create. The possible values are 'dsa', |   Specifies the type of key to create. The possible values are 'dsa', | ||||||
|   'ecdsa', 'ed25519', or 'rsa'. |   'ecdsa', 'ed25519', or 'rsa'. | ||||||
| 
 | 
 | ||||||
|  | |||||||
| @ -1,4 +1,4 @@ | |||||||
| <!-- Code generated from the comments of the SSHTemporaryKeyPair struct in packer-plugin-sdk/communicator/config.go; DO NOT EDIT MANUALLY --> | <!-- Code generated from the comments of the SSHTemporaryKeyPair struct in communicator/config.go; DO NOT EDIT MANUALLY --> | ||||||
| 
 | 
 | ||||||
| When no ssh credentials are specified, Packer will generate a temporary SSH | When no ssh credentials are specified, Packer will generate a temporary SSH | ||||||
| keypair for the instance, you can change the algorithm type and bits | keypair for the instance, you can change the algorithm type and bits | ||||||
|  | |||||||
| @ -1,11 +1,11 @@ | |||||||
| <!-- Code generated from the comments of the WinRM struct in packer-plugin-sdk/communicator/config.go; DO NOT EDIT MANUALLY --> | <!-- Code generated from the comments of the WinRM struct in communicator/config.go; DO NOT EDIT MANUALLY --> | ||||||
| 
 | 
 | ||||||
| - `winrm_username` (string) - The username to use to connect to WinRM. | - `winrm_username` (string) - The username to use to connect to WinRM. | ||||||
| 
 | 
 | ||||||
| - `winrm_password` (string) - The password to use to connect to WinRM. | - `winrm_password` (string) - The password to use to connect to WinRM. | ||||||
| 
 | 
 | ||||||
| - `winrm_host` (string) - The address for WinRM to connect to. | - `winrm_host` (string) - The address for WinRM to connect to. | ||||||
| 
 |    | ||||||
|   NOTE: If using an Amazon EBS builder, you can specify the interface |   NOTE: If using an Amazon EBS builder, you can specify the interface | ||||||
|   WinRM connects to via |   WinRM connects to via | ||||||
|   [`ssh_interface`](/docs/builders/amazon-ebs#ssh_interface) |   [`ssh_interface`](/docs/builders/amazon-ebs#ssh_interface) | ||||||
| @ -30,4 +30,4 @@ | |||||||
|   for WinRM, rather than default (basic authentication), removing the |   for WinRM, rather than default (basic authentication), removing the | ||||||
|   requirement for basic authentication to be enabled within the target |   requirement for basic authentication to be enabled within the target | ||||||
|   guest. Further reading for remote connection authentication can be found |   guest. Further reading for remote connection authentication can be found | ||||||
|   [here](<https://msdn.microsoft.com/en-us/library/aa384295(v=vs.85).aspx>). |   [here](https://msdn.microsoft.com/en-us/library/aa384295(v=vs.85).aspx). | ||||||
|  | |||||||
| @ -1,47 +1,47 @@ | |||||||
| <!-- Code generated from the comments of the CDConfig struct in packer-plugin-sdk/multistep/commonsteps/extra_iso_config.go; DO NOT EDIT MANUALLY --> | <!-- Code generated from the comments of the CDConfig struct in multistep/commonsteps/extra_iso_config.go; DO NOT EDIT MANUALLY --> | ||||||
| 
 | 
 | ||||||
| - `cd_files` ([]string) - A list of files to place onto a CD that is attached when the VM is | - `cd_files` ([]string) - A list of files to place onto a CD that is attached when the VM is | ||||||
|   booted. This can include either files or directories; any directories |   booted. This can include either files or directories; any directories | ||||||
|   will be copied onto the CD recursively, preserving directory structure |   will be copied onto the CD recursively, preserving directory structure | ||||||
|   hierarchy. Symlinks will have the link's target copied into the directory |   hierarchy. Symlinks will have the link's target copied into the directory | ||||||
|   tree on the CD where the symlink was. File globbing is allowed. |   tree on the CD where the symlink was. File globbing is allowed. | ||||||
| 
 |    | ||||||
|   Usage example (JSON): |   Usage example (JSON): | ||||||
| 
 |    | ||||||
|   ```json |   ```json | ||||||
|   "cd_files": ["./somedirectory/meta-data", "./somedirectory/user-data"], |   "cd_files": ["./somedirectory/meta-data", "./somedirectory/user-data"], | ||||||
|   "cd_label": "cidata", |   "cd_label": "cidata", | ||||||
|   ``` |   ``` | ||||||
| 
 |    | ||||||
|   Usage example (HCL): |   Usage example (HCL): | ||||||
| 
 |    | ||||||
|   ```hcl |   ```hcl | ||||||
|   cd_files = ["./somedirectory/meta-data", "./somedirectory/user-data"] |   cd_files = ["./somedirectory/meta-data", "./somedirectory/user-data"] | ||||||
|   cd_label = "cidata" |   cd_label = "cidata" | ||||||
|   ``` |   ``` | ||||||
| 
 |    | ||||||
|   The above will create a CD with two files, user-data and meta-data in the |   The above will create a CD with two files, user-data and meta-data in the | ||||||
|   CD root. This specific example is how you would create a CD that can be |   CD root. This specific example is how you would create a CD that can be | ||||||
|   used for an Ubuntu 20.04 autoinstall. |   used for an Ubuntu 20.04 autoinstall. | ||||||
| 
 |    | ||||||
|   Since globbing is also supported, |   Since globbing is also supported, | ||||||
| 
 |    | ||||||
|   ```hcl |   ```hcl | ||||||
|   cd_files = ["./somedirectory/*"] |   cd_files = ["./somedirectory/*"] | ||||||
|   cd_label = "cidata" |   cd_label = "cidata" | ||||||
|   ``` |   ``` | ||||||
| 
 |    | ||||||
|   Would also be an acceptable way to define the above cd. The difference |   Would also be an acceptable way to define the above cd. The difference | ||||||
|   between providing the directory with or without the glob is whether the |   between providing the directory with or without the glob is whether the | ||||||
|   directory itself or its contents will be at the CD root. |   directory itself or its contents will be at the CD root. | ||||||
| 
 |    | ||||||
|   Use of this option assumes that you have a command line tool installed |   Use of this option assumes that you have a command line tool installed | ||||||
|   that can handle the iso creation. Packer will use one of the following |   that can handle the iso creation. Packer will use one of the following | ||||||
|   tools: |   tools: | ||||||
| 
 |    | ||||||
|   - xorriso |     * xorriso | ||||||
|   - mkisofs |     * mkisofs | ||||||
|   - hdiutil (normally found in macOS) |     * hdiutil (normally found in macOS) | ||||||
|   - oscdimg (normally found in Windows as part of the Windows ADK) |     * oscdimg (normally found in Windows as part of the Windows ADK) | ||||||
| 
 | 
 | ||||||
| - `cd_label` (string) - CD Label | - `cd_label` (string) - CD Label | ||||||
|  | |||||||
| @ -1,4 +1,4 @@ | |||||||
| <!-- Code generated from the comments of the CDConfig struct in packer-plugin-sdk/multistep/commonsteps/extra_iso_config.go; DO NOT EDIT MANUALLY --> | <!-- Code generated from the comments of the CDConfig struct in multistep/commonsteps/extra_iso_config.go; DO NOT EDIT MANUALLY --> | ||||||
| 
 | 
 | ||||||
| An iso (CD) containing custom files can be made available for your build. | An iso (CD) containing custom files can be made available for your build. | ||||||
| 
 | 
 | ||||||
|  | |||||||
| @ -1,8 +1,8 @@ | |||||||
| <!-- Code generated from the comments of the FloppyConfig struct in packer-plugin-sdk/multistep/commonsteps/floppy_config.go; DO NOT EDIT MANUALLY --> | <!-- Code generated from the comments of the FloppyConfig struct in multistep/commonsteps/floppy_config.go; DO NOT EDIT MANUALLY --> | ||||||
| 
 | 
 | ||||||
| - `floppy_files` ([]string) - A list of files to place onto a floppy disk that is attached when the VM | - `floppy_files` ([]string) - A list of files to place onto a floppy disk that is attached when the VM | ||||||
|   is booted. Currently, no support exists for creating sub-directories on |   is booted. Currently, no support exists for creating sub-directories on | ||||||
|   the floppy. Wildcard characters (\\\*, ?, and \[\]) are allowed. Directory |   the floppy. Wildcard characters (\\*, ?, and \[\]) are allowed. Directory | ||||||
|   names are also allowed, which will add all the files found in the |   names are also allowed, which will add all the files found in the | ||||||
|   directory to the floppy. |   directory to the floppy. | ||||||
| 
 | 
 | ||||||
| @ -10,7 +10,7 @@ | |||||||
|   similar to the `floppy_files` option except that the directory structure |   similar to the `floppy_files` option except that the directory structure | ||||||
|   is preserved. This is useful for when your floppy disk includes drivers |   is preserved. This is useful for when your floppy disk includes drivers | ||||||
|   or if you just want to organize it's contents as a hierarchy. Wildcard |   or if you just want to organize it's contents as a hierarchy. Wildcard | ||||||
|   characters (\\\*, ?, and \[\]) are allowed. The maximum summary size of |   characters (\\*, ?, and \[\]) are allowed. The maximum summary size of | ||||||
|   all files in the listed directories are the same as in `floppy_files`. |   all files in the listed directories are the same as in `floppy_files`. | ||||||
| 
 | 
 | ||||||
| - `floppy_label` (string) - Floppy Label | - `floppy_label` (string) - Floppy Label | ||||||
|  | |||||||
| @ -1,4 +1,4 @@ | |||||||
| <!-- Code generated from the comments of the FloppyConfig struct in packer-plugin-sdk/multistep/commonsteps/floppy_config.go; DO NOT EDIT MANUALLY --> | <!-- Code generated from the comments of the FloppyConfig struct in multistep/commonsteps/floppy_config.go; DO NOT EDIT MANUALLY --> | ||||||
| 
 | 
 | ||||||
| A floppy can be made available for your build. This is most useful for | A floppy can be made available for your build. This is most useful for | ||||||
| unattended Windows installs, which look for an Autounattend.xml file on | unattended Windows installs, which look for an Autounattend.xml file on | ||||||
|  | |||||||
| @ -1,4 +1,4 @@ | |||||||
| <!-- Code generated from the comments of the HTTPConfig struct in packer-plugin-sdk/multistep/commonsteps/http_config.go; DO NOT EDIT MANUALLY --> | <!-- Code generated from the comments of the HTTPConfig struct in multistep/commonsteps/http_config.go; DO NOT EDIT MANUALLY --> | ||||||
| 
 | 
 | ||||||
| - `http_directory` (string) - Path to a directory to serve using an HTTP server. The files in this | - `http_directory` (string) - Path to a directory to serve using an HTTP server. The files in this | ||||||
|   directory will be available over HTTP that will be requestable from the |   directory will be available over HTTP that will be requestable from the | ||||||
|  | |||||||
| @ -1,4 +1,4 @@ | |||||||
| <!-- Code generated from the comments of the HTTPConfig struct in packer-plugin-sdk/multistep/commonsteps/http_config.go; DO NOT EDIT MANUALLY --> | <!-- Code generated from the comments of the HTTPConfig struct in multistep/commonsteps/http_config.go; DO NOT EDIT MANUALLY --> | ||||||
| 
 | 
 | ||||||
| Packer will create an http server serving `http_directory` when it is set, a | Packer will create an http server serving `http_directory` when it is set, a | ||||||
| random free port will be selected and the architecture of the directory | random free port will be selected and the architecture of the directory | ||||||
| @ -6,4 +6,4 @@ referenced will be available in your builder. | |||||||
| 
 | 
 | ||||||
| Example usage from a builder: | Example usage from a builder: | ||||||
| 
 | 
 | ||||||
| `wget http://{{ .HTTPIP }}:{{ .HTTPPort }}/foo/bar/preseed.cfg` |   `wget http://{{ .HTTPIP }}:{{ .HTTPPort }}/foo/bar/preseed.cfg` | ||||||
|  | |||||||
| @ -1,4 +1,4 @@ | |||||||
| <!-- Code generated from the comments of the ISOConfig struct in packer-plugin-sdk/multistep/commonsteps/iso_config.go; DO NOT EDIT MANUALLY --> | <!-- Code generated from the comments of the ISOConfig struct in multistep/commonsteps/iso_config.go; DO NOT EDIT MANUALLY --> | ||||||
| 
 | 
 | ||||||
| - `iso_urls` ([]string) - Multiple URLs for the ISO to download. Packer will try these in order. | - `iso_urls` ([]string) - Multiple URLs for the ISO to download. Packer will try these in order. | ||||||
|   If anything goes wrong attempting to download or while downloading a |   If anything goes wrong attempting to download or while downloading a | ||||||
|  | |||||||
| @ -1,4 +1,4 @@ | |||||||
| <!-- Code generated from the comments of the ISOConfig struct in packer-plugin-sdk/multistep/commonsteps/iso_config.go; DO NOT EDIT MANUALLY --> | <!-- Code generated from the comments of the ISOConfig struct in multistep/commonsteps/iso_config.go; DO NOT EDIT MANUALLY --> | ||||||
| 
 | 
 | ||||||
| - `iso_checksum` (string) - The checksum for the ISO file or virtual hard drive file. The type of | - `iso_checksum` (string) - The checksum for the ISO file or virtual hard drive file. The type of | ||||||
|   the checksum is specified within the checksum field as a prefix, ex: |   the checksum is specified within the checksum field as a prefix, ex: | ||||||
| @ -7,20 +7,19 @@ | |||||||
|   "none", "{$checksum}", "md5:{$checksum}", "sha1:{$checksum}", |   "none", "{$checksum}", "md5:{$checksum}", "sha1:{$checksum}", | ||||||
|   "sha256:{$checksum}", "sha512:{$checksum}" or "file:{$path}". Here is a |   "sha256:{$checksum}", "sha512:{$checksum}" or "file:{$path}". Here is a | ||||||
|   list of valid checksum values: |   list of valid checksum values: | ||||||
| 
 |    * md5:090992ba9fd140077b0661cb75f7ce13 | ||||||
|   - md5:090992ba9fd140077b0661cb75f7ce13 |    * 090992ba9fd140077b0661cb75f7ce13 | ||||||
|   - 090992ba9fd140077b0661cb75f7ce13 |    * sha1:ebfb681885ddf1234c18094a45bbeafd91467911 | ||||||
|   - sha1:ebfb681885ddf1234c18094a45bbeafd91467911 |    * ebfb681885ddf1234c18094a45bbeafd91467911 | ||||||
|   - ebfb681885ddf1234c18094a45bbeafd91467911 |    * sha256:ed363350696a726b7932db864dda019bd2017365c9e299627830f06954643f93 | ||||||
|   - sha256:ed363350696a726b7932db864dda019bd2017365c9e299627830f06954643f93 |    * ed363350696a726b7932db864dda019bd2017365c9e299627830f06954643f93 | ||||||
|   - ed363350696a726b7932db864dda019bd2017365c9e299627830f06954643f93 |    * file:http://releases.ubuntu.com/20.04/SHA256SUMS | ||||||
|   - file:http://releases.ubuntu.com/20.04/MD5SUMS |    * file:file://./local/path/file.sum | ||||||
|   - file:file://./local/path/file.sum |    * file:./local/path/file.sum | ||||||
|   - file:./local/path/file.sum |    * none | ||||||
|   - none |   Although the checksum will not be verified when it is set to "none", | ||||||
|     Although the checksum will not be verified when it is set to "none", |   this is not recommended since these files can be very large and | ||||||
|     this is not recommended since these files can be very large and |   corruption does happen from time to time. | ||||||
|     corruption does happen from time to time. |  | ||||||
| 
 | 
 | ||||||
| - `iso_url` (string) - A URL to the ISO containing the installation image or virtual hard drive | - `iso_url` (string) - A URL to the ISO containing the installation image or virtual hard drive | ||||||
|   (VHD or VHDX) file to clone. |   (VHD or VHDX) file to clone. | ||||||
|  | |||||||
| @ -1,4 +1,4 @@ | |||||||
| <!-- Code generated from the comments of the ISOConfig struct in packer-plugin-sdk/multistep/commonsteps/iso_config.go; DO NOT EDIT MANUALLY --> | <!-- Code generated from the comments of the ISOConfig struct in multistep/commonsteps/iso_config.go; DO NOT EDIT MANUALLY --> | ||||||
| 
 | 
 | ||||||
| By default, Packer will symlink, download or copy image files to the Packer | By default, Packer will symlink, download or copy image files to the Packer | ||||||
| cache into a "`hash($iso_url+$iso_checksum).$iso_target_extension`" file. | cache into a "`hash($iso_url+$iso_checksum).$iso_target_extension`" file. | ||||||
| @ -7,11 +7,11 @@ file mode in order to perform a download. | |||||||
| 
 | 
 | ||||||
| go-getter supports the following protocols: | go-getter supports the following protocols: | ||||||
| 
 | 
 | ||||||
| - Local files | * Local files | ||||||
| - Git | * Git | ||||||
| - Mercurial | * Mercurial | ||||||
| - HTTP | * HTTP | ||||||
| - Amazon S3 | * Amazon S3 | ||||||
| 
 | 
 | ||||||
| Examples: | Examples: | ||||||
| go-getter can guess the checksum type based on `iso_checksum` length, and it is | go-getter can guess the checksum type based on `iso_checksum` length, and it is | ||||||
|  | |||||||
| @ -1,4 +1,4 @@ | |||||||
| <!-- Code generated from the comments of the ShutdownConfig struct in packer-plugin-sdk/shutdowncommand/config.go; DO NOT EDIT MANUALLY --> | <!-- Code generated from the comments of the ShutdownConfig struct in shutdowncommand/config.go; DO NOT EDIT MANUALLY --> | ||||||
| 
 | 
 | ||||||
| - `shutdown_command` (string) - The command to use to gracefully shut down the machine once all | - `shutdown_command` (string) - The command to use to gracefully shut down the machine once all | ||||||
|   provisioning is complete. By default this is an empty string, which |   provisioning is complete. By default this is an empty string, which | ||||||
|  | |||||||
| @ -1,7 +1,8 @@ | |||||||
| <!-- Code generated from the comments of the ShutdownConfig struct in packer-plugin-sdk/shutdowncommand/config.go; DO NOT EDIT MANUALLY --> | <!-- Code generated from the comments of the ShutdownConfig struct in shutdowncommand/config.go; DO NOT EDIT MANUALLY --> | ||||||
| 
 | 
 | ||||||
| ShutdownConfig defines implementation details for shutting down a VM once it | ShutdownConfig defines implementation details for shutting down a VM once it | ||||||
| is done provisioned. | is done being provisioned. | ||||||
|  | 
 | ||||||
| It is provided as a convenience to encourage builder developers to | It is provided as a convenience to encourage builder developers to | ||||||
| consider implementing these options, which we believe are valuable for all | consider implementing these options, which we believe are valuable for all | ||||||
| builders. It also helps guarantee that option names for similar options | builders. It also helps guarantee that option names for similar options | ||||||
|  | |||||||
| @ -1,5 +1,6 @@ | |||||||
| const withHashicorp = require('@hashicorp/nextjs-scripts') | const withHashicorp = require('@hashicorp/nextjs-scripts') | ||||||
| const path = require('path') | const path = require('path') | ||||||
|  | const redirects = require('./redirects.next') | ||||||
| 
 | 
 | ||||||
| module.exports = withHashicorp({ | module.exports = withHashicorp({ | ||||||
|   defaultLayout: true, |   defaultLayout: true, | ||||||
| @ -13,6 +14,7 @@ module.exports = withHashicorp({ | |||||||
|       destination: '/api-docs/:path*', |       destination: '/api-docs/:path*', | ||||||
|     }, |     }, | ||||||
|   ], |   ], | ||||||
|  |   redirects: () => redirects, | ||||||
|   // Note: These are meant to be public, it's not a mistake that they are here
 |   // Note: These are meant to be public, it's not a mistake that they are here
 | ||||||
|   env: { |   env: { | ||||||
|     HASHI_ENV: process.env.HASHI_ENV, |     HASHI_ENV: process.env.HASHI_ENV, | ||||||
|  | |||||||
							
								
								
									
										4206
									
								
								website/package-lock.json
									
									
									
										generated
									
									
									
								
							
							
						
						
									
										4206
									
								
								website/package-lock.json
									
									
									
										generated
									
									
									
								
							
										
											
												File diff suppressed because it is too large
												Load Diff
											
										
									
								
							| @ -5,10 +5,10 @@ | |||||||
|   "author": "HashiCorp", |   "author": "HashiCorp", | ||||||
|   "dependencies": { |   "dependencies": { | ||||||
|     "@hashicorp/mktg-global-styles": "2.1.0", |     "@hashicorp/mktg-global-styles": "2.1.0", | ||||||
|     "@hashicorp/nextjs-scripts": "13.0.0-canary.1", |     "@hashicorp/nextjs-scripts": "16.0.1", | ||||||
|     "@hashicorp/react-button": "4.0.0", |     "@hashicorp/react-button": "4.0.0", | ||||||
|     "@hashicorp/react-docs-page": "^10.3.2", |     "@hashicorp/react-docs-page": "^10.3.2", | ||||||
|     "@hashicorp/react-hashi-stack-menu": "^1.0.11", |     "@hashicorp/react-hashi-stack-menu": "^1.1.0", | ||||||
|     "@hashicorp/react-head": "1.1.6", |     "@hashicorp/react-head": "1.1.6", | ||||||
|     "@hashicorp/react-markdown-page": "^0.1.0", |     "@hashicorp/react-markdown-page": "^0.1.0", | ||||||
|     "@hashicorp/react-product-downloader": "4.0.2", |     "@hashicorp/react-product-downloader": "4.0.2", | ||||||
| @ -16,7 +16,7 @@ | |||||||
|     "@hashicorp/react-section-header": "3.0.1", |     "@hashicorp/react-section-header": "3.0.1", | ||||||
|     "@hashicorp/react-subnav": "7.1.0", |     "@hashicorp/react-subnav": "7.1.0", | ||||||
|     "@hashicorp/react-vertical-text-block-list": "3.0.1", |     "@hashicorp/react-vertical-text-block-list": "3.0.1", | ||||||
|     "next": "9.5.5", |     "next": "10.0.6", | ||||||
|     "next-mdx-remote": "1.0.1", |     "next-mdx-remote": "1.0.1", | ||||||
|     "next-remote-watch": "0.3.0", |     "next-remote-watch": "0.3.0", | ||||||
|     "react": "16.13.1", |     "react": "16.13.1", | ||||||
|  | |||||||
| @ -15,6 +15,7 @@ export default function DocsLayout(props) { | |||||||
|       subpath={subpath} |       subpath={subpath} | ||||||
|       order={order} |       order={order} | ||||||
|       staticProps={props} |       staticProps={props} | ||||||
|  |       mainBranch="master" | ||||||
|     /> |     /> | ||||||
|   ) |   ) | ||||||
| } | } | ||||||
|  | |||||||
| @ -15,6 +15,7 @@ export default function GuidesLayout(props) { | |||||||
|       subpath={subpath} |       subpath={subpath} | ||||||
|       order={order} |       order={order} | ||||||
|       staticProps={props} |       staticProps={props} | ||||||
|  |       mainBranch="master" | ||||||
|     /> |     /> | ||||||
|   ) |   ) | ||||||
| } | } | ||||||
|  | |||||||
| @ -15,6 +15,7 @@ export default function IntroLayout(props) { | |||||||
|       subpath={subpath} |       subpath={subpath} | ||||||
|       order={order} |       order={order} | ||||||
|       staticProps={props} |       staticProps={props} | ||||||
|  |       mainBranch="master" | ||||||
|     /> |     /> | ||||||
|   ) |   ) | ||||||
| } | } | ||||||
|  | |||||||
| @ -9,7 +9,7 @@ | |||||||
| } | } | ||||||
| 
 | 
 | ||||||
| @import '~@hashicorp/react-button/styles/index.css'; | @import '~@hashicorp/react-button/styles/index.css'; | ||||||
| @import '~@hashicorp/react-consent-manager/dist/style.css'; | @import '~@hashicorp/react-consent-manager/style.css'; | ||||||
| @import '~@hashicorp/react-content/style.css'; | @import '~@hashicorp/react-content/style.css'; | ||||||
| @import '~@hashicorp/react-docs-page/style.css'; | @import '~@hashicorp/react-docs-page/style.css'; | ||||||
| @import '~@hashicorp/react-docs-sidenav/style.css'; | @import '~@hashicorp/react-docs-sidenav/style.css'; | ||||||
| @ -17,8 +17,8 @@ | |||||||
| @import '~@hashicorp/react-search/style.css'; | @import '~@hashicorp/react-search/style.css'; | ||||||
| @import '~@hashicorp/react-section-header/style.css'; | @import '~@hashicorp/react-section-header/style.css'; | ||||||
| @import '~@hashicorp/react-subnav/style.css'; | @import '~@hashicorp/react-subnav/style.css'; | ||||||
| @import '~@hashicorp/react-tabs/dist/style.css'; | @import '~@hashicorp/react-tabs/style.css'; | ||||||
| @import '~@hashicorp/react-toggle/dist/style.css'; | @import '~@hashicorp/react-toggle/style.css'; | ||||||
| @import '~@hashicorp/react-vertical-text-block-list/style.css'; | @import '~@hashicorp/react-vertical-text-block-list/style.css'; | ||||||
| 
 | 
 | ||||||
| /* Local Components */ | /* Local Components */ | ||||||
|  | |||||||
							
								
								
									
										197
									
								
								website/redirects.next.js
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										197
									
								
								website/redirects.next.js
									
									
									
									
									
										Normal file
									
								
							| @ -0,0 +1,197 @@ | |||||||
|  | module.exports = [ | ||||||
|  |   { | ||||||
|  |     source: '/docs/installation', | ||||||
|  |     destination: '/docs/install', | ||||||
|  |     permanent: true, | ||||||
|  |   }, | ||||||
|  |   { | ||||||
|  |     source: '/docs/command-line/machine-readable', | ||||||
|  |     destination: '/docs/commands', | ||||||
|  |     permanent: true, | ||||||
|  |   }, | ||||||
|  |   { | ||||||
|  |     source: '/docs/command-line/introduction', | ||||||
|  |     destination: '/docs/commands', | ||||||
|  |     permanent: true, | ||||||
|  |   }, | ||||||
|  |   { | ||||||
|  |     source: '/docs/templates/introduction', | ||||||
|  |     destination: '/docs/templates', | ||||||
|  |     permanent: true, | ||||||
|  |   }, | ||||||
|  |   { | ||||||
|  |     source: '/docs/builders/azure-setup', | ||||||
|  |     destination: '/docs/builders/azure', | ||||||
|  |     permanent: true, | ||||||
|  |   }, | ||||||
|  |   { | ||||||
|  |     source: '/docs/templates/veewee-to-packer', | ||||||
|  |     destination: '/guides/veewee-to-packer', | ||||||
|  |     permanent: true, | ||||||
|  |   }, | ||||||
|  |   { | ||||||
|  |     source: '/docs/extend/developing-plugins', | ||||||
|  |     destination: '/docs/extending/plugins', | ||||||
|  |     permanent: true, | ||||||
|  |   }, | ||||||
|  |   { | ||||||
|  |     source: '/docs/extending/developing-plugins', | ||||||
|  |     destination: '/docs/extending/plugins', | ||||||
|  |     permanent: true, | ||||||
|  |   }, | ||||||
|  |   { | ||||||
|  |     source: '/docs/extend/builder', | ||||||
|  |     destination: '/docs/extending/custom-builders', | ||||||
|  |     permanent: true, | ||||||
|  |   }, | ||||||
|  |   { | ||||||
|  |     source: '/docs/getting-started/setup', | ||||||
|  |     destination: '/docs/getting-started/install', | ||||||
|  |     permanent: true, | ||||||
|  |   }, | ||||||
|  |   { | ||||||
|  |     source: '/docs/other/community', | ||||||
|  |     destination: '/community-tools', | ||||||
|  |     permanent: true, | ||||||
|  |   }, | ||||||
|  |   { | ||||||
|  |     source: '/downloads-community', | ||||||
|  |     destination: '/community-tools', | ||||||
|  |     permanent: true, | ||||||
|  |   }, | ||||||
|  |   { | ||||||
|  |     source: '/docs/platforms', | ||||||
|  |     destination: '/docs/builders', | ||||||
|  |     permanent: true, | ||||||
|  |   }, | ||||||
|  |   { | ||||||
|  |     source: '/intro/platforms', | ||||||
|  |     destination: '/docs/builders', | ||||||
|  |     permanent: true, | ||||||
|  |   }, | ||||||
|  |   { | ||||||
|  |     source: '/docs/templates/configuration-templates', | ||||||
|  |     destination: '/docs/templates/engine', | ||||||
|  |     permanent: true, | ||||||
|  |   }, | ||||||
|  |   { | ||||||
|  |     source: '/docs/machine-readable/:path*', | ||||||
|  |     destination: '/docs/commands', | ||||||
|  |     permanent: true, | ||||||
|  |   }, | ||||||
|  |   { | ||||||
|  |     source: '/docs/command-line/:path*', | ||||||
|  |     destination: '/docs/commands/:path*', | ||||||
|  |     permanent: true, | ||||||
|  |   }, | ||||||
|  |   { | ||||||
|  |     source: '/docs/extend/:path*', | ||||||
|  |     destination: '/docs/extending/:path*', | ||||||
|  |     permanent: true, | ||||||
|  |   }, | ||||||
|  |   { | ||||||
|  |     source: '/intro/getting-started', | ||||||
|  |     destination: 'https://learn.hashicorp.com/packer/getting-started/install', | ||||||
|  |     permanent: true, | ||||||
|  |   }, | ||||||
|  |   { | ||||||
|  |     source: '/intro/getting-started/install', | ||||||
|  |     destination: 'https://learn.hashicorp.com/packer/getting-started/install', | ||||||
|  |     permanent: true, | ||||||
|  |   }, | ||||||
|  |   { | ||||||
|  |     source: '/intro/getting-started/build-image', | ||||||
|  |     destination: | ||||||
|  |       'https://learn.hashicorp.com/packer/getting-started/build-image', | ||||||
|  |     permanent: true, | ||||||
|  |   }, | ||||||
|  |   { | ||||||
|  |     source: '/intro/getting-started/provision', | ||||||
|  |     destination: 'https://learn.hashicorp.com/packer/getting-started/provision', | ||||||
|  |     permanent: true, | ||||||
|  |   }, | ||||||
|  |   { | ||||||
|  |     source: '/intro/getting-started/parallel-builds', | ||||||
|  |     destination: | ||||||
|  |       'https://learn.hashicorp.com/packer/getting-started/parallel-builds', | ||||||
|  |     permanent: true, | ||||||
|  |   }, | ||||||
|  |   { | ||||||
|  |     source: '/intro/getting-started/vagrant', | ||||||
|  |     destination: 'https://learn.hashicorp.com/packer/getting-started/vagrant', | ||||||
|  |     permanent: true, | ||||||
|  |   }, | ||||||
|  |   { | ||||||
|  |     source: '/intro/getting-started/next', | ||||||
|  |     destination: 'https://learn.hashicorp.com/packer/getting-started/next   ', | ||||||
|  |     permanent: true, | ||||||
|  |   }, | ||||||
|  |   { | ||||||
|  |     source: '/docs/basics/terminology', | ||||||
|  |     destination: '/docs/terminology', | ||||||
|  |     permanent: true, | ||||||
|  |   }, | ||||||
|  |   { | ||||||
|  |     source: '/docs/other/:path*', | ||||||
|  |     destination: '/docs/:path*', | ||||||
|  |     permanent: true, | ||||||
|  |   }, | ||||||
|  |   { | ||||||
|  |     source: '/docs/configuration/from-1.5/:path*', | ||||||
|  |     destination: '/docs/from-1.5/:path*', | ||||||
|  |     permanent: true, | ||||||
|  |   }, | ||||||
|  |   { | ||||||
|  |     source: '/docs/configuration/from-1.5/:path*/overview', | ||||||
|  |     destination: '/docs/from-1.5/:path*', | ||||||
|  |     permanent: true, | ||||||
|  |   }, | ||||||
|  |   { | ||||||
|  |     source: '/docs/builders/amazon-:path', | ||||||
|  |     destination: '/docs/builders/amazon/:path*', | ||||||
|  |     permanent: true, | ||||||
|  |   }, | ||||||
|  |   { | ||||||
|  |     source: '/docs/builders/azure-:path', | ||||||
|  |     destination: '/docs/builders/azure/:path*', | ||||||
|  |     permanent: true, | ||||||
|  |   }, | ||||||
|  |   { | ||||||
|  |     source: '/docs/builders/hyperv-:path', | ||||||
|  |     destination: '/docs/builders/hyperv/:path*', | ||||||
|  |     permanent: true, | ||||||
|  |   }, | ||||||
|  |   { | ||||||
|  |     source: '/docs/builders/oracle-:path', | ||||||
|  |     destination: '/docs/builders/oracle/:path*', | ||||||
|  |     permanent: true, | ||||||
|  |   }, | ||||||
|  |   { | ||||||
|  |     source: '/docs/builders/osc-:path', | ||||||
|  |     destination: '/docs/builders/outscale/:path*', | ||||||
|  |     permanent: true, | ||||||
|  |   }, | ||||||
|  |   { | ||||||
|  |     source: '/docs/builders/parallels-:path', | ||||||
|  |     destination: '/docs/builders/parallels/:path*', | ||||||
|  |     permanent: true, | ||||||
|  |   }, | ||||||
|  |   { | ||||||
|  |     source: '/docs/builders/virtualbox-:path', | ||||||
|  |     destination: '/docs/builders/virtualbox/:path*', | ||||||
|  |     permanent: true, | ||||||
|  |   }, | ||||||
|  |   { | ||||||
|  |     source: '/docs/builders/vmware-:path', | ||||||
|  |     destination: '/docs/builders/vmware/:path*', | ||||||
|  |     permanent: true, | ||||||
|  |   }, | ||||||
|  |   { | ||||||
|  |     source: '/docs/builders/vsphere-:path', | ||||||
|  |     destination: '/docs/builders/vmware/vsphere-:path*', | ||||||
|  |     permanent: true, | ||||||
|  |   }, | ||||||
|  |   // disallow '.html' or '/index.html' in favor of cleaner, simpler paths
 | ||||||
|  |   { source: '/:path*/index', destination: '/:path*', permanent: true }, | ||||||
|  |   { source: '/:path*.html', destination: '/:path*', permanent: true }, | ||||||
|  | ] | ||||||
							
								
								
									
										7
									
								
								website/vercel.json
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										7
									
								
								website/vercel.json
									
									
									
									
									
										Normal file
									
								
							| @ -0,0 +1,7 @@ | |||||||
|  | { | ||||||
|  |   "version": 2, | ||||||
|  |   "public": true, | ||||||
|  |   "github": { | ||||||
|  |     "silent": true | ||||||
|  |   } | ||||||
|  | } | ||||||
		Loading…
	
	
			
			x
			
			
		
	
		Reference in New Issue
	
	Block a user