srinatar / terraform-provider-baremetal

Terraform provider for Oracle Bare Metal Cloud Services

Home Page:https://console.us-phoenix-1.oraclecloud.com/

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

#     ___  ____     _    ____ _     _____
#    / _ \|  _ \   / \  / ___| |   | ____|
#   | | | | |_) | / _ \| |   | |   |  _|  
#   | |_| |  _ < / ___ | |___| |___| |___
#    \___/|_| \_/_/   \_\____|_____|_____|

Terraform provider for Oracle Bare Metal Cloud Services

Oracle customers now have access to an enterprise class, developer friendly orchestration tool they can use to manage Oracle Bare Metal Cloud Service resources as well as the Oracle Compute Cloud.

This Terraform provider is OSS, available to all OBMCS customers at no charge.

<<<<<<< HEAD

Ready to go right now? Get into the details right here.

b138c42f8af0008f6e01c2a7333a372a4ade6853

Coverage

The Terraform provider provides coverage for the entire BMC API excluding the Load Balancer Service, expected March 1 2017.

Getting started

Be sure to read the FAQ and Writing Terraform configurations for OBMCS in /docs.

Install Terraform

https://www.terraform.io/downloads.html

Download the OBMCS Terraform provider binary

Find the appropriate binary for your platform here, download it.

*nix

Create ~/.terraformrc that specifies the path to the baremetal provider.

providers {
  baremetal = "<path_to_provider_binary>"
  }

Windows

Create %APPDATA%/terraform.rc that specifies the path to the baremetal provider.

providers {
  baremetal = "<path_to_provider_binary>"
  }

Export credentials

Required Keys and OCIDs - https://docs.us-phoenix-1.oraclecloud.com/Content/API/Concepts/apisigningkey.htm

If you primarily work in a single compartment consider exporting that compartment's OCID as well. Remember that the tenancy OCID is also the OCID of the root compartment.

*nix

In your ~/.bash_profile set these variables
export TF_VAR_tenancy_ocid=
export TF_VAR_user_ocid=
export TF_VAR_fingerprint=
export TF_VAR_private_key_path=<fully qualified path>
export TF_VAR_private_key_password=

Don't forget to source ~/.bash_profile once you've set these.

Windows

setx TF_VAR_tenancy_ocid <value>
setx TF_VAR_user_ocid <value>
setx TF_VAR_fingerprint <value>
setx TF_VAR_private_key_path <value>
setx TF_VAR_private_key_password <value>

The variables won't be set for the current session, exit the terminal and reopen.

Deploy an example configuration

<<<<<<< HEAD Download the VCN example configuration.

Download the complete VCN example configuration.

b138c42f8af0008f6e01c2a7333a372a4ade6853

Edit it to include the OCID of the compartment you want to create the VCN. Remember that the tenancy OCID is the compartment OCID of your root compartment.

You should always plan, then apply a configuration -

$ terraform plan ./simple_vcn
# Make sure the plan looks right.
$ terraform apply ./simple_vcn

OBMC resource and datasource details

https://github.com/oracle/terraform-provider-baremetal/tree/master/docs

Getting help

You can file an issue against the project
https://github.com/oracle/terraform-provider-baremetal/issues

or meet us in the OBMCS forums
https://community.oracle.com/community/cloud_computing/bare-metal

Known bugs

Key passphrase

The private key you use for API access must have a passphrase to work with Terraform. You can add a passphrase to your existing key with ssh-keygen -p -f <private key>.

If you don't want to apply a passphrase to the version of the key you don't use with Terraform you can copy the key first -

cp <private key> <private key>.pass    
ssh-keygen -p -f <private key>.pass

DB Systems timeout

DB Systems can take up to an hour to provision. Terraform times out after 5 minutes. Ensure the DB System is the last resource you provision in a configuration.

<<<<<<< HEAD

Block volumes

The size of a block volume cannot be specified, volumes created by Terraform are 256GB.

b138c42f8af0008f6e01c2a7333a372a4ade6853

About the provider

This provider was written on behalf of Oracle by MustWin.

About

Terraform provider for Oracle Bare Metal Cloud Services

https://console.us-phoenix-1.oraclecloud.com/

License:Other


Languages

Language:Go 99.3%Language:Shell 0.5%Language:HCL 0.1%Language:Makefile 0.1%