Merge pull request #13166 from tombuildsstuff/opc-docs

provider/opc: Updating the Website
This commit is contained in:
Tom Harvey 2017-03-30 15:10:04 +01:00 committed by GitHub
commit bcd4c7199b
15 changed files with 188 additions and 33 deletions

View File

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

View File

@ -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.

View File

@ -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.

View File

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

View File

@ -1,7 +1,7 @@
--- ---
layout: "oracle" layout: "oracleopc"
page_title: "Oracle: opc_compute_ip_association" page_title: "Oracle: opc_compute_ip_association"
sidebar_current: "docs-opc-resource-ip-association" sidebar_current: "docs-oracleopc-resource-ip-association"
description: |- description: |-
Creates and manages an IP association in an OPC identity domain. Creates and manages an IP association in an OPC identity domain.
--- ---
@ -28,4 +28,4 @@ The following arguments are supported:
* `parentpool` - (Required) The pool from which to take an IP address. To associate a specific reserved IP address, use * `parentpool` - (Required) The pool from which to take an IP address. To associate a specific reserved IP address, use
the prefix `ipreservation:` followed by the name of the IP reservation. To allocate an IP address from a pool, use the the prefix `ipreservation:` followed by the name of the IP reservation. To allocate an IP address from a pool, use the
prefix `ippool:`, e.g. `ippool:/oracle/public/ippool`. prefix `ippool:`, e.g. `ippool:/oracle/public/ippool`.

View File

@ -1,7 +1,7 @@
--- ---
layout: "oracle" layout: "oracleopc"
page_title: "Oracle: opc_compute_ip_reservation" page_title: "Oracle: opc_compute_ip_reservation"
sidebar_current: "docs-opc-resource-ip-assocation" sidebar_current: "docs-oracleopc-resource-ip-reservation"
description: |- description: |-
Creates and manages an IP reservation in an OPC identity domain. Creates and manages an IP reservation in an OPC identity domain.
--- ---
@ -30,4 +30,4 @@ The following arguments are supported:
(if true), or may be returned to the pool and replaced with a different IP address when an instance is restarted, or (if true), or may be returned to the pool and replaced with a different IP address when an instance is restarted, or
deleted and recreated (if false). deleted and recreated (if false).
* `tags` - (Optional) List of tags that may be applied to the IP reservation. * `tags` - (Optional) List of tags that may be applied to the IP reservation.

View File

