Merge pull request #13166 from tombuildsstuff/opc-docs

provider/opc: Updating the Website

website/source/assets/stylesheets/_docs.scss

@@ -50,6 +50,7 @@ body.layout-nomad,
 body.layout-ns1,
 body.layout-openstack,
 body.layout-opsgenie,
+body.layout-oracleopc,
 body.layout-packet,
 body.layout-pagerduty,
 body.layout-postgresql,

website/source/docs/providers/oracleopc/d/opc_compute_vnic.html.markdown

@@ -0,0 +1,36 @@
+---
+layout: "oracleopc"
+page_title: "Oracle: opc_compute_vnic"
+sidebar_current: "docs-oracleopc-datasource-vnic"
+description: |-
+  Gets information about the configuration of a Virtual NIC.
+---
+
+# opc\_compute\_vnic
+
+Use this data source to access the configuration of a Virtual NIC.
+
+## Example Usage
+
+```
+data "opc_compute_vnic" "current" {}
+
+output "mac_address" {
+  value = "${data.opc_compute_vnic.current.mac_address}"
+}
+```
+
+## Argument Reference
+* `name` is the name of the Virtual NIC.
+
+## Attributes Reference
+
+* `description` is a description of the Virtual NIC.
+
+* `mac_address` is the MAC Address of the Virtual NIC.
+
+* `tags` is a list of Tags associated with the Virtual NIC.
+
+* `transit_flag` is `true` if the Virtual NIC is of the type `transit`.
+
+* `uri` is the Unique Resource Locator of the Virtual NIC.

website/source/docs/providers/oracleopc/index.html.markdown

@@ -0,0 +1,55 @@
+---
+layout: "oracleopc"
+page_title: "Provider: Oracle Public Cloud"
+sidebar_current: "docs-oracleopc-index"
+description: |-
+  The Oracle Public Cloud provider is used to interact with the many resources supported by the Oracle Public Cloud. The provider needs to be configured with credentials for the Oracle Public Cloud API.
+---
+
+# Oracle Public Cloud Provider
+
+The Oracle Public Cloud provider is used to interact with the many resources supported by the Oracle Public Cloud. The provider needs to be configured with credentials for the Oracle Public Cloud API.
+
+Use the navigation to the left to read about the available resources.
+
+## Example Usage
+
+```
+# Configure the Oracle Public Cloud
+provider "oracle" {
+  user            = "..."
+  password        = "..."
+  identity_domain = "..."
+  endpoint        = "..."
+}
+
+# Create an IP Reservation
+resource "opc_compute_ip_reservation" "production" {
+  parent_pool = "/oracle/public/ippool"
+  permanent = true
+}
+```
+
+## Argument Reference
+
+The following arguments are supported:
+
+* `user` - (Optional) The username to use, generally your email address. It can also
+  be sourced from the `OPC_USERNAME` environment variable.
+
+* `password` - (Optional) The password associated with the username to use. It can also be sourced from
+  the `OPC_PASSWORD` environment variable.
+
+* `identity_domain` - (Optional) The identity domain to use. It can also be sourced from
+  the `OPC_IDENTITY_DOMAIN` environment variable.
+
+* `endpoint` - (Optional) The API endpoint to use, associated with your Oracle Public Cloud account. This is known as the `REST Endpoint` within the Oracle portal. It can also be sourced from the `OPC_ENDPOINT` environment variable.
+
+Max num seconds to wait for successful response when operating on resources within OPC (defaults to 3000)
+* `max_retry_timeout` - (Optional) The maximum number of seconds to wait for a successful response when operating on resources within Oracle Public Cloud. It can also be sourced from the `OPC_MAX_RETRY_TIMEOUT` environment variable. Defaults to 3000 seconds.
+
+## Testing
+
+Credentials must be provided via the `OPC_USERNAME`, `OPC_PASSWORD`,
+`OPC_IDENTITY_DOMAIN` and `OPC_ENDPOINT` environment variables in order to run
+acceptance tests.

website/source/docs/providers/oracleopc/r/opc_compute_instance.html.markdown

@@ -1,7 +1,7 @@
 ---
-layout: "oracle"
+layout: "oracleopc"
 page_title: "Oracle: opc_compute_instance"
-sidebar_current: "docs-opc-resource-instance"
+sidebar_current: "docs-oracleopc-resource-instance"
 description: |-
   Creates and manages an instance in an OPC identity domain.
 ---

