{"id":13565899,"url":"https://github.com/oracle-quickstart/oci-cloudnative","last_synced_at":"2025-04-08T08:15:38.962Z","repository":{"id":37664944,"uuid":"206883142","full_name":"oracle-quickstart/oci-cloudnative","owner":"oracle-quickstart","description":"MuShop - Cloud Native microservices demo for Oracle Cloud Infrastructure","archived":false,"fork":false,"pushed_at":"2025-03-28T15:09:11.000Z","size":28915,"stargazers_count":260,"open_issues_count":7,"forks_count":176,"subscribers_count":25,"default_branch":"master","last_synced_at":"2025-04-01T07:45:48.066Z","etag":null,"topics":["always-free","cloud","cloud-native-microservices","cloudnative","free-tier","hacktoberfest","microservice","mushop","oci","oracle-cloud-infrastructure","oracle-led","terraform"],"latest_commit_sha":null,"homepage":"https://oracle-quickstart.github.io/oci-cloudnative","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"upl-1.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/oracle-quickstart.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-09-06T22:29:46.000Z","updated_at":"2025-03-26T20:41:04.000Z","dependencies_parsed_at":"2024-01-19T06:59:00.362Z","dependency_job_id":"97bc80a9-597c-4117-9c8a-18a87d37dad6","html_url":"https://github.com/oracle-quickstart/oci-cloudnative","commit_stats":{"total_commits":2405,"total_committers":24,"mean_commits":"100.20833333333333","dds":"0.42661122661122663","last_synced_commit":"70cf46cb1cf650b0c18c98068241321691ee6f4e"},"previous_names":[],"tags_count":33,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oracle-quickstart%2Foci-cloudnative","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oracle-quickstart%2Foci-cloudnative/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oracle-quickstart%2Foci-cloudnative/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oracle-quickstart%2Foci-cloudnative/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/oracle-quickstart","download_url":"https://codeload.github.com/oracle-quickstart/oci-cloudnative/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247801175,"owners_count":20998339,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["always-free","cloud","cloud-native-microservices","cloudnative","free-tier","hacktoberfest","microservice","mushop","oci","oracle-cloud-infrastructure","oracle-led","terraform"],"created_at":"2024-08-01T13:01:57.437Z","updated_at":"2025-04-08T08:15:38.924Z","avatar_url":"https://github.com/oracle-quickstart.png","language":"JavaScript","readme":"# ![MuShop Logo](./images/logo.png#gh-light-mode-only)![MuShop Logo - Dark Mode](./images/logo-inverse.png#gh-dark-mode-only)\n\nMuShop 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].\n\n| ![home](./images/screenshot/mushop.home.png) | ![browse](./images/screenshot/mushop.browse.png) | ![cart](./images/screenshot/mushop.cart.png) | ![about](./images/screenshot/mushop.about.png) |\n|---|---|---|---|\n\nMuShop 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.\n\n| [Basic: `deploy/basic`](#Getting-Started-with-MuShop-Basic) | [Complete: `deploy/complete`](#Getting-Started-with-MuShop-Complete) |\n|---|---|\n| Simplified runtime utilizing **only** [Always Free](https://www.oracle.com/cloud/free/) eligible resources. \u003cbr/\u003e\u003cbr/\u003e Deploy using: \u003cbr/\u003e  1. [Terraform][tf] \u003cbr/\u003e  2. [Resource Manager][orm_landing] following the steps below \u003cbr/\u003e  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. \u003cbr/\u003e\u003cbr/\u003e Deploy using: \u003cbr/\u003e  1. [Helm](https://helm.sh) \u003cbr/\u003e 2. [Terraform][tf] \u003cbr/\u003e  3. [Resource Manager][orm_landing] \u003cbr/\u003e  4. (Recommended) Button below - launches in Resource Manager directly |\n| [![Deploy to Oracle Cloud][magic_button]][magic_mushop_basic_stack]| [![Deploy to Oracle Cloud][magic_button]][magic_mushop_stack]|\n\n```text\nmushop\n└── deploy\n    ├── basic\n    └── complete\n```\n\n## Getting Started with MuShop Basic\n\nThis 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.\n\nThe 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)\n\nThe steps below guide you through deploying the application on your tenancy using the OCI Resource Manager.\n\n1. Download the latest [`mushop-basic-stack-latest.zip`](../../releases/latest/download/mushop-basic-stack-latest.zip) file.\n2. [Login](https://cloud.oracle.com/resourcemanager/stacks/create) to Oracle Cloud Infrastructure to import the stack\n    \u003e `Home \u003e Developer Services \u003e Resource Manager \u003e Stacks \u003e Create Stack`\n3. Upload the `mushop-basic-stack-latest.zip` file that was downloaded earlier, and provide a name and description for the stack\n4. Configure the stack\n   1. **Database Name** - You can choose to provide a database name (optional)\n   2. **Node Count** - Select if you want to deploy one or two application instances.\n   3. **SSH Public Key** - (Optional) Provide a public SSH key if you wish to establish SSH access to the compute node(s).\n5. Review the information and click Create button.\n   \u003e The upload can take a few seconds, after which you will be taken to the newly created stack\n6. On Stack details page, click on `Terraform Actions \u003e Apply`\n\nAll the resources will be created, and the URL to the load balancer will be displayed as `lb_public_url` as in the example below.\n\u003e The same information is displayed on the Application Information tab\n\n```text\nOutputs:\n\nautonomous_database_password = \u003cgenerated\u003e\n\ncomments = The application URL will be unavailable for a few minutes after provisioning, while the application is configured\n\ndev = Made with ❤ by Oracle Developers\n\nlb_public_url = http://xxx.xxx.xxx.xxx\n```\n\n\u003e 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.\n\n### Cleanup\n\nEven though it is Always Free, you will likely want to terminate the demo application\nin your Oracle Cloud Infrastructure tenancy. With the use of Terraform, the [Resource Manager][orm]\nstack is also responsible for terminating the application.\n\nFollow these steps to completely remove all provisioned resources:\n\n1. Return to the Oracle Cloud Infrastructure [Console](https://cloud.oracle.com/resourcemanager/stacks)\n\n  \u003e `Home \u003e Developer Services \u003e Resource Manager \u003e Stacks`\n\n1. Select the stack created previously to open the Stack Details view\n1. From the Stack Details, select `Terraform Actions \u003e Destroy`\n1. Confirm the **Destroy** job when prompted\n\n  \u003e The job status will be **In Progress** while resources are terminated\n\n1. Once the destroy job has succeeded, return to the Stack Details page\n1. Click `Delete Stack` and confirm when prompted\n\n#### Basic Topology\n\nThe following diagram shows the topology created by this stack.\n\n![MuShop Basic Infra](./images/basic/00-Free-Tier.png)\n\n---\n\n## Getting Started with MuShop Complete\n\nMuShop 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.\n\nThe [helm chart documentation][chartdocs] walks through the deployment process and various options for customizing the deployment.\n\n### Complete Topology\n\nThe following diagram shows the topology created by this stack.\n\n![MuShop Complete Infra](./images/complete/00-Topology.png)\n\n### [![Deploy to Oracle Cloud][magic_button]][magic_mushop_stack]\n\n## Questions\n\nIf 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).\n\n[oci]: https://cloud.oracle.com/en_US/cloud-infrastructure\n[orm]: https://docs.cloud.oracle.com/iaas/Content/ResourceManager/Concepts/resourcemanager.htm\n[tf]: https://www.terraform.io\n[orm_landing]:https://www.oracle.com/cloud/systems-management/resource-manager/\n[chartdocs]: https://github.com/oracle-quickstart/oci-cloudnative/tree/master/deploy/complete/helm-chart#setup\n[magic_button]: https://oci-resourcemanager-plugin.plugins.oci.oraclecloud.com/latest/deploy-to-oracle-cloud.svg\n[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\n[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\n","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foracle-quickstart%2Foci-cloudnative","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foracle-quickstart%2Foci-cloudnative","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foracle-quickstart%2Foci-cloudnative/lists"}