add docs page

builder/oracle/classic/step_create_instance.go

@@ -62,7 +62,6 @@ func (s *stepCreateInstance) Cleanup(state multistep.StateBag) {
 	ui.Say(fmt.Sprintf("Terminating instance (%s)...", imID))
 
 	instanceClient := client.Instances()
-	// Instances Input
 	input := &compute.DeleteInstanceInput{
 		Name: config.ImageName,
 		ID:   imID,

website/source/docs/builders/oracle-classic.html.md

@@ -0,0 +1,98 @@
+---
+description:
+  The oracle-classic builder is able to create new custom images for use with Oracle
+  Compute Cloud.
+layout: docs
+page_title: 'Oracle Classic - Builders'
+sidebar_current: 'docs-builders-oracle-classic'
+---
+
+# Oracle Compute Cloud (Classic) Builder
+
+Type: `oracle-classic`
+
+The `oracle-classic` Packer builder is able to create custom images for use
+with [Oracle Compute Cloud](https://cloud.oracle.com/compute-classic). 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.oracle.com/en/cloud/iaas/compute-iaas-cloud/stcsg/terminology.html)
+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
+to use it or delete it.
+
+## Authorization
+
+This builder authenticates API calls to Compute Classic using basic 
+authentication (user name and password).
+To read more, see the [authentication documentation](https://docs.oracle.com/en/cloud/iaas/compute-iaas-cloud/stcsa/Authentication.html)
+
+## Configuration Reference
+
+There are many configuration options available for the `oracle-classic` builder.
+This builder currently only works with the SSH communicator.
+
+### Required
+
+ -  `api_endpoint` (string) - This is your custom API endpoint for sending 
+    requests. Instructions for determining your API endpoint can be found 
+    [here](https://docs.oracle.com/en/cloud/iaas/compute-iaas-cloud/stcsa/SendRequests.html)
+
+ -  `identity_domain` (string) - This is your customer-specific identity domain
+    as generated by Oracle. If you don't know what your identity domain is, ask
+    your account administrator. For a little more information, see the Oracle
+    [documentation](https://docs.oracle.com/en/cloud/get-started/subscriptions-cloud/ocuid/identity-domain-overview.html#GUID-7969F881-5F4D-443E-B86C-9044C8085B8A).
+
+ -  `image_list` (string) - This is what image you want to use as your base image.
+    See the [documentation](https://docs.oracle.com/en/cloud/iaas/compute-iaas-cloud/stcsg/listing-machine-images.html)
+    for more details. To see what public image lists are available, you can use 
+    the CLI, as described [here](https://docs.oracle.com/en/cloud/iaas/compute-iaas-cloud/stopc/image-lists-stclr-and-nmcli.html#GUID-DB7E75FE-F752-4FF7-AB70-3C8DCDFCA0FA)
+
+ -  `password` (string) - Your account password.
+
+ -  `shape` (string) - The template that determines the number of
+    CPUs, amount of memory, and other resources allocated to a newly created
+    instance. For more information about shapes, see the documentation [here](https://docs.oracle.com/en/cloud/iaas/compute-iaas-cloud/stcsg/machine-images-and-shapes.html).
+
+ -  `username` (string) - Your account username.
+
+### Optional
+
+ -  `ssh_username` (string) - The username that Packer will use to SSH into the 
+    instance; defaults to `opc`, the default oracle user, which has sudo 
+    priveliges. If you have already configured users on your machine, you may 
+    prompt Packer to use one of those instead. For more detail, see the 
+    [documentation](https://docs.oracle.com/en/cloud/iaas/compute-iaas-cloud/stcsg/accessing-oracle-linux-instance-using-ssh.html).
+
+ -  `image_name` (string) - The name to assign to the resulting custom image.
+
+## Basic Example
+
+Here is a basic example. Note that account specific configuration has been 
+obfuscated; you will need to add a working `username`, `password`, 
+`identity_domain`, and `api_endpoint` in order for the example to work.
+
+``` {.json}
+{
+    "builders": [
+        {
+            "type": "oracle-classic",
+            "username": "myuser@myaccount.com",
+            "password": "supersecretpasswordhere",
+            "identity_domain": "#######",
+            "api_endpoint": "https://api-###.compute.###.oraclecloud.com/",
+            "image_list": "/oracle/public/OL_7.2_UEKR4_x86_64",
+            "shape": "oc3", 
+            "image_name": "Packer_Builder_Test_{{timestamp}}"
+        }
+    ],
+    "provisioners": [
+        {
+            "type": "shell",
+            "inline": ["echo hello"]
+        }
+    ]
+}
+```

website/source/layouts/docs.erb

@@ -131,6 +131,9 @@
           <li<%= sidebar_current("docs-builders-openstack") %>>
             <a href="/docs/builders/openstack.html">OpenStack</a>
           </li>
+          <li<%= sidebar_current("docs-builders-oracle-classic") %>>
+            <a href="/docs/builders/oracle-classic.html">Oracle Classic</a>
+          </li>          
           <li<%= sidebar_current("docs-builders-oracle-oci") %>>
             <a href="/docs/builders/oracle-oci.html">Oracle OCI</a>
           </li>