|
|
|
|
@ -1,23 +1,20 @@
|
|
|
|
|
---
|
|
|
|
|
description:
|
|
|
|
|
with Oracle Bare Metal Cloud Services (BMCS). The builder takes an
|
|
|
|
|
Oracle-provided base image, runs any provisioning necessary on the base image
|
|
|
|
|
after launching it, and finally snapshots it creating a reusable custom
|
|
|
|
|
image.
|
|
|
|
|
The oracle-oci builder is able to create new custom images for use with Oracle
|
|
|
|
|
Cloud Infrastructure (OCI).
|
|
|
|
|
layout: docs
|
|
|
|
|
page_title: 'Oracle BMCS - Builders'
|
|
|
|
|
sidebar_current: 'docs-builders-oracle-bmcs'
|
|
|
|
|
page_title: 'Oracle OCI - Builders'
|
|
|
|
|
sidebar_current: 'docs-builders-oracle-oci'
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
# Oracle Bare Metal Cloud Services (BMCS) Builder
|
|
|
|
|
# Oracle Cloud Infrastructure (OCI) Builder
|
|
|
|
|
|
|
|
|
|
Type: `oracle-bmcs`
|
|
|
|
|
Type: `oracle-oci`
|
|
|
|
|
|
|
|
|
|
The `oracle-bmcs` Packer builder is able to create new custom images for use
|
|
|
|
|
with [Oracle Bare Metal Cloud Services](https://cloud.oracle.com/en_US/bare-metal-compute)
|
|
|
|
|
(BMCS). The builder takes an Oracle-provided base image, runs any provisioning
|
|
|
|
|
necessary on the base image after launching it, and finally snapshots it
|
|
|
|
|
creating a reusable custom image.
|
|
|
|
|
The `oracle-oci` Packer builder is able to create new custom images for use
|
|
|
|
|
with [Oracle Cloud Infrastructure](https://cloud.oracle.com) (OCI). The builder
|
|
|
|
|
takes a base image, runs any provisioning necessary on the base image after
|
|
|
|
|
launching it, and finally snapshots it creating a reusable custom image.
|
|
|
|
|
|
|
|
|
|
It is recommended that you familiarise yourself with the
|
|
|
|
|
[Key Concepts and Terminology](https://docs.us-phoenix-1.oraclecloud.com/Content/GSG/Concepts/concepts.htm)
|
|
|
|
|
@ -28,7 +25,7 @@ to use it or delete it.
|
|
|
|
|
|
|
|
|
|
## Authorization
|
|
|
|
|
|
|
|
|
|
The Oracle BMCS API requires that requests be signed with the RSA public key
|
|
|
|
|
The Oracle OCI API requires that requests be signed with the RSA public key
|
|
|
|
|
associated with your [IAM](https://docs.us-phoenix-1.oraclecloud.com/Content/Identity/Concepts/overview.htm)
|
|
|
|
|
user account. For a comprehensive example of how to configure the required
|
|
|
|
|
authentication see the documentation on
|
|
|
|
|
@ -37,7 +34,7 @@ authentication see the documentation on
|
|
|
|
|
|
|
|
|
|
## Configuration Reference
|
|
|
|
|
|
|
|
|
|
There are many configuration options available for the `oracle-bmcs` builder.
|
|
|
|
|
There are many configuration options available for the `oracle-oci` builder.
|
|
|
|
|
In addition to the options listed here, a
|
|
|
|
|
[communicator](/docs/templates/communicator.html) can be configured for this
|
|
|
|
|
builder.
|
|
|
|
|
@ -54,8 +51,7 @@ builder.
|
|
|
|
|
[ListAvailabilityDomains](https://docs.us-phoenix-1.oraclecloud.com/api/#/en/identity/latest/AvailabilityDomain/ListAvailabilityDomains)
|
|
|
|
|
operation, which is available in the IAM Service API.
|
|
|
|
|
|
|
|
|
|
- `base_image_ocid` (string) - The OCID of the
|
|
|
|
|
[Oracle-provided base image](https://docs.us-phoenix-1.oraclecloud.com/Content/Compute/References/images.htm)
|
|
|
|
|
- `base_image_ocid` (string) - The OCID of the [base image](https://docs.us-phoenix-1.oraclecloud.com/Content/Compute/References/images.htm)
|
|
|
|
|
to use. This is the unique identifier of the image that will be used to
|
|
|
|
|
launch a new instance and provision it.
|
|
|
|
|
|
|
|
|
|
@ -66,9 +62,9 @@ builder.
|
|
|
|
|
- `compartment_ocid` (string) - The OCID of the
|
|
|
|
|
[compartment](https://docs.us-phoenix-1.oraclecloud.com/Content/GSG/Tasks/choosingcompartments.htm)
|
|
|
|
|
|
|
|
|
|
- `fingerprint` (string) - Fingerprint for the BMCS API signing key.
|
|
|
|
|
- `fingerprint` (string) - Fingerprint for the OCI API signing key.
|
|
|
|
|
Overrides value provided by the
|
|
|
|
|
[BMCS config file](https://docs.us-phoenix-1.oraclecloud.com/Content/API/Concepts/sdkconfig.htm)
|
|
|
|
|
[OCI config file](https://docs.us-phoenix-1.oraclecloud.com/Content/API/Concepts/sdkconfig.htm)
|
|
|
|
|
if present.
|
|
|
|
|
|
|
|
|
|
- `shape` (string) - The template that determines the number of
|
|
|
|
|
@ -94,37 +90,37 @@ builder.
|
|
|
|
|
### Optional
|
|
|
|
|
|
|
|
|
|
- `access_cfg_file` (string) - The path to the
|
|
|
|
|
[BMCS config file](https://docs.us-phoenix-1.oraclecloud.com/Content/API/Concepts/sdkconfig.htm).
|
|
|
|
|
Defaults to `$HOME/.oraclebmc/config`.
|
|
|
|
|
[OCI config file](https://docs.us-phoenix-1.oraclecloud.com/Content/API/Concepts/sdkconfig.htm).
|
|
|
|
|
Defaults to `$HOME/.oci/config`.
|
|
|
|
|
|
|
|
|
|
- `access_cfg_file_account` (string) - The specific account in the
|
|
|
|
|
[BMCS config file](https://docs.us-phoenix-1.oraclecloud.com/Content/API/Concepts/sdkconfig.htm)
|
|
|
|
|
[OCI config file](https://docs.us-phoenix-1.oraclecloud.com/Content/API/Concepts/sdkconfig.htm)
|
|
|
|
|
to use. Defaults to `DEFAULT`.
|
|
|
|
|
|
|
|
|
|
- `image_name` (string) - The name to assign to the resulting custom image.
|
|
|
|
|
|
|
|
|
|
- `key_file` (string) - Full path and filename of the BMCS API signing key.
|
|
|
|
|
- `key_file` (string) - Full path and filename of the OCI API signing key.
|
|
|
|
|
Overrides value provided by the
|
|
|
|
|
[BMCS config file](https://docs.us-phoenix-1.oraclecloud.com/Content/API/Concepts/sdkconfig.htm)
|
|
|
|
|
[OCI config file](https://docs.us-phoenix-1.oraclecloud.com/Content/API/Concepts/sdkconfig.htm)
|
|
|
|
|
if present.
|
|
|
|
|
|
|
|
|
|
- `pass_phrase` (string) - Pass phrase used to decrypt the BMCS API signing
|
|
|
|
|
- `pass_phrase` (string) - Pass phrase used to decrypt the OCI API signing
|
|
|
|
|
key. Overrides value provided by the
|
|
|
|
|
[BMCS config file](https://docs.us-phoenix-1.oraclecloud.com/Content/API/Concepts/sdkconfig.htm)
|
|
|
|
|
[OCI config file](https://docs.us-phoenix-1.oraclecloud.com/Content/API/Concepts/sdkconfig.htm)
|
|
|
|
|
if present.
|
|
|
|
|
|
|
|
|
|
- `region` (string) - An Oracle Bare Metal Cloud Services region. Overrides
|
|
|
|
|
- `region` (string) - An Oracle Cloud Infrastructure region. Overrides
|
|
|
|
|
value provided by the
|
|
|
|
|
[BMCS config file](https://docs.us-phoenix-1.oraclecloud.com/Content/API/Concepts/sdkconfig.htm)
|
|
|
|
|
[OCI config file](https://docs.us-phoenix-1.oraclecloud.com/Content/API/Concepts/sdkconfig.htm)
|
|
|
|
|
if present.
|
|
|
|
|
|
|
|
|
|
- `tenancy_ocid` (string) - The OCID of your tenancy. Overrides value provided
|
|
|
|
|
by the
|
|
|
|
|
[BMCS config file](https://docs.us-phoenix-1.oraclecloud.com/Content/API/Concepts/sdkconfig.htm)
|
|
|
|
|
[OCI config file](https://docs.us-phoenix-1.oraclecloud.com/Content/API/Concepts/sdkconfig.htm)
|
|
|
|
|
if present.
|
|
|
|
|
|
|
|
|
|
- `user_ocid` (string) - The OCID of the user calling the BMCS API. Overrides
|
|
|
|
|
value provided by the [BMCS config file](https://docs.us-phoenix-1.oraclecloud.com/Content/API/Concepts/sdkconfig.htm)
|
|
|
|
|
- `user_ocid` (string) - The OCID of the user calling the OCI API. Overrides
|
|
|
|
|
value provided by the [OCI config file](https://docs.us-phoenix-1.oraclecloud.com/Content/API/Concepts/sdkconfig.htm)
|
|
|
|
|
if present.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
@ -142,6 +138,6 @@ substituted with the letter `a` and OCIDS have been shortened for brevity.
|
|
|
|
|
"shape": "VM.Standard1.1",
|
|
|
|
|
"ssh_username": "opc",
|
|
|
|
|
"subnet_ocid": "ocid1.subnet.oc1..aaa",
|
|
|
|
|
"type": "oracle-bmcs"
|
|
|
|
|
"type": "oracle-oci"
|
|
|
|
|
}
|
|
|
|
|
```
|