https://github.com/oracle-devrel/terraform-oci-arch-spring-boot
terraform-oci-arch-spring-boot
https://github.com/oracle-devrel/terraform-oci-arch-spring-boot
Last synced: about 3 hours ago
JSON representation
terraform-oci-arch-spring-boot
- Host: GitHub
- URL: https://github.com/oracle-devrel/terraform-oci-arch-spring-boot
- Owner: oracle-devrel
- License: upl-1.0
- Created: 2021-11-24T19:31:11.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2025-01-21T20:13:37.000Z (over 1 year ago)
- Last Synced: 2026-04-21T14:40:37.661Z (2 months ago)
- Language: HCL
- Size: 338 KB
- Stars: 2
- Watchers: 2
- Forks: 1
- 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-spring-boot
SpringBoot is an open source, Java-based framework that you can use to create production grade applications. SpringBoot simplifies the deployment of applications with minimal configuration and customization and includes third-party libraries to streamline the process.
MySQL Database service is a managed Database service on Oracle Cloud Infrastructure. In this deployment we will deploy 3 node cluster(app server) along with a Load Balancer and MySQL Database service.
## Terraform Provider for Oracle Cloud Infrastructure
The OCI Terraform Provider is now available for automatic download through the Terraform Provider Registry.
For more information on how to get started view the [documentation](https://www.terraform.io/docs/providers/oci/index.html)
and [setup guide](https://www.terraform.io/docs/providers/oci/guides/version-3-upgrade.html).
* [Documentation](https://www.terraform.io/docs/providers/oci/index.html)
* [OCI forums](https://cloudcustomerconnect.oracle.com/resources/9c8fa8f96f/summary)
* [Github issues](https://github.com/terraform-providers/terraform-provider-oci/issues)
* [Troubleshooting](https://www.terraform.io/docs/providers/oci/guides/guides/troubleshooting.html)
## Prerequisites
- Permission to `manage` the following types of resources in your Oracle Cloud Infrastructure tenancy: `vcns`, `internet-gateways`, `route-tables`, `network-security-groups`, `subnets`, and `instances`.
- Quota to create the following resources: 2 VCN, 4 subnets, 1 Internet Gateway, 2 route rules, and 4 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)
- OCID of compartments with Security Zone and without Security Zone enabled
## 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-spring-boot/releases/latest/download/terraform-oci-arch-spring-boot-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 and initialize
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-spring-boot
cd terraform-oci-arch-spring-boot
ls
You'll need to do some pre-deploy setup. That's all detailed [here](https://github.com/cloud-partners/oci-prerequisites).
Initialize them in `terraform.tfvars` file and populate with the following information:
```
# Authentication
tenancy_ocid = <"">
user_ocid = <"">
fingerprint = <"">
private_key_path = <"">
# SSH Keys
ssh_public_key = "id_rsa.pub"
ssh_private_key = "id_rsa"
# Region
region = "us-ashburn-1"
# Compartment
compartment_ocid = <""> (Compartment without Security Zones enabled)
compartment_SZ_ocid = <""> (Compartment with Security Zones enabled)
mysql_db_system_admin_password = <"">
```
NOTE: There are other variables that are assigned default value such as VCN CIDR and others. These can be changed in variables.tf file
Deploy:
terraform init
terraform plan
terraform apply
### Testing your Deployment
After the deployment is finished, you can test if your SpringBoot application has deployed correctly and can access picking up the value of the springboot_app_url:
````
springboot_app_url = http://150.230.171.250/api/v1/customer
`````
Then copy it into Web browser. Here is the example of the succesfull outcome:
## Destroy the Deployment
When you no longer need the deployment, you can run this command to destroy it:
terraform destroy
## Deploy the Spring Boot framework on Oracle Cloud Infrastructure with MySQL Database Service
## Reference Architecture
- [Deploy the Spring Boot framework on Oracle Cloud Infrastructure with MySQL Database Service](https://docs.oracle.com/en/solutions/springboot-mysql-oci/)
## 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-redis). For that reason, we would like to thank all the involved contributors enlisted below:
- Flavio Pereira (https://github.com/flavio-santino)
- Lukasz Feldman (https://github.com/lfeldman)
- Umair Siddiqui (https://github.com/umairs123)
## 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.