azure-samples/open-liberty-on-aro

The project demonstrates how to prepare and deploy a Java application inside Open/WebSphere Liberty on an Azure Red Hat OpenShift 4 cluster.

page_type	languages	products	description	urlFragment
sample	java	azure	Sample projects for developing and deploying Java applications with Open/WebSphere Liberty on an Azure Red Hat OpenShift 4 cluster.	open-liberty-on-aro

Open/WebSphere Liberty on Azure Red Hat OpenShift Samples

Overview

Azure Red Hat OpenShift provides a flexible, self-service deployment of fully managed OpenShift clusters. Maintain regulatory compliance and focus on your application development, while your master, infrastructure, and application nodes are patched, updated, and monitored by both Microsoft and Red Hat.

Open Liberty is an IBM Open Source project that implements the Eclipse MicroProfile specifications and is also Java/Jakarta EE compatible. Open Liberty is fast to start up with a low memory footprint and supports live reloading for quick iterative development. It is simple to add and remove features from the latest versions of MicroProfile and Java/Jakarta EE. Zero migration lets you focus on what's important, not the APIs changing under you.

WebSphere Liberty architecture shares the same code base as the open sourced Open Liberty server runtime, which provides additional benefits such as low-cost experimentation, customization and seamless migration from open source to production.

This repository contains samples projects for developing and deploying Java applications with Open/WebSphere Liberty on an Azure Red Hat OpenShift 4 cluster. These sample projects show how to use various features in Open/WebSphere Liberty and how to integrate with different Azure services. Below table shows the list of samples available in this repository.

Sample	Description	Guide
1-start	Basic Java EE application with Jakarta EE 10 (Jakarta RESTful Web Services, Jakarta Enterprise Beans, Jakrta CDI, JSON-B, Jakarta Faces, Bean Validation).
2-simple	Migrate 1-start sample to Open/WebSphere Liberty with minimum configurations.	howto-guide
3-integration/elk-logging	Extend 2-simple sample by integrating with Elasticsearch stack for distributed logging.	howto-guide
3-integration/connect-db/mysql	Extend 2-simple sample by integrating with an Azure Database for MySQL - Flexible Server for data persistence.	Deploy a Java application with Open Liberty/WebSphere Liberty on an Azure Red Hat OpenShift cluster
3-integration/connect-db/mssql	Extend 2-simple sample by integrating with a single database - Azure SQL Database for data persistence.	Deploy IBM WebSphere Liberty and Open Liberty on Azure Red Hat OpenShift
3-integration/aad-oidc	Extend 2-simple sample by integrating with Azure Active Directory OpenID Connect for security.	howto-guide
3-integration/aad-ldap	Extend 2-simple sample by integrating with Azure Active Directory Domain Service via Secure LDAP for security.	howto-guide
4-finish	A complete sample with all services integration including security, data persistence & distributed logging.	howto-guide

Contributing

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.

When you submit a pull request, a CLA bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.

open-liberty-on-aro's Issues

Use images from icr.io/appcafe

The best source of images for Liberty is the IBM Container Registry - icr.io/appcafe. These images are built, scanned and certified by the Liberty team and are available unauthenticated and without rate limits. We should update the Dockerfiles to use these images. It should just be a case of prefixing the FROM lines with icr.io/appcafe.

Some comments

1. Add link to [MicroProfile] (https://microprofile.io/)
2. Add link to [Jakarta EE] (https://jakarta.ee/)
3. In the last statement, it might be helpful to put a screen shot on how to find host and port;

Once the Open Liberty application is up and running, open HOST/PORT of the route in your browser to visit the application home page.