website/source/docs/providers/oracleopc/r/opc_compute_ip_association.html.markdown

@@ -1,7 +1,7 @@
 ---
-layout: "oracle"
+layout: "oracleopc"
 page_title: "Oracle: opc_compute_ip_association"
-sidebar_current: "docs-opc-resource-ip-association"
+sidebar_current: "docs-oracleopc-resource-ip-association"
 description: |-
   Creates and manages an IP association in an OPC identity domain.
 ---

website/source/docs/providers/oracleopc/r/opc_compute_ip_reservation.html.markdown

@@ -1,7 +1,7 @@
 ---
-layout: "oracle"
+layout: "oracleopc"
 page_title: "Oracle: opc_compute_ip_reservation"
-sidebar_current: "docs-opc-resource-ip-assocation"
+sidebar_current: "docs-oracleopc-resource-ip-reservation"
 description: |-
   Creates and manages an IP reservation in an OPC identity domain.
 ---

website/source/docs/providers/oracleopc/r/opc_compute_security_application.html.markdown

@@ -1,12 +1,12 @@
 ---
-layout: "oracle"
+layout: "oracleopc"
 page_title: "Oracle: opc_compute_security_application"
-sidebar_current: "docs-opc-resource-security-application"
+sidebar_current: "docs-oracleopc-resource-security-application"
 description: |-
   Creates and manages a security application in an OPC identity domain.
 ---
 
-# opc\_compute\_ip\_reservation
+# opc\_compute\_security\_application
 
 The ``opc_compute_security_application`` resource creates and manages a security application in an OPC identity domain.
 

website/source/docs/providers/oracleopc/r/opc_compute_security_association.html.markdown

@@ -1,12 +1,12 @@
 ---
-layout: "oracle"
+layout: "oracleopc"
 page_title: "Oracle: opc_compute_security_association"
-sidebar_current: "docs-opc-resource-security-association"
+sidebar_current: "docs-oracleopc-resource-security-association"
 description: |-
   Creates and manages a security association in an OPC identity domain.
 ---
 
-# opc\_compute\_ip\_reservation
+# opc\_compute\_security\_association
 
 The ``opc_compute_security_association`` resource creates and manages an association between an instance and a security
 list in an OPC identity domain.

website/source/docs/providers/oracleopc/r/opc_compute_security_ip_list.html.markdown

@@ -1,12 +1,12 @@
 ---
-layout: "oracle"
+layout: "oracleopc"
 page_title: "Oracle: opc_compute_security_ip_list"
-sidebar_current: "docs-opc-resource-security-list"
+sidebar_current: "docs-oracleopc-resource-security-ip-list"
 description: |-
   Creates and manages a security IP list in an OPC identity domain.
 ---
 
-# opc\_compute\_ip\_reservation
+# opc\_compute\_security\_ip\_list
 
 The ``opc_compute_security_ip_list`` resource creates and manages a security IP list in an OPC identity domain.
 

website/source/docs/providers/oracleopc/r/opc_compute_security_list.html.markdown

@@ -1,12 +1,12 @@
 ---
-layout: "oracle"
+layout: "oracleopc"
 page_title: "Oracle: opc_compute_security_list"
-sidebar_current: "docs-opc-resource-security-list"
+sidebar_current: "docs-oracleopc-resource-security-list"
 description: |-
   Creates and manages a security list in an OPC identity domain.
 ---
 
-# opc\_compute\_ip\_reservation
+# opc\_compute\_security\_list
 
 The ``opc_compute_security_list`` resource creates and manages a security list in an OPC identity domain.
 

website/source/docs/providers/oracleopc/r/opc_compute_security_rule.html.markdown

@@ -1,7 +1,7 @@
 ---
-layout: "oracle"
+layout: "oracleopc"
 page_title: "Oracle: opc_compute_security_rule"
-sidebar_current: "docs-opc-resource-security-rule"
+sidebar_current: "docs-oracleopc-resource-security-rule"
 description: |-
   Creates and manages a security rule in an OPC identity domain.
 ---

website/source/docs/providers/oracleopc/r/opc_compute_ssh_key.html.markdown

@@ -1,7 +1,7 @@
 ---
-layout: "oracle"
+layout: "oracleopc"
 page_title: "Oracle: opc_compute_ssh_key"
-sidebar_current: "docs-opc-resource-instance"
+sidebar_current: "docs-oracleopc-resource-ssh-key"
 description: |-
   Creates and manages an SSH key in an OPC identity domain.
 ---