@ -1,12 +1,12 @@
--- ---
layout: "oracle" layout: "oracleopc"
page_title: "Oracle: opc_compute_security_application" page_title: "Oracle: opc_compute_security_application"
sidebar_current: "docs-opc-resource-security-application" sidebar_current: "docs-oracleopc-resource-security-application"
description: |- description: |-
Creates and manages a security application in an OPC identity domain. 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. The ``opc_compute_security_application`` resource creates and manages a security application in an OPC identity domain.
@ -36,4 +36,4 @@ the corresponding integer in the range 0-254 from the list of [assigned protocol
`echo`, `reply`, `ttl`, `traceroute`, `unreachable`. `echo`, `reply`, `ttl`, `traceroute`, `unreachable`.
* `icmpcode` - (Optional) The ICMP code to enable for this application, if the `protocol` is `icmp`. Must be one of * `icmpcode` - (Optional) The ICMP code to enable for this application, if the `protocol` is `icmp`. Must be one of
`network`, `host`, `protocol`, `port`, `df`, `admin`. `network`, `host`, `protocol`, `port`, `df`, `admin`.

View File

@ -1,12 +1,12 @@
--- ---
layout: "oracle" layout: "oracleopc"
page_title: "Oracle: opc_compute_security_association" page_title: "Oracle: opc_compute_security_association"
sidebar_current: "docs-opc-resource-security-association" sidebar_current: "docs-oracleopc-resource-security-association"
description: |- description: |-
Creates and manages a security association in an OPC identity domain. 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 The ``opc_compute_security_association`` resource creates and manages an association between an instance and a security
list in an OPC identity domain. list in an OPC identity domain.
@ -26,4 +26,4 @@ The following arguments are supported:
* `vcable` - (Required) The `vcable` of the instance to associate to the security list. * `vcable` - (Required) The `vcable` of the instance to associate to the security list.
* `seclist` - (Required) The name of the security list to associate the instance to. * `seclist` - (Required) The name of the security list to associate the instance to.

View File

@ -1,12 +1,12 @@
--- ---
layout: "oracle" layout: "oracleopc"
page_title: "Oracle: opc_compute_security_ip_list" page_title: "Oracle: opc_compute_security_ip_list"
sidebar_current: "docs-opc-resource-security-list" sidebar_current: "docs-oracleopc-resource-security-ip-list"
description: |- description: |-
Creates and manages a security IP list in an OPC identity domain. 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. The ``opc_compute_security_ip_list`` resource creates and manages a security IP list in an OPC identity domain.
@ -25,4 +25,4 @@ The following arguments are supported:
* `name` - (Required) The unique (within the identity domain) name of the security IP list. * `name` - (Required) The unique (within the identity domain) name of the security IP list.
* `ip_entries` - (Required) The IP addresses to include in the list. * `ip_entries` - (Required) The IP addresses to include in the list.

View File

@ -1,12 +1,12 @@
--- ---
layout: "oracle" layout: "oracleopc"
page_title: "Oracle: opc_compute_security_list" page_title: "Oracle: opc_compute_security_list"
sidebar_current: "docs-opc-resource-security-list" sidebar_current: "docs-oracleopc-resource-security-list"
description: |- description: |-
Creates and manages a security list in an OPC identity domain. 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. The ``opc_compute_security_list`` resource creates and manages a security list in an OPC identity domain.
@ -30,4 +30,4 @@ The following arguments are supported:
`reject` (packets are dropped but a reply is sent) and `deny` (packets are dropped and no reply is sent). `reject` (packets are dropped but a reply is sent) and `deny` (packets are dropped and no reply is sent).
* `output_cidr_policy` - (Required) The policy for outbound traffic from the security list.Must be one of `permit`, * `output_cidr_policy` - (Required) The policy for outbound traffic from the security list.Must be one of `permit`,
`reject` (packets are dropped but a reply is sent) and `deny` (packets are dropped and no reply is sent). `reject` (packets are dropped but a reply is sent) and `deny` (packets are dropped and no reply is sent).

View File

@ -1,7 +1,7 @@
--- ---
layout: "oracle" layout: "oracleopc"
page_title: "Oracle: opc_compute_security_rule" page_title: "Oracle: opc_compute_security_rule"
sidebar_current: "docs-opc-resource-security-rule" sidebar_current: "docs-oracleopc-resource-security-rule"
description: |- description: |-
Creates and manages a security rule in an OPC identity domain. Creates and manages a security rule in an OPC identity domain.
--- ---
@ -33,7 +33,7 @@ The following arguments are supported:
* `source_list` - (Required) The source security list (prefixed with `seclist:`), or security IP list (prefixed with * `source_list` - (Required) The source security list (prefixed with `seclist:`), or security IP list (prefixed with
`seciplist:`). `seciplist:`).
* `destination_list` - (Required) The destination security list (prefixed with `seclist:`), or security IP list (prefixed with * `destination_list` - (Required) The destination security list (prefixed with `seclist:`), or security IP list (prefixed with
`seciplist:`). `seciplist:`).
@ -43,4 +43,4 @@ The following arguments are supported:
be `permit`. be `permit`.
* `disabled` - (Required) Whether to disable this security rule. This is useful if you want to temporarily disable a rule * `disabled` - (Required) Whether to disable this security rule. This is useful if you want to temporarily disable a rule
without removing it outright from your Terraform resource definition. without removing it outright from your Terraform resource definition.

View File

@ -1,7 +1,7 @@
--- ---
layout: "oracle" layout: "oracleopc"
page_title: "Oracle: opc_compute_ssh_key" page_title: "Oracle: opc_compute_ssh_key"
sidebar_current: "docs-opc-resource-instance" sidebar_current: "docs-oracleopc-resource-ssh-key"
description: |- description: |-
Creates and manages an SSH key in an OPC identity domain. Creates and manages an SSH key in an OPC identity domain.
--- ---
@ -29,4 +29,4 @@ The following arguments are supported:
* `key` - (Required) The SSH key itself * `key` - (Required) The SSH key itself
* `enabled` - (Required) Whether or not the key is enabled. This is useful if you want to temporarily disable an SSH key, * `enabled` - (Required) Whether or not the key is enabled. This is useful if you want to temporarily disable an SSH key,
without removing it entirely from your Terraform resource definition. without removing it entirely from your Terraform resource definition.

View File

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

View File

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

View File

@ -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 %>