Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/oracle-quickstart/oci-cockroachdb
Terraform code to deploy CockroachDB on Oracle Cloud Infrastructure (OCI)
https://github.com/oracle-quickstart/oci-cockroachdb
cloud cockroach cockroachdb oci oracle partner-led terraform
Last synced: about 14 hours ago
JSON representation
Terraform code to deploy CockroachDB on Oracle Cloud Infrastructure (OCI)
- Host: GitHub
- URL: https://github.com/oracle-quickstart/oci-cockroachdb
- Owner: oracle-quickstart
- License: apache-2.0
- Created: 2019-05-09T18:54:56.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2021-06-22T10:41:14.000Z (over 3 years ago)
- Last Synced: 2023-03-04T11:58:59.260Z (over 1 year ago)
- Topics: cloud, cockroach, cockroachdb, oci, oracle, partner-led, terraform
- Language: HCL
- Homepage:
- Size: 1.92 MB
- Stars: 3
- Watchers: 14
- Forks: 6
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Security: security-lists.tf
Awesome Lists containing this project
README
# oci-cockroachdb
This is a Terraform code that deploys [CockroachDB](https://www.cockroachlabs.com/) on [Oracle Cloud Infrastructure (OCI)](https://cloud.oracle.com/en_US/cloud-infrastructure). It is developed jointly by Oracle and Cockroach Labs.
This reference architecture shows a typical three-node deployment of CockroachDB on Oracle Cloud Infrastructure Compute instances. A public load balancer is used to distribute the workloads across these three nodes.
For details of the architecture, see [_Deploy a highly available CockroachDB cluster_](https://docs.oracle.com/en/solutions/ha-cockroachdb-cluster)
## Prerequisites
- Permission to `manage` the following types of resources in your Oracle Cloud Infrastructure tenancy: `vcns`, `internet-gateways`, `route-tables`, `security-lists`, `subnets`, and `instances`.
- Quota to create the following resources: 1 VCN, 1 subnet, 1 Internet Gateway, 1 route rules, 1 Load Balancer, and 3 CockroachDB compute instances.
If you don't have the required permissions and quota, contact your tenancy administrator. See [Policy Reference](https://docs.cloud.oracle.com/en-us/iaas/Content/Identity/Reference/policyreference.htm), [Service Limits](https://docs.cloud.oracle.com/en-us/iaas/Content/General/Concepts/servicelimits.htm), [Compartment Quotas](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/resourcequotas.htm).
## Deploy Using Oracle Resource Manager
1. Click [](https://cloud.oracle.com/resourcemanager/stacks/create?region=home&zipUrl=https://github.com/oracle-quickstart/oci-cockroachdb/releases/latest/download/oci-cockroachdb-stack-latest.zip)
If you aren't already signed in, when prompted, enter the tenancy and user credentials.
2. Review and accept the terms and conditions.
3. Select the region where you want to deploy the stack.
4. Follow the on-screen prompts and instructions to create the stack.
5. After creating the stack, click **Terraform Actions**, and select **Plan**.
6. 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.
7. 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-quickstart/oci-cockroachdb
cd oci-cockroachdb
ls
### Prerequisites
First off, you'll need to do some pre-deploy setup. That's all detailed [here](https://github.com/cloud-partners/oci-prerequisites).
Secondly, create a `terraform.tfvars` file and populate with the following information:
```
# Authentication
tenancy_ocid = ""
user_ocid = ""
fingerprint = ""
private_key_path = ""
# Region
region = ""
# Availablity Domain
availablity_domain_name = "" # for example GrCH:US-ASHBURN-AD-1
# Compartment
compartment_ocid = ""
````
### Create the Resources
Run the following commands:
terraform init
terraform plan
terraform apply
### Verify the Deployment
Copy loadbalancer_public_url output and verify the access with your web browser:
### Destroy the Deployment
When you no longer need the deployment, you can run this command to destroy the resources:
terraform destroy
## Architecture Diagram
