Initial docs for Oracle Compute Cloud provider
This commit is contained in:
Stephen Cross
Jake Champlin
parent
403801cf68
commit
c5fa0404d6
|
|
@ -0,0 +1,68 @@
|
|||
---
|
||||
layout: "oracle"
|
||||
page_title: "Oracle: opc_compute_instance"
|
||||
sidebar_current: "docs-opc-resource-instance"
|
||||
description: |-
|
||||
Creates and manages an instance in an OPC identity domain.
|
||||
---
|
||||
|
||||
# opc\_compute\_instance
|
||||
|
||||
The ``opc_compute_instance`` resource creates and manages an instance in an OPC identity domain.
|
||||
|
||||
~> **Caution:** The ``opc_compute_instance`` resource can completely delete your
|
||||
instance just as easily as it can create it. To avoid costly accidents,
|
||||
consider setting
|
||||
[``prevent_destroy``](/docs/configuration/resources.html#prevent_destroy)
|
||||
on your instance resources as an extra safety measure.
|
||||
|
||||
## Example Usage
|
||||
|
||||
```
|
||||
resource "opc_compute_instance" "test_instance" {
|
||||
name = "test"
|
||||
label = "test"
|
||||
shape = "oc3"
|
||||
imageList = "/oracle/public/oel_6.4_2GB_v1"
|
||||
sshKeys = ["${opc_compute_ssh_key.key1.name}"]
|
||||
attributes = "{\"foo\":\"bar\"}"
|
||||
storage = [{
|
||||
index = 1
|
||||
volume = "${opc_compute_storage_volume.test_volume.name}"
|
||||
},
|
||||
{
|
||||
index = 2
|
||||
volume = "${opc_compute_storage_volume.test_volume2.name}"
|
||||
}]
|
||||
}
|
||||
```
|
||||
|
||||
## Argument Reference
|
||||
|
||||
The following arguments are supported:
|
||||
|
||||
* `name` - (Required) The name of the instance. This need not be unique, as each instance is assigned a separate
|
||||
computed `opcId`.
|
||||
|
||||
* `shape` - (Required) The shape of the instance, e.g. `oc4`.
|
||||
|
||||
* `imageList` - (Optional) The imageList of the instance, e.g. `/oracle/public/oel_6.4_2GB_v1`
|
||||
|
||||
* `label` - (Optional) The label to apply to the instance.
|
||||
|
||||
* `ip` - (Computed) The internal IP address assigned to the instance.
|
||||
|
||||
* `opcId` - (Computed) The interned ID assigned to the instance.
|
||||
|
||||
* `sshKeys` - (Optional) The names of the SSH Keys that can be used to log into the instance.
|
||||
|
||||
* `attributes` - (Optional) An arbitrary JSON-formatted collection of attributes which is made available to the instance.
|
||||
|
||||
* `vcable` - (Computed) The ID of the instance's VCable, which is used to associate it with reserved IP addresses and
|
||||
add it to Security Lists.
|
||||
|
||||
* `storage` - (Optional) A set of zero or more storage volumes to attach to the instance. Each volume has two arguments:
|
||||
`index`, which is the volume's index in the instance's list of mounted volumes, and `name`, which is the name of the
|
||||
storage volume to mount.
|
||||
|
||||
* `bootOrder` - (Optional) The index number of the bootable storage volume that should be used to boot the instance. e.g. `[ 1 ]`. If you specify both `bootOrder` and `imageList`, the imagelist attribute is ignored.
|
||||
|
|
@ -0,0 +1,31 @@
|
|||
---
|
||||
layout: "oracle"
|
||||
page_title: "Oracle: opc_compute_ip_association"
|
||||
sidebar_current: "docs-opc-resource-ip-association"
|
||||
description: |-
|
||||
Creates and manages an IP association in an OPC identity domain.
|
||||
---
|
||||
|
||||
# opc\_compute\_ip\_association
|
||||
|
||||
The ``opc_compute_ip_association`` resource creates and manages an association between an IP address and an instance in
|
||||
an OPC identity domain.
|
||||
|
||||
## Example Usage
|
||||
|
||||
```
|
||||
resource "opc_compute_ip_association" "instance1_reservation1" {
|
||||
vcable = "${opc_compute_instance.test_instance.vcable}"
|
||||
parentpool = "ipreservation:${opc_compute_ip_reservation.reservation1.name}"
|
||||
}
|
||||
```
|
||||
|
||||
## Argument Reference
|
||||
|
||||
The following arguments are supported:
|
||||
|
||||
* `vcable` - (Required) The vcable of the instance to associate the IP address with.
|
||||
|
||||
* `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
|
||||
prefix `ippool:`, e.g. `ippool:/oracle/public/ippool`.
|
||||
|
|
@ -0,0 +1,33 @@
|
|||
---
|
||||
layout: "oracle"
|
||||
page_title: "Oracle: opc_compute_ip_reservation"
|
||||
sidebar_current: "docs-opc-resource-ip-assocation"
|
||||
description: |-
|
||||
Creates and manages an IP reservation in an OPC identity domain.
|
||||
---
|
||||
|
||||
# opc\_compute\_ip\_reservation
|
||||
|
||||
The ``opc_compute_ip_reservation`` resource creates and manages an IP reservation in an OPC identity domain.
|
||||
|
||||
## Example Usage
|
||||
|
||||
```
|
||||
resource "opc_compute_ip_reservation" "reservation1" {
|
||||
parentpool = "/oracle/public/ippool"
|
||||
permanent = true
|
||||
tags = []
|
||||
}
|
||||
```
|
||||
|
||||
## Argument Reference
|
||||
|
||||
The following arguments are supported:
|
||||
|
||||
* `parentpool` - (Required) The pool from which to allocate the IP address.
|
||||
|
||||
* `permanent` - (Required) Whether the IP address remains reserved even when it is no longer associated with an instance
|
||||
(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).
|
||||
|
||||
* `tags` - (Optional) List of tags that may be applied to the IP reservation.
|
||||
|
|
@ -0,0 +1,39 @@
|
|||
---
|
||||
layout: "oracle"
|
||||
page_title: "Oracle: opc_compute_security_application"
|
||||
sidebar_current: "docs-opc-resource-security-application"
|
||||
description: |-
|
||||
Creates and manages a security application in an OPC identity domain.
|
||||
---
|
||||
|
||||
# opc\_compute\_ip\_reservation
|
||||
|
||||
The ``opc_compute_security_application`` resource creates and manages a security application in an OPC identity domain.
|
||||
|
||||
## Example Usage
|
||||
|
||||
```
|
||||
resource "opc_compute_security_application" "tomcat" {
|
||||
name = "tomcat"
|
||||
protocol = "tcp"
|
||||
dport = "8080"
|
||||
}
|
||||
```
|
||||
|
||||
## Argument Reference
|
||||
|
||||
The following arguments are supported:
|
||||
|
||||
* `name` - (Required) The unique (within the identity domain) name of the application
|
||||
|
||||
* `protocol` - (Required) The protocol to enable for this application. Must be either one of
|
||||
`tcp`, `udp`, `icmp`, `igmp`, `ipip`, `rdp`, `esp`, `ah`, `gre`, `icmpv6`, `ospf`, `pim`, `sctp`, `mplsip` or `all`, or
|
||||
the corresponding integer in the range 0-254 from the list of [assigned protocol numbers](http://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml)
|
||||
|
||||
* `dport` - (Required) The port, or range of ports, to enable for this application, e.g `8080`, `6000-7000`.
|
||||
|
||||
* `icmptype` - (Optional) The ICMP type to enable for this application, if the `protocol` is `icmp`. Must be one of
|
||||
`echo`, `reply`, `ttl`, `traceroute`, `unreachable`.
|
||||
|
||||
* `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`.
|
||||
|
|
@ -0,0 +1,29 @@
|
|||
---
|
||||
layout: "oracle"
|
||||
page_title: "Oracle: opc_compute_security_association"
|
||||
sidebar_current: "docs-opc-resource-security-association"
|
||||
description: |-
|
||||
Creates and manages a security association in an OPC identity domain.
|
||||
---
|
||||
|
||||
# opc\_compute\_ip\_reservation
|
||||
|
||||
The ``opc_compute_security_association`` resource creates and manages an association between an instance and a security
|
||||
list in an OPC identity domain.
|
||||
|
||||
## Example Usage
|
||||
|
||||
```
|
||||
resource "opc_compute_security_association" "test_instance_sec_list_1" {
|
||||
vcable = "${opc_compute_instance.test_instance.vcable}"
|
||||
seclist = "${opc_compute_security_list.sec_list1.name}"
|
||||
}
|
||||
```
|
||||
|
||||
## Argument Reference
|
||||
|
||||
The following arguments are supported:
|
||||
|
||||
* `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.
|
||||
|
|
@ -0,0 +1,28 @@
|
|||
---
|
||||
layout: "oracle"
|
||||
page_title: "Oracle: opc_compute_security_ip_list"
|
||||
sidebar_current: "docs-opc-resource-security-list"
|
||||
description: |-
|
||||
Creates and manages a security IP list in an OPC identity domain.
|
||||
---
|
||||
|
||||
# opc\_compute\_ip\_reservation
|
||||
|
||||
The ``opc_compute_security_ip_list`` resource creates and manages a security IP list in an OPC identity domain.
|
||||
|
||||
## Example Usage
|
||||
|
||||
```
|
||||
resource "opc_compute_security_ip_list" "sec_ip_list1" {
|
||||
name = "sec-ip-list1"
|
||||
ip_entries = ["217.138.34.4"]
|
||||
}
|
||||
```
|
||||
|
||||
## Argument Reference
|
||||
|
||||
The following arguments are supported:
|
||||
|
||||
* `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.
|
||||
|
|
@ -0,0 +1,33 @@
|
|||
---
|
||||
layout: "oracle"
|
||||
page_title: "Oracle: opc_compute_security_list"
|
||||
sidebar_current: "docs-opc-resource-security-list"
|
||||
description: |-
|
||||
Creates and manages a security list in an OPC identity domain.
|
||||
---
|
||||
|
||||
# opc\_compute\_ip\_reservation
|
||||
|
||||
The ``opc_compute_security_list`` resource creates and manages a security list in an OPC identity domain.
|
||||
|
||||
## Example Usage
|
||||
|
||||
```
|
||||
resource "opc_compute_security_list" "sec_list1" {
|
||||
name = "sec-list-1"
|
||||
policy = "permit"
|
||||
outbound_cidr_policy = "deny"
|
||||
}
|
||||
```
|
||||
|
||||
## Argument Reference
|
||||
|
||||
The following arguments are supported:
|
||||
|
||||
* `name` - (Required) The unique (within the identity domain) name of the security list.
|
||||
|
||||
* `policy` - (Required) The policy to apply to instances associated with this 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).
|
||||
|
||||
* `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).
|
||||
|
|
@ -0,0 +1,46 @@
|
|||
---
|
||||
layout: "oracle"
|
||||
page_title: "Oracle: opc_compute_security_rule"
|
||||
sidebar_current: "docs-opc-resource-security-rule"
|
||||
description: |-
|
||||
Creates and manages a security rule in an OPC identity domain.
|
||||
---
|
||||
|
||||
# opc\_compute\_ip\_reservation
|
||||
|
||||
The ``opc_compute_security_rule`` resource creates and manages a security rule in an OPC identity domain, which joins
|
||||
together a source security list (or security IP list), a destination security list (or security IP list), and a security
|
||||
application.
|
||||
|
||||
## Example Usage
|
||||
|
||||
```
|
||||
resource "opc_compute_security_rule" "test_rule" {
|
||||
name = "test"
|
||||
source_list = "seclist:${opc_compute_security_list.sec-list1.name}"
|
||||
destination_list = "seciplist:${opc_compute_security_ip_list.sec-ip-list1.name}"
|
||||
action = "permit"
|
||||
application = "${opc_compute_security_application.spring-boot.name}"
|
||||
disabled = false
|
||||
}
|
||||
```
|
||||
|
||||
## Argument Reference
|
||||
|
||||
The following arguments are supported:
|
||||
|
||||
* `name` - (Required) The unique (within the identity domain) name of the security rule.
|
||||
|
||||
* `source_list` - (Required) The source security list (prefixed with `seclist:`), or security IP list (prefixed with
|
||||
`seciplist:`).
|
||||
|
||||
* `destination_list` - (Required) The destination security list (prefixed with `seclist:`), or security IP list (prefixed with
|
||||
`seciplist:`).
|
||||
|
||||
* `application` - (Required) The name of the application to which the rule applies.
|
||||
|
||||
* `action` - (Required) Whether to `permit`, `refuse` or `deny` packets to which this rule applies. This will ordinarily
|
||||
be `permit`.
|
||||
|
||||
* `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.
|
||||
|
|
@ -0,0 +1,32 @@
|
|||
---
|
||||
layout: "oracle"
|
||||
page_title: "Oracle: opc_compute_ssh_key"
|
||||
sidebar_current: "docs-opc-resource-instance"
|
||||
description: |-
|
||||
Creates and manages an SSH key in an OPC identity domain.
|
||||
---
|
||||
|
||||
# opc\_compute\_ssh_key
|
||||
|
||||
The ``opc_compute_ssh_key`` resource creates and manages an SSH key in an OPC identity domain.
|
||||
|
||||
## Example Usage
|
||||
|
||||
```
|
||||
resource "opc_compute_ssh_key" "%s" {
|
||||
name = "test-key"
|
||||
key = "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQCqw6JwbjIk..."
|
||||
enabled = true
|
||||
}
|
||||
```
|
||||
|
||||
## Argument Reference
|
||||
|
||||
The following arguments are supported:
|
||||
|
||||
* `name` - (Required) The unique (within this identity domain) name of the SSH key.
|
||||
|
||||
* `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,
|
||||
without removing it entirely from your Terraform resource definition.
|
||||
|
|
@ -0,0 +1,49 @@
|
|||
---
|
||||
layout: "oracle"
|
||||
page_title: "Oracle: opc_compute_storage_volume"
|
||||
sidebar_current: "docs-opc-resource-storage_volume"
|
||||
description: |-
|
||||
Creates and manages a storage volume in an OPC identity domain.
|
||||
---
|
||||
|
||||
# opc\_compute\_storage\_volume
|
||||
|
||||
The ``opc_compute_storage_volume`` resource creates and manages a storage volume in an OPC identity domain.
|
||||
|
||||
~> **Caution:** The ``opc_compute_storage_volume`` resource can completely delete your
|
||||
storage volume just as easily as it can create it. To avoid costly accidents,
|
||||
consider setting
|
||||
[``prevent_destroy``](/docs/configuration/resources.html#prevent_destroy)
|
||||
on your storage volume resources as an extra safety measure.
|
||||
|
||||
## Example Usage
|
||||
|
||||
```
|
||||
resource "opc_compute_storage_volume" "test_volume" {
|
||||
size = "3g"
|
||||
description = "My storage volume"
|
||||
name = "test_volume_a"
|
||||
tags = ["xyzzy", "quux"]
|
||||
}
|
||||
```
|
||||
|
||||
## Argument Reference
|
||||
|
||||
The following arguments are supported:
|
||||
|
||||
* `name` - (Required) The unique (within this identity domain) name of the storage volume.
|
||||
|
||||
* `size` - (Required) The size of the storage instance.
|
||||
|
||||
* `description` - (Optional) A description of the storage volume.
|
||||
|
||||
* `tags` - (Optional) A list of tags to apply to the storage volume.
|
||||
|
||||
* `bootableImage` - (Optional) The name of the bootable image the storage volume is loaded with.
|
||||
|
||||
* `bootableImageVersion` - (Optional) The version of the bootable image specified in `bootableImage` to use.
|
||||
|
||||
* `snapshot` - (Optional) The snapshot to initialise the storage volume with. This has two nested properties: `name`,
|
||||
for the name of the snapshot to use, and `account` for the name of the snapshot account to use.
|
||||
|
||||
* `snapshotId` - (Optional) The id of the snapshot to initialise the storage volume with.
|
||||
Loading…
Reference in New Issue