https://github.com/oracle-devrel/terraform-oci-arch-hub-spoke
Set up a hub-and-spoke network topology.
https://github.com/oracle-devrel/terraform-oci-arch-hub-spoke
Last synced: about 15 hours ago
JSON representation
Set up a hub-and-spoke network topology.
- Host: GitHub
- URL: https://github.com/oracle-devrel/terraform-oci-arch-hub-spoke
- Owner: oracle-devrel
- License: upl-1.0
- Created: 2021-11-03T18:36:54.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2025-01-21T20:10:17.000Z (over 1 year ago)
- Last Synced: 2026-04-21T14:32:33.869Z (2 months ago)
- Language: HCL
- Size: 183 KB
- Stars: 3
- Watchers: 2
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.txt
- Security: SECURITY.md
Awesome Lists containing this project
README
# terraform-oci-arch-hub-spoke
A hub-and-spoke network (often called star topology) has a central component (the hub) that's connected to multiple networks around it, like a wheel. Implementing this topology in the traditional data center can be costly. But in the Oracle Cloud, there’s no extra cost.
For details of the architecture, see [_Set up a hub-and-spoke network topology_](https://docs.oracle.com/en/solutions/hub-spoke-network/index.html).
## Prerequisites
- Permission to `manage` the following types of resources in your Oracle Cloud Infrastructure tenancy: `vcns`, `internet-gateways`, `route-tables`, `security-lists`, `local-peering-gateways`, `subnets`, and `instances`.
- Quota to create the following resources: 3 VCNS, 3 subnets, and 1 compute instance.
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-devrel/terraform-oci-arch-hub-spoke/releases/latest/download/terraform-oci-arch-hub-spoke-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
Create a local copy of this repository:
git clone https://github.com/oracle-devrel/terraform-oci-arch-hub-spoke.git
cd terraform-oci-arch-hub-spoke
ls
### Set Up and Configure Terraform
1. Complete the prerequisites described [here](https://github.com/cloud-partners/oci-prerequisites).
2. Create a `terraform.tfvars` file, and specify the following variables:
```
# Authentication
tenancy_ocid = ""
user_ocid = ""
fingerprint = ""
private_key_path = ""
# Region
region = ""
# Compartment
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-hub-spoke" {
source = "github.com/oracle-devrel/terraform-oci-arch-hub-spoke"
tenancy_ocid = ""
user_ocid = ""
fingerprint = ""
region = ""
private_key_path = ""
}
```
## 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](https://github.com/oracle-quickstart/oci-arch-hub-spoke). For that reason, we would like to thank all the involved contributors enlisted below:
- Orlando Gentil (https://github.com/oegentil)
- Kumar Dhanagopal (https://github.com/kumar-dhanagopal)
- Lukasz Feldman (https://github.com/lfeldman)
- Ben Lackey (https://github.com/benofben)
- Flavio Pereira (https://github.com/flavio-santino)
## License
Copyright (c) 2024 Oracle and/or its affiliates.
Licensed under the Universal Permissive License (UPL), Version 1.0.
See [LICENSE](LICENSE.txt) for more details.