website/source/docs/providers/oracleopc/r/opc_compute_storage_volume.html.markdown

@@ -1,7 +1,7 @@
 ---
-layout: "oracle"
+layout: "oracleopc"
 page_title: "Oracle: opc_compute_storage_volume"
-sidebar_current: "docs-opc-resource-storage_volume"
+sidebar_current: "docs-oracleopc-resource-storage-volume"
 description: |-
   Creates and manages a storage volume in an OPC identity domain.
 ---

website/source/layouts/docs.erb

@@ -355,6 +355,10 @@
 							<a href="/docs/providers/opsgenie/index.html">OpsGenie</a>
 						</li>
 
+						<li<%= sidebar_current("docs-providers-oracleopc") %>>
+							<a href="/docs/providers/oracleopc/index.html">Oracle OPC</a>
+						</li>
+
 						<li<%= sidebar_current("docs-providers-packet") %>>
 							<a href="/docs/providers/packet/index.html">Packet</a>
 						</li>

website/source/layouts/oracleopc.erb

@@ -0,0 +1,59 @@
+<% wrap_layout :inner do %>
+<% content_for :sidebar do %>
+<div class="docs-sidebar hidden-print affix-top" role="complementary">
+    <ul class="nav docs-sidenav">
+        <li<%= sidebar_current("docs-home") %>>
+            <a href="/docs/providers/index.html">&laquo; Documentation Home</a>
+        </li>
+
+        <li<%= sidebar_current("docs-oracleopc-index") %>>
+            <a href="/docs/providers/oracleopc/index.html">Oracle Public Cloud Provider</a>
+        </li>
+
+        <li<%= sidebar_current(/^docs-oracleopc-datasource/) %>>
+            <a href="#">Data Sources</a>
+            <ul class="nav nav-visible">
+                <li<%= sidebar_current("docs-oracleopc-datasource-vnic") %>>
+                    <a href="/docs/providers/oracleopc/d/opc_compute_vnic.html">opc_compute_vnic</a>
+                </li>
+            </ul>
+        </li>
+
+        <li<%= sidebar_current(/^docs-oracleopc-resource/) %>>
+            <a href="#">Resources</a>
+            <ul class="nav nav-visible">
+                <li<%= sidebar_current("docs-oracleopc-resource-instance") %>>
+                    <a href="/docs/providers/oracleopc/r/opc_compute_instance.html">opc_compute_instance</a>
+                </li>
+                <li<%= sidebar_current("docs-oracleopc-resource-ip-association") %>>
+                    <a href="/docs/providers/oracleopc/r/opc_compute_ip_association.html">opc_compute_ip_association</a>
+                </li>
+                <li<%= sidebar_current("docs-oracleopc-resource-ip-reservation") %>>
+                    <a href="/docs/providers/oracleopc/r/opc_compute_ip_reservation.html">opc_compute_ip_reservation</a>
+                </li>
+                <li<%= sidebar_current("docs-oracleopc-resource-security-application") %>>
+                    <a href="/docs/providers/oracleopc/r/opc_compute_security_application.html">opc_compute_security_application</a>
+                </li>
+                <li<%= sidebar_current("docs-oracleopc-resource-security-association") %>>
+                    <a href="/docs/providers/oracleopc/r/opc_compute_security_association.html">opc_compute_security_association</a>
+                </li>
+                <li<%= sidebar_current("docs-oracleopc-resource-security-ip-list") %>>
+                    <a href="/docs/providers/oracleopc/r/opc_compute_security_ip_list.html">opc_compute_security_ip_list</a>
+                </li>
+                <li<%= sidebar_current("docs-oracleopc-resource-security-list") %>>
+                    <a href="/docs/providers/oracleopc/r/opc_compute_security_list.html">opc_compute_security_list</a>
+                </li>
+                <li<%= sidebar_current("docs-oracleopc-resource-ssh-key") %>>
+                    <a href="/docs/providers/oracleopc/r/opc_compute_ssh_key.html">opc_compute_ssh_key</a>
+                </li>
+                <li<%= sidebar_current("docs-oracleopc-resource-storage-volume") %>>
+                    <a href="/docs/providers/oracleopc/r/opc_compute_storage_volume.html">opc_compute_storage_volume</a>
+                </li>
+            </ul>
+        </li>
+    </ul>
+</div>
+<% end %>
+
+<%= yield %>
+<% end %>