oracle-quickstart / oci-micronaut

Micronaut MuShop - Cloud Native microservices demo for Oracle Cloud Infrastructure

The MuShop application is a showcase of several Oracle 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 for a detailed explanation and deployment options.

This project is a fork of the original MuShop implementation 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 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 with Helm and Terraform, or run locally in Docker.

Oracle Cloud

Use the following Deploy to Oracle Cloud button to use Oracle Cloud Resource Manager to deploy and configure MuShop on OKE.

Alternatively you can manually upload the Oracle Cloud Resource Manager zip file.

Docker

To deploy locally with Docker, follow these instructions.

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 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 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.

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

Deploy the complete MuShop with all Oracle Cloud services automatically using the Terraform scripts. The terraform documentation 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 or open an issue.

oci-micronaut's Issues

k8s: load payment decline amount for payment service from config map

Demonstrate load of properties from config maps.

Extend Terraform by APM

It is already available: https://registry.terraform.io/providers/hashicorp/oci/latest/docs/resources/apm_apm_domain

Users will now just opt-in to use APM and the rest will be done automatically.

Upgrade to Micronaut 3

Upgrade microservices

• api - #11
• carts - #20
• catalogue - #19
• events - #18
• fulfillment - #16
• orders - #17
• payment - #12
• user - #13

Upgrade functions

• newsletter -

Upgrade and test deployment

• docker-compose - #11
• oraclecloud
• aws

Release new version of Micronaut MuShop

• release 3.2

Failed to create API GW policy when the stack is in root compartment

Error: 400-InvalidParameter
Provider version: 4.26.0, released on 2021-05-12. This provider is 3 updates behind to current.
Service: Identity Policy
Error Message: The compartment cloudnative-devrel specified in the policy statement does not exist under current compartment hierarchy.
OPC request ID: 4c2207575a273ff1eaacbcf771eb33b9/768F4FC06B42B8F8B45A9B11008E25DD/437E348FB800E044B6D941D7F276A60B
Suggestion: Please update the parameter(s) in the Terraform config as per error message The compartment cloudnative-devrel specified in the policy statement does not exist under current compartment hierarchy.
  on ofn.tf line 103, in resource "oci_identity_policy" "api_gw_dg_policy" 
 103: resource "oci_identity_policy" "api_gw_dg_policy" {

Add APM to terraform

The oci terraform provider version 4.32 adds support for APM.

Cluster autoscaler fails to deploy

kubernetes_deployment.cluster_autoscaler_deployment[0]: Still creating... [8m40s elapsed]
kubernetes_deployment.cluster_autoscaler_deployment[0]: Still creating... [8m50s elapsed]
kubernetes_deployment.cluster_autoscaler_deployment[0]: Still creating... [9m0s elapsed]
kubernetes_deployment.cluster_autoscaler_deployment[0]: Still creating... [9m10s elapsed]
kubernetes_deployment.cluster_autoscaler_deployment[0]: Still creating... [9m20s elapsed]
kubernetes_deployment.cluster_autoscaler_deployment[0]: Still creating... [9m30s elapsed]
kubernetes_deployment.cluster_autoscaler_deployment[0]: Still creating... [9m40s elapsed]
kubernetes_deployment.cluster_autoscaler_deployment[0]: Still creating... [9m50s elapsed]
kubernetes_deployment.cluster_autoscaler_deployment[0]: Still creating... [10m0s elapsed]

The image is not in OCIR

Deploy to Oracle Cloud - Basic

Update all samples to Java 17 minimum and use Java records where possible for entities / DTOs

We should baseline the sample on Java 17