https://github.com/oracle-quickstart/oci-asp-net
https://github.com/oracle-quickstart/oci-asp-net
oracle-led
Last synced: 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/oracle-quickstart/oci-asp-net
- Owner: oracle-quickstart
- License: upl-1.0
- Archived: true
- Created: 2021-03-05T02:37:28.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2021-07-28T14:08:34.000Z (almost 4 years ago)
- Last Synced: 2025-02-19T21:12:50.501Z (4 months ago)
- Topics: oracle-led
- Language: HCL
- Homepage:
- Size: 1.7 MB
- Stars: 4
- Watchers: 6
- Forks: 8
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ASP .NET applications on OCI
This repository provides a minimal example of how to quickly setup an automated deployment pipeline for ASP .NET applications on Oracle Cloud Infrastructure. Here we showcase a simple ASP .NET application, and provide the scaffolding to
- Create the target infrastructure using automation
- Automate the build process based on source control triggers
- Deploy the application after a build to the target infrastructure.
## The Example Application
The example application is a simple ASP.NET sample that can be replaced with your own applications of any complexity. The processes to automate the build and the deployment of the application remains the same and is the core focus of this project.
## Build and Deployment Automation
To demonstrate build and deployment automation while keeping dependencies to a minimum, this project uses GitHub workflows as the build and deployment tool. The same processes or commands can be executed from any build and deployment system to get similar results.
In this example, the build is triggered by a commit to the repository or a pull request. The workflow when triggered, will build the application. The built binaries are packaged and terraform is started to update the infrastructure and deploy the application. The OCI API key are managed as GitHub secrets.
### Authenticating against your own Tenancy
Once you clone this repository, you need to configure your API keys before you can successfully deploy an application on to your own tenancy. These API keys lets the automation authenticate against your tenancy and perform the deployment of infrastructure resources or applications. Once you cone this repository, perform these steps to setup your API key :
- Navigate to **Settings > Secrets**
- Click on **New Repository Secret**
- Add your OCI key as `OCI_KEY_FILE`
- Update the `terraform.tfvars` file with your tenancy information.
## Infrastructure Automation
This project uses Terraform and Oracle Resource Manager, a service on OCI that can manage your terraform based deployments for development teams. While the use of Resource Manager is optional, it is highly recommended for development teams.
The infrastructure is expressed as code and terraform, through the Oracle resource manager, creates, updates or destroys the infrastructure components based on the configurations expresses though the terraform code. This also implicitly version controls infrastructure changes as well, making it easier to track changes to infrastructure and the associated code changes (since infrastructure is managed as code).
### Deploy Using Oracle Resource Manager
To deploy this solution using Oracle Resource Manager, click on the deployment button below to start the deployment in your oracle cloud infrastructure tenancy.
[](https://cloud.oracle.com/resourcemanager/stacks/create?region=home&zipUrl=https://github.com/oracle-quickstart/oci-asp-net/releases/latest/download/oci-asp-net-stack-latest.zip)
Alternatively, you can download the stack for this solution from the **Releases** a section of this repository. Navigate to Oracle resource manager in the Oracle Cloud Infrastructure console. Here import the zip file as a new resource manager stack. You can now perform terraform actions like plan or 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-asp-net.git
cd oci-asp-net
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 = ""
```
You also need to uncomment the following lines in the `provider.tf`.
```
user_ocid = var.user_ocid
fingerprint = var.fingerprint
private_key_path = var.private_key_path
```
#### Create the Resources
Run the following commands:
terraform init
terraform plan
terraform apply
#### Testing your Deployment
After the deployment is finished, you can access the test ASP.NET Application using the loadbalancer IP address which is created as an output key called lb_public_ip.
````
lb_public_ip = 193.122.198.19
`````
### Destroy the Deployment
When you no longer need the deployment, you can run this command to destroy the resources:
terraform destroy