https://github.com/oracle-quickstart/oci-micronaut
Micronaut MuShop - Cloud Native microservices demo for Oracle Cloud Infrastructure
https://github.com/oracle-quickstart/oci-micronaut
cloud-native docker graalvm graalvm-native-image kubernetes micronaut microservices oracle-cloud-infrastructure oraclecloud
Last synced: 13 days ago
JSON representation
Micronaut MuShop - Cloud Native microservices demo for Oracle Cloud Infrastructure
- Host: GitHub
- URL: https://github.com/oracle-quickstart/oci-micronaut
- Owner: oracle-quickstart
- License: upl-1.0
- Created: 2021-06-16T19:54:14.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2024-04-24T09:03:32.000Z (about 1 year ago)
- Last Synced: 2024-04-24T12:18:31.035Z (about 1 year ago)
- Topics: cloud-native, docker, graalvm, graalvm-native-image, kubernetes, micronaut, microservices, oracle-cloud-infrastructure, oraclecloud
- Language: Java
- Homepage: https://oracle-quickstart.github.io/oci-micronaut
- Size: 26.6 MB
- Stars: 17
- Watchers: 17
- Forks: 15
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# 
The MuShop application is a showcase of several [Oracle Cloud
Infrastructure](https://cloud.oracle.com/en_US/cloud-infrastructure) services in
a unified reference application. This version is written entirely in the
Micronaut framework using the Graal Cloud Native (GCN)
toolkit. See the [full
documentation](https://oracle-quickstart.github.io/oci-micronaut) for a detailed
explanation and deployment options.
This project is a fork of the [original MuShop implementation](https://github.com/oracle-quickstart/oci-cloudnative) which used different technologies for each individual Microservice application and is designed as a demonstration of how to use the Micronaut framework to build applications for Oracle Cloud.
The sample application implements an e-commerce platform built as a set of microservices. The [accompanying content](https://oracle-quickstart.github.io/oci-micronaut) can be used to get started with cloud native application development on Oracle Cloud Infrastructure.
|  |  |  |  |
|---|---|---|---|
MuShop can be deployed to Oracle Cloud Infrastructure on [Kubernetes](https://kubernetes.io/) with [Helm](https://helm.sh) and [Terraform](https://www.terraform.io), or run locally in [Docker](https://www.docker.com/).
### Oracle Cloud
Use the following Deploy to Oracle Cloud button to use Oracle Cloud Resource Manager to deploy and configure MuShop on OKE.
#### [](https://cloud.oracle.com/resourcemanager/stacks/create?zipUrl=https://github.com/oracle-quickstart/oci-micronaut/releases/latest/download/mushop-stack-latest.zip)
Alternatively you can manually upload the Oracle Cloud Resource Manager [zip file](https://github.com/oracle-quickstart/oci-micronaut/releases/latest/download/mushop-stack-latest.zip).
### Docker
To deploy locally with Docker, follow [these instructions](https://oracle-quickstart.github.io/oci-micronaut/quickstart/dockecompose/).
### Helm
MuShop is a Microservices application built to showcase a cloud-native approach to application development on Oracle Cloud Infrastructure with the Micronaut framework & GraalVM using Oracle's [cloud native](https://www.oracle.com/cloud/cloud-native/) services. MuShop uses a Kubernetes cluster, and can be deployed using the provided `helm` charts. It is recommended to use an Oracle Container Engine for Kubernetes cluster, however other Kubernetes distributions will also work.
The [helm chart documentation](https://oracle-quickstart.github.io/oci-micronaut/quickstart/helm/) walks through the deployment process and various options for customizing the deployment.
If you do not have an Oracle Cloud account yet, you can create a [free trial account](https://signup.oraclecloud.com).
Note that you will have to create and configure the needed Oracle Cloud services manually. For complete automated deployment use the following option [Helm + Terraform](helm--terraform).
### Helm + Terraform
Deploy the complete MuShop with all Oracle Cloud services automatically using the Terraform scripts. The [terraform documentation](https://oracle-quickstart.github.io/oci-micronaut/quickstart/terraform/) walks through the configuration process and various options for customizing the deployment.
#### Topology
The following diagram shows the topology created by this 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-micronaut/issues/new).