https://github.com/oracle-quickstart/oci-arch-tomcat-mds
Terraform to deploy Apache Tomcat on OCI
https://github.com/oracle-quickstart/oci-arch-tomcat-mds
oracle-led
Last synced: 12 days ago
JSON representation
Terraform to deploy Apache Tomcat on OCI
- Host: GitHub
- URL: https://github.com/oracle-quickstart/oci-arch-tomcat-mds
- Owner: oracle-quickstart
- License: upl-1.0
- Archived: true
- Created: 2020-10-12T21:50:00.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2021-10-05T16:22:06.000Z (over 3 years ago)
- Last Synced: 2025-02-19T21:12:39.008Z (2 months ago)
- Topics: oracle-led
- Language: HCL
- Homepage:
- Size: 1.01 MB
- Stars: 4
- Watchers: 5
- Forks: 14
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# oci-arch-tomcat-mds
Apache Tomcat® is an open source Java application server. It implements the Java Servlet, JavaServer Pages, Java Expression Language and Java WebSocket technologies.
MySQL Database Service is a fully-managed Oracle Cloud Infrastructure native service. It's developed, managed, and supported by the MySQL team at Oracle. Tasks such as backup and recovery, database and operating system patching, and so on are automated. You are responsible solely for managing your data, schema designs, and access policies.
## Prerequisites
- Permission to `manage` the following types of resources in your Oracle Cloud Infrastructure tenancy: `vcns`, `internet-gateways`, `route-tables`, `network-security-groups`, `subnets`, `mysql-family`, and `instances`.
- Quota to create the following resources: 1 VCN, 3 subnets, 1 Internet Gateway, 1 NAT Gateway, 2 route rules, 1 MDS instance, and 3 compute instances (bastion host + 2 Tomcat servers).
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-arch-tomcat-mds/releases/latest/download/oci-arch-tomcat-mds-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-arch-tomcat-mds.git
cd oci-arch-tomcat-mds
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).
Create a `terraform.tfvars` file, and specify the following variables:
```
# Authentication
tenancy_ocid = ""
user_ocid = ""
fingerprint = ""
private_key_path = ""
# Region
region = ""
# Availablity Domain
availablity_domain_name = ""
# Compartment
compartment_ocid = ""
# Number of Tomcat nodes (optional)
numberOfNodes = 2
# MySQL DBSystem Admin Password
mysql_db_system_admin_password = ""
````
### Create the Resources
Run the following commands:
terraform init
terraform plan
terraform apply
### Testing your Deployment
After the deployment is finished, you can test that your Tomcat was deployed correctly and can access the tomcat demo application with MDS as database system. Pick up the value of the todoapp_url:
````
todoapp_url = http://193.122.204.54/todoapp/list
`````
Then copy it into Web browser. Here is the example of the succesfull outcome:
As the load balancer alternates between the 2 Tomcat nodes, the session data should persist.
### Destroy the Deployment
When you no longer need the deployment, you can run this command to destroy the resources:
terraform destroy
## Architecture Diagram
## Reference Archirecture
For details of the architecture, see [_Deploy Apache Tomcat connected to MySQL Database Service_](https://docs.oracle.com/en/solutions/deploy-tomcat-mysql/index.html)