> For the complete documentation index, see [llms.txt](https://thomas-suedbroecker.gitbook.io/toolchain-one-microservice/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://thomas-suedbroecker.gitbook.io/toolchain-one-microservice/master.md).

# Introduction

This hands-on workshop is related to the Cloud-Native-Starter hands-on workshop [Build a Java Microservice and deploy the Microservice to Kubernetes on IBM Cloud](https://github.com/IBM/cloud-native-starter/tree/master/workshop-one-service)

In this workshop you automate the deployment steps of [Lab 4 - Deploy to Kubernetes](https://github.com/IBM/cloud-native-starter/blob/master/workshop-one-service/4-kubernetes.md) in the hands-on workshop. The Authors Microservice will be automated deployed to a free Kubernetes cluster on IBM Cloud.

## Estimated time and level

| Time     | Level     |
| -------- | --------- |
| one hour | beginners |

## Objectives

After you complete this workshop, you'll understand the toolchain automation to deploy the authors microservice.

* Build the container for the authors microservice
* Save the container in the IBM Cloud Registry
* Deploy the authors microservice to the free Kubernetes cluster on IBM Cloud

In the following image you get an overview deployment of the authors microserviceto to a free IBM Cloud Kubernetes Cluster.

![Overview of the Authors Microservice deployment](/files/-M-Jp5NpkTLmdEn3LEed)

## About this workshop

The introductory page of the workshop is broken down into the following sections:

* [Agenda](/toolchain-one-microservice/master.md#agenda)
* [Compatibility](/toolchain-one-microservice/master.md#compatibility)
* [Technology Used](/toolchain-one-microservice/master.md#technology-used)
* [Credits](/toolchain-one-microservice/master.md#credits)

## Agenda

These are the labs of this workshop, go through all of them in sequence, start with lab 1:

|                                                                                           |                                                       |
| ----------------------------------------------------------------------------------------- | ----------------------------------------------------- |
| [Lab 1](/toolchain-one-microservice/ibm-cloud-setup/lab1.md)                              | Register for IBM Cloud                                |
| [Lab 2](/toolchain-one-microservice/ibm-cloud-setup/lab2.md)                              | Insert feature code                                   |
| [Lab 3](/toolchain-one-microservice/ibm-cloud-setup/lab3.md)                              | Create a free Kubernetes cluster                      |
| [Lab 4](/toolchain-one-microservice/ibm-cloud-setup/lab4.md)                              | Configure the IBM Cloud Container Registry            |
| [Lab 5](/toolchain-one-microservice/deploy-the-authors-microservice-to-ibm-cloud/lab5.md) | Deploy the Microservice with the  IBM Cloud toolchain |
| [Lab 6](/toolchain-one-microservice/deploy-the-authors-microservice-to-ibm-cloud/lab6.md) | Use the created toolchain                             |
| [Lab 7](/toolchain-one-microservice/deploy-the-authors-microservice-to-ibm-cloud/lab7.md) | Verify the deployed authors microservice              |

## Compatibility

This workshop has been tested on the following platforms:

* [**IBM Cloud Kubernetes service**](https://www.ibm.com/cloud/container-service/): Kubernetes version 1.17.5\_1522 (Plan:free) 
* [**IBM Cloud Continuous Delivery**](https://www.ibm.com/cloud/continuous-delivery): (Plan: Lite)

## Technology Used

* [Jakarta EE](https://jakarta.ee/)
* [MicroProfile](https://microprofile.io/)
* [Microservices architecture](https://en.wikipedia.org/wiki/Microservices)
* [Docker](https://www.docker.com/)
* [Open Toolchain](https://github.com/open-toolchain)
* [Kubernetes](https://kubernetes.io/)
* [Open Liberty](https://openliberty.io/)
* [GitLab](https://about.gitlab.com/)

## Credits

* [Thomas Südbröcker](https://twitter.com/tsuedbroecker)
* [Niklas Heidloff](https://twitter.com/nheidloff)
* [Harald Uebele](https://twitter.com/Harald_U)