# 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)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://thomas-suedbroecker.gitbook.io/toolchain-one-microservice/master.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.