terraform-oci-arch-autoscaling
Autoscaling ensures that your resources in the cloud are utilized efficiently and available when required. You can configure your cloud deployment to automatically adjust the compute resources based on performance metrics, such as CPU utilization. So your end users experience consistent performance even when the load is high. And your costs are proportionately low during periods of low demand.
This reference architecture shows a 3-tier topology consisting of a load balancer (LB), an autoscaling web tier, and a highly available database.
For details of the architecture, see Autoscale a load-balanced web application
Prerequisites
-
Permission to
manage
the following types of resources in your Oracle Cloud Infrastructure tenancy:vcns
,internet-gateways
,route-tables
,network-security-groups
,subnets
,autonomous-database-family
, andinstances
. -
Quota to create the following resources: 1 VCN, 2 subnets, 1 Internet Gateway, 1 NAT Gateway, 2 route rules, 1 LoadBalancer, 1 ATP database instance (+ optional standby), and 3 compute instances (plus max 2 more as a result of autoscaling).
If you don't have the required permissions and quota, contact your tenancy administrator. See Policy Reference, Service Limits, Compartment Quotas.
Deploy Using Oracle Resource Manager
-
If you aren't already signed in, when prompted, enter the tenancy and user credentials.
-
Review and accept the terms and conditions.
-
Select the region where you want to deploy the stack.
-
Follow the on-screen prompts and instructions to create the stack.
-
After creating the stack, click Terraform Actions, and select Plan.
-
Wait for the job to be completed, and review the plan.
To make any changes, return to the Stack Details page, click Edit Stack, and make the required changes. Then, run the Plan action again.
-
If no further changes are necessary, return to the Stack Details page, click Terraform Actions, and select Apply.
Deploy Using the Terraform CLI
Clone the Module
Now, you'll want a local copy of this repo. You can make that with the commands:
git clone https://github.com/oracle-devrel/terraform-oci-arch-autoscaling.git
cd terraform-oci-arch-autoscaling
ls
Set Up and Configure Terraform
-
Complete the prerequisites described here.
-
Create a
terraform.tfvars
file, and specify the following variables:
# Authentication
tenancy_ocid = "<tenancy_ocid>"
user_ocid = "<user_ocid>"
fingerprint = "<finger_print>"
private_key_path = "<pem_private_key_path>"
# database
ATP_password = "<ATP_user_password>"
# Region
region = "<oci_region>"
# Compartment
compartment_ocid = "<compartment_ocid>"
Create the Resources
Run the following commands:
terraform init
terraform plan
terraform apply
Destroy the Deployment
When you no longer need the deployment, you can run this command to destroy the resources:
terraform destroy
Deploy as a Module
It's possible to utilize this repository as remote module, providing the necessary inputs:
module "oci-arch-autoscaling" {
source = "github.com/oracle-devrel/terraform-oci-arch-autoscaling"
tenancy_ocid = "<tenancy_ocid>"
user_ocid = "<user_ocid>"
fingerprint = "<user_ocid>"
region = "<oci_region>"
private_key_path = "<private_key_path>"
compartment_ocid = "<compartment_ocid>"
ATP_password = "<ATP_password>"
}
Architecture Diagram
Contributing
This project is open source. Please submit your contributions by forking this repository and submitting a pull request! Oracle appreciates any contributions that are made by the open source community.
Attribution & Credits
Initially, this project was created and distributed in GitHub Oracle QuickStart space. For that reason, we would like to thank all the involved contributors enlisted below:
- Lukasz Feldman (https://github.com/lfeldman)
- Flavio Pereira (https://github.com/flavio-santino)
License
Copyright (c) 2021 Oracle and/or its affiliates.
Licensed under the Universal Permissive License (UPL), Version 1.0.
See LICENSE for more details.