terraform-oci-base

terraform-oci-base copied to clipboard

= Terraform Base for Oracle Cloud Infrastructure

:idprefix: :idseparator: -

:uri-repo: https://github.com/oracle/terraform-oci-base

:uri-rel-file-base: link:{uri-repo}/blob/master :uri-rel-tree-base: link:{uri-repo}/tree/master

:uri-docs: {uri-rel-file-base}/docs

:uri-changelog: {uri-rel-file-base}/CHANGELOG.adoc

:uri-contribute: {uri-rel-file-base}/CONTRIBUTING.adoc :uri-contributors: {uri-rel-file-base}/CONTRIBUTORS.adoc

:uri-instance-principal: {uri-docs}/instanceprincipal.adoc

:uri-license: {uri-rel-file-base}/LICENSE :uri-canonical-license: https://oss.oracle.com/licenses/upl/ :uri-networks-subnets-cidr: https://erikberg.com/notes/networks.html :uri-oci: https://cloud.oracle.com/cloud-infrastructure :uri-oci-documentation: https://docs.cloud.oracle.com/iaas/Content/home.htm :uri-ons: {uri-docs}/notifications.adoc :uri-oracle: https://www.oracle.com :uri-prereqs: {uri-docs}/prerequisites.adoc :uri-quickstart: {uri-docs}/quickstart.adoc :uri-reuse-module: {uri-rel-tree-base}/examples/database :uri-terraform: https://www.terraform.io :uri-terraform-cidrsubnet-deconstructed: http://blog.itsjustcode.net/blog/2017/11/18/terraform-cidrsubnet-deconstructed/ :uri-terraform-hashircorp-examples: https://github.com/hashicorp/terraform-guides/tree/master/infrastructure-as-code/terraform-0.12-examples :uri-terraform-oci: https://www.terraform.io/docs/providers/oci/index.html :uri-terraform-options: {uri-docs}/terraformoptions.adoc :uri-terraform-oci-examples: https://github.com/terraform-providers/terraform-provider-oci/tree/master/examples :uri-terraform-oci-oke: https://github.com/oracle-terraform-modules/terraform-oci-oke

The {uri-repo}[Terraform OCI Base module] for {uri-oci}[Oracle Cloud Infrastructure] (OCI) provides a reusable Terraform module that provisions a minimal infrastructure on OCI.

It creates the following resources:

• A VCN, along with optional NAT, Internet and service gateways
• An optional bastion host

The module can be reused to create more advanced infrastructure on {uri-oci}[OCI] either manually in the OCI Console or by extending the Terraform code.

== {uri-docs}[Documentation]

• {uri-prereqs}[Pre-requisites]

• Instructions ** {uri-quickstart}[Provisioning a basic infrastructure (Quickstart)] ** {uri-reuse-module}[Reusing as a Terraform module] ** {uri-instance-principal}[Enabling instance_principal] ** {uri-ons}[Using ONS Notification]

• {uri-terraform-options}[Terraform Options]

== Related Documentation, Blog

• {uri-oci-documentation}[Oracle Cloud Infrastructure Documentation]
• {uri-terraform-oci}[Terraform OCI Provider Documentation]
• {uri-networks-subnets-cidr}[Erik Berg on Networks, Subnets and CIDR]
• {uri-terraform-cidrsubnet-deconstructed}[Lisa Hagemann on Terraform cidrsubnet Deconstructed]

== Projects using this module

• {uri-terraform-oci-oke}[terraform-oci-oke]

== Changelog

View the {uri-changelog}[CHANGELOG].

== Acknowledgement

Code derived and adapted from {uri-terraform-oci-examples}[Terraform OCI Examples] and Hashicorp's {uri-terraform-hashircorp-examples}[Terraform 0.12 examples]

== Contributors

{uri-contributors}[Folks who contributed with explanations, code, feedback, ideas, testing etc.]

Learn how to {uri-contribute}[contribute].

== License

Copyright © 2019 Oracle and/or its associates. All rights reserved.

Licensed under the {uri-license}[Universal Permissive License 1.0] as shown at {uri-canonical-license}[https://oss.oracle.com/licenses/upl].