Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/oracle-quickstart/oci-cloudnative

MuShop - Cloud Native microservices demo for Oracle Cloud Infrastructure
https://github.com/oracle-quickstart/oci-cloudnative

always-free cloud cloud-native-microservices cloudnative free-tier hacktoberfest microservice mushop oci oracle-cloud-infrastructure oracle-led terraform

Last synced: 1 day ago
JSON representation

MuShop - Cloud Native microservices demo for Oracle Cloud Infrastructure

Awesome Lists containing this project

README 

        
# ![MuShop Logo](./images/logo.png#gh-light-mode-only)![MuShop Logo - Dark Mode](./images/logo-inverse.png#gh-dark-mode-only)



MuShop is a showcase of several [Oracle Cloud Infrastructure][oci] services in a unified reference application. The sample application implements an e-commerce platform built as a set of micro-services. The accompanying content can be used to get started with cloud native application development on [Oracle Cloud Infrastructure][oci].



| ![home](./images/screenshot/mushop.home.png) | ![browse](./images/screenshot/mushop.browse.png) | ![cart](./images/screenshot/mushop.cart.png) | ![about](./images/screenshot/mushop.about.png) |

|---|---|---|---|



MuShop can be deployed in different ways to explore [Oracle Cloud Infrastructure][oci] based on your subscription. Both deployment models can be used with trial subscriptions. However, [Oracle Cloud Infrastructure][oci] offers an *Always Free* tier with resources that can be used indefinitely.



| [Basic: `deploy/basic`](#Getting-Started-with-MuShop-Basic) | [Complete: `deploy/complete`](#Getting-Started-with-MuShop-Complete) |

|---|---|

| Simplified runtime utilizing **only** [Always Free](https://www.oracle.com/cloud/free/) eligible resources. 

 Deploy using: 
  1. [Terraform][tf] 
  2. [Resource Manager][orm_landing] following the steps below 
  3. (Recommended) Button below - launches in Resource Manager directly | Polyglot set of micro-services deployed on [Kubernetes](https://kubernetes.io/), showcasing [Oracle Cloud Native](https://www.oracle.com/cloud/cloud-native/) technologies and backing services. 

 Deploy using: 
  1. [Helm](https://helm.sh) 
 2. [Terraform][tf] 
  3. [Resource Manager][orm_landing] 
  4. (Recommended) Button below - launches in Resource Manager directly |

| [![Deploy to Oracle Cloud][magic_button]][magic_mushop_basic_stack]| [![Deploy to Oracle Cloud][magic_button]][magic_mushop_stack]|



```text

mushop

└── deploy

    ├── basic

    └── complete

```



## Getting Started with MuShop Basic



This is a Terraform configuration that deploys the MuShop basic sample application on [Oracle Cloud Infrastructure][oci] and is designed to run using only the Always Free tier resources.



The repository contains the application code as well as the [Terraform][tf] code to create a [Resource Manager][orm] stack, that creates all the required resources and configures the application on the created resources. To simplify getting started, the Resource Manager Stack is created as part of each [release](https://github.com/oracle-quickstart/oci-cloudnative/releases)



The steps below guide you through deploying the application on your tenancy using the OCI Resource Manager.



1. Download the latest [`mushop-basic-stack-latest.zip`](../../releases/latest/download/mushop-basic-stack-latest.zip) file.

2. [Login](https://cloud.oracle.com/resourcemanager/stacks/create) to Oracle Cloud Infrastructure to import the stack

    > `Home > Developer Services > Resource Manager > Stacks > Create Stack`

3. Upload the `mushop-basic-stack-latest.zip` file that was downloaded earlier, and provide a name and description for the stack

4. Configure the stack

   1. **Database Name** - You can choose to provide a database name (optional)

   2. **Node Count** - Select if you want to deploy one or two application instances.

   3. **SSH Public Key** - (Optional) Provide a public SSH key if you wish to establish SSH access to the compute node(s).

5. Review the information and click Create button.

   > The upload can take a few seconds, after which you will be taken to the newly created stack

6. On Stack details page, click on `Terraform Actions > Apply`



All the resources will be created, and the URL to the load balancer will be displayed as `lb_public_url` as in the example below.

> The same information is displayed on the Application Information tab



```text

Outputs:



autonomous_database_password = 



comments = The application URL will be unavailable for a few minutes after provisioning, while the application is configured



dev = Made with ❤ by Oracle Developers



lb_public_url = http://xxx.xxx.xxx.xxx

```



> The application is being deployed to the compute instances asynchronously, and it may take a couple of minutes for the URL to serve the application.



### Cleanup



Even though it is Always Free, you will likely want to terminate the demo application

in your Oracle Cloud Infrastructure tenancy. With the use of Terraform, the [Resource Manager][orm]

stack is also responsible for terminating the application.



Follow these steps to completely remove all provisioned resources:



1. Return to the Oracle Cloud Infrastructure [Console](https://cloud.oracle.com/resourcemanager/stacks)



  > `Home > Developer Services > Resource Manager > Stacks`



1. Select the stack created previously to open the Stack Details view

1. From the Stack Details, select `Terraform Actions > Destroy`

1. Confirm the **Destroy** job when prompted



  > The job status will be **In Progress** while resources are terminated



1. Once the destroy job has succeeded, return to the Stack Details page

1. Click `Delete Stack` and confirm when prompted



#### Basic Topology



The following diagram shows the topology created by this stack.



![MuShop Basic Infra](./images/basic/00-Free-Tier.png)



---



## Getting Started with MuShop Complete



MuShop Complete is a polyglot micro-services application built to showcase a cloud native approach to application development on [Oracle Cloud Infrastructure][oci] using Oracle's [cloud native](https://www.oracle.com/cloud/cloud-native/) services. MuShop Complete uses a Kubernetes cluster, and can be deployed using the provided `helm` charts (preferred), or Kubernetes manifests. It is recommended to use an Oracle Container Engine for Kubernetes cluster, however other Kubernetes distributions will also work.



The [helm chart documentation][chartdocs] walks through the deployment process and various options for customizing the deployment.



### Complete Topology



The following diagram shows the topology created by this stack.



![MuShop Complete Infra](./images/complete/00-Topology.png)



### [![Deploy to Oracle Cloud][magic_button]][magic_mushop_stack]



## Questions



If you have an issue or a question, please take a look at our [FAQs](./deploy/basic/FAQs.md) or [open an issue](https://github.com/oracle-quickstart/oci-cloudnative/issues/new).



[oci]: https://cloud.oracle.com/en_US/cloud-infrastructure

[orm]: https://docs.cloud.oracle.com/iaas/Content/ResourceManager/Concepts/resourcemanager.htm

[tf]: https://www.terraform.io

[orm_landing]:https://www.oracle.com/cloud/systems-management/resource-manager/

[chartdocs]: https://github.com/oracle-quickstart/oci-cloudnative/tree/master/deploy/complete/helm-chart#setup

[magic_button]: https://oci-resourcemanager-plugin.plugins.oci.oraclecloud.com/latest/deploy-to-oracle-cloud.svg

[magic_mushop_basic_stack]: https://cloud.oracle.com/resourcemanager/stacks/create?zipUrl=https://github.com/oracle-quickstart/oci-cloudnative/releases/latest/download/mushop-basic-stack-latest.zip

[magic_mushop_stack]: https://cloud.oracle.com/resourcemanager/stacks/create?zipUrl=https://github.com/oracle-quickstart/oci-cloudnative/releases/latest/download/mushop-stack-latest.zip