https://github.com/oracle-quickstart/oci-freebsd
FreeBSD
https://github.com/oracle-quickstart/oci-freebsd
Last synced: 4 months ago
JSON representation
FreeBSD
- Host: GitHub
- URL: https://github.com/oracle-quickstart/oci-freebsd
- Owner: oracle-quickstart
- License: apache-2.0
- Created: 2022-06-09T20:35:23.000Z (about 3 years ago)
- Default Branch: master
- Last Pushed: 2022-06-10T00:13:38.000Z (about 3 years ago)
- Last Synced: 2024-12-29T20:15:47.434Z (6 months ago)
- Language: HCL
- Size: 379 KB
- Stars: 1
- Watchers: 2
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# FreeBSD Use Case - Reference Architecture
We are deploying FreeBSD VM from OCI Marketplace in a Virtual Cloud Network with Internet Connectivity.
## Architecture Diagram
## Validated Version Details
We have validated **13.1** FreeBSD Version for this architecture.
## Prerequisites
You should complete below pre-requisites before proceeding to next section:
- You have an active Oracle Cloud Infrastructure Account.
- Tenancy OCID, User OCID, Compartment OCID, Private and Public Keys are setup properly.
- Permission to `manage` the following types of resources in your Oracle Cloud Infrastructure tenancy: `vcns`, `internet-gateways`, `route-tables`, `security-lists`,`dynamic-routing-gateways`, `subnets` and `instances`.
- Quota to create the following resources: 1 VCNS, 1 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).
## Deployment Options
You can deploy this architecture using two approach explained in each section:
1. Using Oracle Resource Manager
2. Using Terraform CLI
## Deploy Using Oracle Resource Manager
In this section you will follow each steps given below to create this architecture:
1. Click [](https://console.us-phoenix-1.oraclecloud.com/resourcemanager/stacks/create?region=home&zipUrl=https://github.com/oracle-quickstart/oci-freebsds/raw/master/resource-manager/freebsd.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** from the stack on OCI console UI.
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**.
8. At this stage your architecture should have been deployed successfully. You can proceed to next section for configuring your FreeBSD VM.
9. If you no longer require your infrastructure, return to the Stack Details page and **Terraform Actions**, and select **Destroy**.
## Deploy Using the Terraform CLI
In this section you will use **Terraform** locally to create this architecture:
1. Create a local copy of this repo using below command on your terminal:
```
git clone https://github.com/oracle-quickstart/oci-freebsd.git
cd oci-freebsd/
ls
```
2. Complete the prerequisites described [here] which are associated to install **Terraform** locally:(https://github.com/oracle-quickstart/oci-prerequisites#install-terraform).
Make sure you have terraform v0.13+ cli installed and accessible from your terminal.
```bash
terraform -v
Terraform v0.13.0
+ provider.oci v4.14.0
```
3. Create a `terraform.tfvars` file in your **freebsd** directory, and specify the following variables:
```
# Authentication
tenancy_ocid = ""
user_ocid = ""
fingerprint = ""
private_key_path = ""
# SSH Keys
ssh_public_key = ""
# Region
region = ""
# Compartment
compute_compartment_ocid = ""
network_compartment_ocid = ""
availability_domain_number = "
````
4. Create the Resources using the following commands:
```bash
terraform init
terraform plan
terraform apply
```
5. At this stage your architecture should have been deployed successfully. You can proceed to next section for configuring your FreeBSD Configuration.
6. If you no longer require your infrastructure, you can run this command to destroy the resources:
```bash
terraform destroy
```
## FreeBSD Configuration
**Update this Section**
## Feedback
Feedbacks are welcome to this repo, please open a PR if you have any.