# ce-cns

**Repository Path**: mirrors_ibm/ce-cns

## Basic Information

- **Project Name**: ce-cns
- **Description**: Get Started with deploying a Java Microservices Application to `Code Engine` . Documentation link: "https://ibm.github.io/ce-cns/"
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-07-09
- **Last Updated**: 2025-08-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# [Jumpstart: Deploy a Java Microservices Application to `Code Engine`](https://ibm.github.io/ce-cns)
 
Please follow this **[link](https://ibm.github.io/ce-cns) to access the full workshop documentation**:

[![](documentation/images/button-documentation.png)](https://ibm.github.io/ce-cns)

and here is the link to the documentation on [IBM Developer](https://developer.ibm.com/tutorials/deploy-a-java-microservices-application-to-ibm-cloud-code-engine/#labs).
If you want to access the workshop from [IBM Techzone](https://techzone.ibm.com) please follow this [link](https://techzone.ibm.com/collection/an-example-to-deploy-a-existing-java-microservices-based-application-to-codeengine).

> FYI: The workshop documententation uses [GitHub Pages](https://pages.github.com/) with [MkDocs](https://www.mkdocs.org/please). For more details please visit "[How to setup MkDocs?](https://suedbroecker.net/2021/01/25/how-to-install-mkdocs-on-mac-and-setup-the-integration-to-github-pages/)".

## Brief architecture overview

This `workshop` is related to the [Cloud Native Starter](https://github.com/ibm/cloud-native-starter) project. In the workshop we use a customized version of the [security application example](https://developer.ibm.com/languages/java/tutorials/secure-your-java-microservices-application-workshop/). The example application simply shows articles protected with an `Identity and Access Manegement`. In the following picture you see the frontend with the articles and the valid user `alice` is logged on.

![](documentation/images/cns-ce-example-application-00.png)

The following diagram shows the architecture of the example application. There is a `web-app` frontend application that serves the JavaScript/Vue.js code to the browser. The `web-app` code running in the browser invokes a REST API of the `web-api` microservice. The `web-api` microservice in turn invokes a REST API of the `articles` microservice. [`Keycloak`](https://www.keycloak.org/) is used for the `Identity and Access Management` of that microservices based application. To see the results in the web application, users need to be authenticated and they need to have the role `user`.

The image below shows the dependencies of the example:

![](documentation/images/cns-ce-architecture.png)

## Open the full workshop documentation

Please follow this **[link](https://ibm.github.io/ce-cns) to access the full workshop documentation**:

[![](documentation/images/button-documentation.png)](https://ibm.github.io/ce-cns)