Go to the Cloud Test Drive Welcomer Page
This is the project for the Migration of a Monolith (well actually quite a simple "Monolith" web app that provides a REST API and a basic database service) into a web service comprised of two microservices using the Helidon framework. The microservices are then extended to provide monitoring capabilities such as metrics and tracing, then to prepare them for cloud native capabilities such as health checks, automatic service restart etc.
The next part of the lab goes through the process of packaging those services up into Docker containers and externalizing configuration such as the database connection details and pushing to a docker repository.
Then we look at how to run the docker containers in Kubernetes, examining how to set up a Kubernetes cluster with basic capabilities, then creating a basic deployment of the services behind an Ingress controller. The labs then examine how to make use of cloud native capabilities in Kubernetes such as horizontal scaling and using the support in Helidon for things like service liveness, readiness and how those combine to enable continuous service delivery using rolling upgrades.
Finally we look at monitoring and graphing to extract data on how the system operates.
Finally we look at horizontal scaling the number of microservice instances to handle changes in load and also how multiple instances can be used to support a rolling upgrade.
There are also several optional lab sections you can do which cover development activities such as extracting information from the REST request (e.g. the name of the user making the request) and how to have the Helidon framework automatically generate Open API documentation (previously known as Swagger) to ensure that the REST API documentation reflects exactly the service currently in use. Optional sections also cover deployment activities such as capturing log data and sending it to a data store for analysis.
In the future the labs will include sections on the use of a Service Mesh, and other Kubernetes based cloud native capabilities such as A/B testing of new releases etc.
For reference, this is the architecture you'll be building
This is a rather long lab, therefore we used a few layout tricks to make the reading of this tutorial more intuitive :
- If you see a "Bullet" sign, this means you need to perform some sort of action. This can be
- Opening a window and navigating to some point in a file system
- Executing some command on the command line of a terminal window :
- For example :
ls -al
- For example :
As we cover quite some theoretical concepts, we included pretty verbose explanations. To make the lab easier to grasp, we placed the longer parts in Collapsibles:
Click this part to expand !
If you feel you are already pretty familiar with a specific concept, you can just skip it, or read quickly through the text, then re-collapse the text section by re-clicking on the title.
These labs were designed in part to be delivered in a classroom environment where we would do a short presentation to introduce the labs, and also each section.
To support those who are doing the labs in a self-guided mode we have created an introduction video to the entire labs, and short videos for each lab section. If you are doing the labs with an instructor you don't need to review these, but for self guided students we strongly recommend that you review the videos.
Each video is in a expandable section, see the one below. If you are a self guided student open it and click on the video image to be taken to the video streaming web site where you can play it. Once you've finished just click the back button to return to these instructions.
Self guided student - video introduction
This video is an introduction to this lab. Once you've watched it please press the "Back" button on your browser to return to the labs.
Note. The current videos were recorded during the lock down, hence the poor sound quality, you may need to turn up the volume on your computer to hear them properly.
You will be running these labs on an Oracle Cloud Infrastructure (OCI) tenancy. This allows us to provide you with a consistent environment.
Components we will be using :
- A Linux VM with a Linux Desktop, accessible through a VNC viewer. This environment will contain Eclipse, Maven and Docker, tools you will need to run the first 2 labs (A. Helidon and B. Docker)
- An ATP database to allow our application to store data in a persistent manner.
- A Kubernetes cluster to deploy you microservices on (for the 3rd lab C. Kubernetes)
The basic principles will however run in any Java IDE or Kubernetes environment, however you may need to adjust some aspects, for example if you were to build on this lab by installing a local database on your laptop the process will be different than when using an Autonomous Transaction Processing database in the Oracle cloud.
There are some steps you need to take to prepare the environment for your own individual use.
- You can run this lab on a Oracle Free Tier account. In this case you need to perform some extra preparation steps, explained in detail on this page.
- If you are part of an instructor-led lab, your instructor might provide Cloud Tenancy for you, minimizing the setup to these few steps to connect to a remote desktop.
The Helidon part of the labs show how to split the Monolith into microservices using Helidon REST, to access data and to extend the microservices to suppport cloud native capabilities
To do these labs you must be familiar with Java at a basic lavel (able to understand classes, constructors, methods etc.) and a bit familiar with the Eclipse IDE
Follow the link to the Helidon labs to get started !
The Docker part of the labs covers how we use JIB to create a docker image, run it, then to move the configuration and secrets externally to the docker image, finally we look at how to push the docker image to a repository
Go to the Docker Labs
These labs cover how to deploy our docker continers in Kubernetes and how to make use of the cloud native capabilities of Kubernetes.
Go to the Kubernetes Labs
Go to the Cloud Test Drive Welcomer Page
Copyright (c) 2014, 2020 Oracle and/or its affiliates The Universal Permissive License (UPL), Version 1.0