Initial upload

Author: jeandelavarene

.gitignore

@@ -0,0 +1,49 @@
+# Compiled class file
+*.class
+
+# Log file
+*.log
+
+# BlueJ files
+*.ctxt
+
+# Package Files #
+*.jar
+*.war
+*.nar
+*.ear
+*.zip
+*.tar.gz
+*.rar
+backend/target/*
+backend/.settings/*
+backend/.project
+backend/.classpath
+# virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml
+hs_err_pid*
+*~
+
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+frontend/node_modules
+frontend/.pnp
+.pnp.js
+
+# testing
+frontend/coverage
+
+# production
+frontend/build
+
+# misc
+.DS_Store
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+frontend/package-lock.json
+frontend/npm-debug.log*
+frontend/yarn-debug.log*
+frontend/yarn-error.log*

backend/README.md

@@ -0,0 +1,208 @@
+## MyToDoReact version 1.0.
+Copyright (c) 2021 Oracle, Inc.
+
+Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl/
+
+# Part II -- Backend (Java/Helidon)
+
+## **Summary**
+
+In this Part, you will build and deploy the Helidon Java backend Docker image to OKE, then configure the API Gateway
+
+As with most React applications (https://reactjs.org/), this application uses remote APIs to handle data persistence. The backend implements 5 REST APIs including:
+- 1) retrieving the current list of todo items
+- 2) Adding a new todo item
+- 3) finding a todo item by its id
+- 4) updating an existing todo item
+- 5) deleting a todo item.
+
+The APIs are documented using Swagger @ http://130.61.67.158:8780/swagger-ui/#/
+
+The backend is implemented using the following Java classes (under ./backend/src/...):   
+- Main.java: starts and configure the main entry points.
+- ToDoItem.java: maps a Todo Item instance to/from JSON  document
+- ToDoItemStorage.java: stores the Todo item in a persistent store i.e., the Oracle Autonomous database
+- ToDoListAppService.java: implements the Helidon service and exposes the REST APIs
+
+![](images/Backend-APIs.png " ")
+
+## **Objectives**
+
+* Set values for environment variables
+* Build and deploy the Docker image of the application
+* Deploy the image on the Oracle Kubernetes Engine (OKE)
+* Describe the steps for Undeploying
+* Configure the API Gateway
+* Test the backend application
+
+
+## **STEP 1**: Set values for workshop environment variables
+
+1. Set the root directory of the workshop
+```
+<copy>export MTDRWORKSHOP_LOCATION=~/mtdrworkshop</copy>
+```
+2. Run source addAndSourcePropertiesInBashrc.sh
+
+The following command will set the values of environment variables in mtdrworkshop.properties and source ~/.bashrc
+
+ ```
+ <copy>cd $MTDRWORKSHOP_LOCATION; source addAndSourcePropertiesInBashrc.sh
+ </copy>
+```
+
+## **STEP 2**: Build and push the Docker images to the OCI Registry
+
+1. Ensure that the "DOCKER_REGISTRY" variable is set
+
+ Example: <region-key>.ocir.io/<object-storage-namespace>/<firstname.lastname>/<repo-name>"
+ If the variable is not set or is an empty string, the push will fail (but the docker image will be built).
+
+2. Make sure to be in backend/target/classes/wallet directory then execute
+   ```
+   <copy>unzip ~/mtdrworkshop/setup-dev-environment/wallet.zip</copy>
+   ```
+
+3. Pick mtdrb_tp service alias (see the list of aliases in
+   ./backend/target/classes/wallet/tnsnames.ora)
+
+![](images/tnsnames-ora.png " ")
+
+4. Edit ./backend/target/classes/application.yaml to set the database service and user password
+![](images/application-yaml.png " ")
+
+5. Copy the edited ./backend/target/classes/application.yaml to backend./src/main/resources/application.yaml
+
+6. Edit ./backend/src/main/java/com/oracle/todoapp/Main.java
+ -  Locate the following code fragment
+    ![](images/CORS-Main.png " ")
+ - Replace `eu-frankfurt-1` in  `"https://objectstorage.eu-frankfurt-1.oraclecloud.com"` by your region
+
+ - Save the file
+
+7. Run the `build.sh` script to build and push the
+    microservices images into the repository
+
+    ```
+    <copy>cd $MTDRWORKSHOP_LOCATION/backend; ./build.sh</copy>
+    ```
+  In a couple of minutes, you should have successfully built and pushed the images into the OCIR repository.
+
+8.  Check your container registry from the root compartment
+    - Go to the Console, click the hamburger menu in the top-left corner and open
+    **Developer Services > Container Registry**.
+
+   ![](images/Registry-root-compart.png " ")
+
+9. Mark Access as Public  (if Private)  (**Actions** > **Change to Public**):
+
+   ![](images/Public-access.png " ")
+
+## **STEP 3**: Deploy on Kubernetes and Check the Status
+
+1. Run the `deploy.sh` script
+
+```
+  <copy>cd $MTDRWORKSHOP_LOCATION/backend; ./deploy.sh</copy>
+```
+
+--> service/todolistapp-helidon-se-service created
+--> deployment.apps/todolistapp-helidon-se-deployment created
+
+2. Check the status using the following commands
+$ kubectl get services
+
+The following command returns the Kubernetes service of MyToDo application with a load balancer exposed through an external API
+```
+  <copy>kubectl get services</copy>
+```
+
+![](images/K8-service-Ext-IP.png " ")
+
+4. $ kubectl get pods
+```
+  <copy>kubectl get pods</copy>
+```
+
+![](images/k8-pods.png " ")
+
+5. Continuously tailing the log of one of the pods
+
+$ kubectl logs -f <pod name>
+  Examaple kubectl lgs -f todolistapp-helidon-se-deployment-7fd6dcb778-c9dbv
+
+  Returns:
+  http://130.61.66.27/todolist
+
+## **STEP 4**: UnDeploy (optional)
+
+  If you make changes to the image, you need to delete the service and the pods by running undeploy.sh then redo Steps 2 & 3.
+
+  1. Run the `undeploy.sh` script
+  ```
+    <copy>cd $MTDRWORKSHOP_LOCATION/backend; ./undeploy.sh</copy>
+  ```
+  2. Rebuild the image + Deploy + (Re)Configure the API Gateway
+
+
+## **STEP 5**: Configure the API Gateway
+
+The API Gateway protects any RESTful service running on Container Engine for Kubernetes, Compute, or other endpoints through policy enforcement, metrics and logging.
+Rather than exposing the Helidon service directly, we will use the API Gateway to define cross-origin resource sharing (CORS).
+
+1. From the hamburger  menu navigate **Developer Services** > **API Management > Create Gateway**
+   ![](images/API-Gateway-menu.png " ")
+
+2. Configure the basic info: name, compartment, VCN and Subnet
+    - VCN: pick on of the vitual circuit network
+    - Subnet pick the public subnet   
+    The click "Create"
+  ![](images/Basic-gateway.png " ")
+
+3. Click on Todolist gateway
+       ![](images/Gateway.png " ")
+
+4. Click on Deployments
+   ![](images/Deployment-menu.png " ")
+
+5. Create a todolist deployment
+   ![](images/Deployment.png " ")
+
+
+6. Configure Cross-origin resource sharing (CORS) policies
+  CORS is a security mechanism that will prevent  running application loaded from origin A  from using resources from another origin B.
+  Allowed Origins: is the list of all servers (origins) that are allowed to access the API deployment typically your Kubernetes cluster IP.
+  Allowed methods: GET, PUT, DELETE, POST, OPTIONS are all needed.
+  ![](images/Origins-Methods.png " ")
+
+ 7. Configure the Headers
+    ![](images/Headers.png " ")
+
+ 8. Configure the routes: we will define two routes:
+    - /todolist for the first two APIs: GET, POST and OPTIONS
+    ![](images/Route-1.png " ")
+
+    - /todolist/{id} for the remaining three APIs: (GET, PUT and DELETE)
+    ![](images/Route-2.png " ")
+
+
+## **STEP 6**: Testing the backend application through the API Gateway
+
+1. Navigate to the newly create Gateway Deployment Detail an copy the endpoint
+   ![](images/Gateway-endpoint.png " ")
+
+2. Testing through the API Gateway endpoint
+  postfix the gateway endpoint with "/todolist" as shown in the image below
+   ![](images/Backend-Testing.png " ")
+
+  It should display the Todo Item(s) in the TodoItem table. At least the row you have created in Part I.
+
+Congratulations, you have completed Part II; you may now proceed to the final part (i.e., Part III).
+
+## Acknowledgements
+* **Workshop by** - Kuassi Mensah, Dir. Product Management, Java Database Access
+* **Application by** - Jean de Lavarene, Sr. Director of Development, JDBC/UCP
+* **Original scripts by** - Paul Parkinson, Developer Evangelist, Microservices
+
+## Need Help?
+Please submit feedback or ask for help using this [LiveLabs Support Forum](https://community.oracle.com/tech/developers/categories/building-microservices-with-oracle-converged-database). Please login using your Oracle Sign On and click the **Ask A Question** button to the left.  You can include screenshots and attach files.  Communicate directly with the authors and support contacts.  Include the *lab* and *step* in your request.

backend/build.sh

@@ -0,0 +1,29 @@
+#!/bin/bash
+## MyToDoReact version 1.0.
+##
+## Copyright (c) 2021 Oracle, Inc.
+## Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl/
+
+SCRIPT_DIR=$(dirname $0)
+
+IMAGE_NAME=todolistapp-helidon-se
+IMAGE_VERSION=0.1
+
+if [ -z "DOCKER_REGISTRY" ]; then
+    echo "Error: DOCKER_REGISTRY env variable needs to be set!"
+    exit 1
+fi
+
+export IMAGE=${DOCKER_REGISTRY}/${IMAGE_NAME}:${IMAGE_VERSION}
+mvn install
+docker build -f src/main/docker/Dockerfile -t $IMAGE .
+# mvn package docker:build
+
+# if [ $DOCKERBUILD_RETCODE -ne 0 ]; then
+if [ $? -ne 0 ]; then
+    exit 1
+fi
+docker push $IMAGE
+# if [  $? -eq 0 ]; then
+#     docker rmi ${IMAGE}
+# fi

backend/deploy.sh

@@ -0,0 +1,14 @@
+#!/bin/bash
+## MyToDoReact version 1.0.
+##
+## Copyright (c) 2021 Oracle, Inc.
+## Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl/
+SCRIPT_DIR=$(dirname $0)
+export CURRENTTIME=$( date '+%F_%H:%M:%S' )
+echo CURRENTTIME is $CURRENTTIME  ...this will be appended to generated deployment yaml
+cp src/main/k8s/app.yaml todolistapp-helidon-se-deployment-$CURRENTTIME.yaml
+#may hit sed incompat issue with mac
+sed -i "s|%DOCKER_REGISTRY%|${DOCKER_REGISTRY}|g" todolistapp-helidon-se-deployment-$CURRENTTIME.yaml
+kubectl apply -f $SCRIPT_DIR/todolistapp-helidon-se-deployment-$CURRENTTIME.yaml 
+
+#kubectl create -f $SCRIPT_DIR/todolistapp-helidon-se-service.yaml  -n todoapplication