The Oracle Cloud Infrastructure (OCI) Quick Start is a collection of examples that allow Oracle Cloud Infrastructure users to get a quick start deploying advanced infrastructure on OCI. This repository contains Terraform scripts specific to the Oracle Database@Azure service.
This repository is under active development. Building open source software is a community effort. We're excited to engage with the community building this.
A repository contains a collection of terraform modules and templates that helps an Azure administrator configure an Azure environment for Oracle Database@Azure and provision database related components (Exadata hardware, Virtual Machine (VM) Clusters, and databases) in Azure.
A user can apply the terraform plans from any computer that has connectivity to both Azure and OCI.
To use the Terraform modules and templates in your environment, you must install the following software on the system from which you execute the terraform plans:
- Terraform
- Alternate OpenTofu
- Python 3.x (min version 3.4) with packages
- pip
- venv
- (venv) virtual env is recommended (not mandatory) to install python packages for oci-identity-provider/scripts/requirements.txt
- Azure CLI - How to install the Azure CLI
- OCI CLI - Quickstart
- Setup OCI-CLI to authenticate to your tenancy
- Create a token auth profile in your oci config with
<MY_PROFILE_NAME>
Dependent which cloud resources a module manages, it will use some subset of the terraform cloud providers:
- OCI terraform provider
- In this template example use OCI provider
SecurityTokenauth method, other acceptable provider implementation are described in OCI terraform provider configuration doc
- In this template example use OCI provider
- azuread terraform provider
- azurerm terraform provider
These module automates the provisioning of components for running Oracle Database@Azure. Each template can run independently and default input values are configured which can be overridden per customer's preferences.
templates/az-oci-sso-federation: Configures Single Sign-on (SSO) Between OCI and Microsoft Azure with identity federation.templates/az-oci-rbac-n-sso-fed: Configures SSO Between OCI and Microsoft Azure with identity federation And role, groups required for Oracle Database@Azure.templates/az-odb-rbac: Creates Roles and Groups required for for Oracle Database@Azure.templates/az-oci-exa-pdb: Provisions Oracle database infrastructure including networks, Exadata Infrastructure, VM Cluster, and database.
Please read the individual template documentation for more details.
You must authenticate to your oci tenancy with config auth profile as <MY_PROFILE_NAME>. All available OCI regions are defined in Regions and Availability Domains.
oci session authenticate --region=<MY_REGION_IDENTIFIER> --profile-name=<MY_PROFILE_NAME>Example:
oci session authenticate --region=us-ashburn-1 --profile-name=ONBOARDINGOfficial Microsoft documentation to authenticate to Azure using Azure CLI
az login --tenant <azure-tenant-id>Navigate into the templates directory.
Note: The Terraform state file writes to the directory from where you execute plans. You should keep this file in case you want to use Terraform to modify the environment configuration later. Refer to the Terraform documentation for more persistent and shareable ways to save state.
Input variable can be set in the Variable Definitions file (e.g. terraform.tfvars) or through the command line or environment variables:
config_file_profile="<MY_PROFILE_NAME>"
compartment_ocid="<MY_OCI_TENANCY_ID>"
region="<MY_REGION_IDENTIFIER>"or via Command Line
terraform plan -var="config_file_profile=<MY_PROFILE_NAME>" -var="compartment_ocid=<MY_OCI_TENANCY_ID>" -var="region=<MY_REGION_IDENTIFIER>"or via Environment Variables
export TF_VAR_config_file_profile="<MY_PROFILE_NAME>"
export TF_VAR_compartment_ocid="<MY_OCI_TENANCY_ID>"
export TF_VAR_region="<MY_REGION_IDENTIFIER>"When running for first time, initialize the workspace directory using:
Terraform:
terraform initOpenTofu:
tofu initTo validate changes described without applying
Terraform:
terraform planOpenTofu:
tofu planTo apply changes and create resources
Terraform:
terraform applyOpenTofu:
tofu applyTo remove all resources created in above steps, run destroy:
Terraform:
terraform destroyOpenTofu:
tofu destroyAcknowledgement: Code derived adapted from samples, examples and documentations provided by above mentioned providers.
Open an issue in this repository.
This project welcomes contributions from the community. Before submitting a pull request, please review our contribution guide.
Please consult the security guide for our responsible security vulnerability disclosure process.
Copyright (c) 2024 Oracle and/or its affiliates.
Released under the Universal Permissive License v1.0 as shown at https://oss.oracle.com/licenses/upl/.