MuShop – A cloud-native reference app for Oracle Cloud

MyShop RunningMuShop is a cloud-native reference showcase app of several Oracle Cloud services. The app implements an e-commerce site for cat products built as a set of Microservices. The name MuShop leans on the term Microservices: Microservices –> μ –> Mu –> Meow –> MuShop. The code itself is hosted on GitHub. There are two implementations of MuShop, one is the Basic Deployment which runs entirely on the Oracle Cloud Free Tier. The other one is the Complete Deployment which is deployed on a Kubernetes cluster such as Oracle Kubernetes Engine (OKE). In this post, I will cover the Basic Deployment of MuShop.

Basic Deployment of the MuShop app

The basic deployment uses the following components of your Always Free Tier:

Terraform is used to create the technology stack which makes it super easy to get MuShop up and running in just a couple of steps:

  1. Download the latest MuShop basic stack zip file from GitHub
  2. Login to your Oracle Cloud Free Tier
  3. Import the stack under Home > Solutions and Platform > Resource Manager > Stacks > Create Stack. Just drag and drop the zip file into the box on the top, giving it an optional name and description and hit Next

MuShop Stacks

MuShop Stack Info

  1. Choose an optional database name and Compute node count and hit Next

MuShop Configuration Variables

  1. Double-check the confirmation page, make sure everything looks correct and hit Create

MuShop Review

  1. The Stack details page will open, hit Terraform Actions > Apply > Apply

MuShop Terraform Actions Apply

MuShop Terraform Apply

That’s it! All the cloud resources and the MuShop app will be automatically created and deployed which may take a couple of minutes. The public HTTP URL to the app will be displayed as lb_public_url at the very end of the Terraform script output and you can also retrieve it in the Outputs pane later on.

MuShop Terraform Output

MyShop Output Pane

It will take a few seconds after the provisioning before you can access the URL as the app is still being configured. After a bit, head to your browser and open the page:

MyShop Running

What’s next?

Congratulations! You now have MuShop up and running. So what’s next? Take some time to explore the app and the resources that have been deployed in Oracle Cloud. Familiarize yourself with the components and feel free to poke around, stop and restart components, perhaps change some configuration parameters, etc. Last but not least, have a look at the Complete Deployment or the GitHub repo for a closer look inside the app.


Cleaning up the MuShop Basic Deployment can also be done in just a few simple steps:

  1. In the Oracle Cloud Console, return to your Stacks under Home > Solutions and Platform > Resource Manager > Stacks
  2. Select the stack you have previously created (there should only be one)
  3. In the Stack Details, click on Terraform Actions > Destroy and confirm the destroy job

MuShop Destroy

MuShop Terraform Destroy

  1. Once the destroy job has succeeded, delete the Stack via the Delete Stack button and confirm

MuShop Delete

MuShop Delete Stack

Once the operation has succeeded, you will have no more stack visible. Note, you will see the cloud components in Terminated state, this is expected. Don’t worry, they will no longer count towards your resource limits.

This blog post was originally published at

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

This site uses Akismet to reduce spam. Learn how your comment data is processed.