Merge pull request wildfly#595 from tommaso-borgato/wildfly-mini-serie

Wildfly mini serie

_data/guides.yaml

@@ -7,6 +7,9 @@ categories:
       - title: Getting Started with WildFly
         url: /get-started
         description: Build and run a Jakarta EE application with WildFly in a few minutes
+      - title: Java Microservices on Kubernetes with WildFly
+        url: /guides/get-started-microservices-on-kubernetes
+        description: Build and run Jakarta EE applications with WildFly on Kubernetes in a few minutes
   - category: Observability
     cat-id: observability
     guides:

guides/get-started-microservices-on-kubernetes.adoc

@@ -0,0 +1,35 @@
+---
+layout: getstarted
+title: Java Microservices on Kubernetes with WildFly
+---
+:includedir: ./get-started-microservices-on-kubernetes/_includes
+include::{includedir}/_titles.adoc[]
+:page-liquid:
+
+== Build Java Microservices with WildFly and run them on link:https://kubernetes.io/[Kubernetes, window="_blank"].
+
+=== Intro
+
+In this series, you'll learn HOW-TO to build applications using some of the most common link:https://jakarta.ee/[Jakarta EE, window="_blank"] specifications (e.g. Jakarta REST services, Jakarta Persistence, Jakarta Messaging, etc.) and run them on link:https://kubernetes.io/[Kubernetes, window="_blank"].
+
+At some point, we'll go even further and use some link:https://microprofile.io/[MicroProfile, window="_blank"] specifications (e.g. Rest Client invoking a Jakarta REST service in another application).
+
+We will start building a link:https://docs.docker.com/[Docker Image, window="_blank"] containing a WildFly Java Microservice (link:simple-microservice-part1[{simple-microservice-part1}]), and then we will run that Docker Image on link:https://kubernetes.io/[Kubernetes, window="_blank"] (link:simple-microservice-part2[{simple-microservice-part2}]): this will set the basis to extend this example in subsequent guides.
+
+=== Guides in this series
+
+* link:simple-microservice-part1[{simple-microservice-part1}]
+* link:simple-microservice-part2[{simple-microservice-part2}]
+* link:simple-microservice-database-part1[{simple-microservice-database-part1}]
+* link:simple-microservice-database-part2[{simple-microservice-database-part2}]
+* link:simple-microservice-infinispan-part1[{simple-microservice-infinispan-part1}]
+* link:simple-microservice-infinispan-part2[{simple-microservice-infinispan-part2}]
+* link:simple-microservice-jms-part1[{simple-microservice-jms-part1}]
+* link:simple-microservice-jms-part2[{simple-microservice-jms-part2}]
+//* link:get-enterprise-ready[{get-enterprise-ready}]
+
+[[references]]
+== References
+
+* https://microprofile.io/specifications/microprofile-config/[Eclipse MicroProfile Config, window="_blank"]
+

guides/get-started-microservices-on-kubernetes/_includes/_constants.adoc

@@ -0,0 +1,48 @@
+// mini series
+:jaxrs-example-project-groupId: org.wildfly.examples
+:jaxrs-example-project-artifactId: jaxrs
+:jaxrs-example-project-version: 11.0.0.Final-SNAPSHOT
+:version-bootable-jar: 11.0.0.Beta1
+:version-wildfly-galleon-pack: 32.0.0.Final
+:jakarta-jakartaee-api-version: 10.0.0
+:version-junit-jupiter-api: 5.10.2
+:version-arquillian-junit5-container: 1.8.0.Final
+:version-org-wildfly-arquillian-wildfly-arquillian: 5.1.0.Beta1
+:version-resteasy-client: 6.2.7.Final
+:version-wildfly-cloud-galleon-pack: 7.0.0.Final
+:version-wildfly-maven-plugin: 5.0.0.Final
+:my-jaxrs-app-docker-image-name: my-jaxrs-app
+:my-jaxrs-app-db-docker-image-name: my-jaxrs-app-db
+:my-jaxrs-app-infinispan-docker-image-name: my-jaxrs-app-infinispan
+:quay-io-account-name: tborgato
+:version-wildfly-datasources-galleon-pack: 8.0.0.Final
+:postgre-sql-user: postgres
+:postgre-sql-password: admin
+:postgre-sql-host: localhost
+:postgre-sql-port: 5432
+:postgre-sql-database: postgres
+:postgre-sql-jndi: java:jboss/datasources/PostgreSQLDS
+:postgre-docker-image: docker.io/library/postgres
+:postgre-sql-kubernetes-service-name: postgres-service
+:postgre-sql-pod-name: my-postgres
+:infinispan-user: admin
+:infinispan-password: 123pippobaudo
+:infinispan-host: localhost
+:infinispan-port: 11222
+:infinispan-server-docker-image: quay.io/infinispan/server:latest
+:infinispan-cli-docker-image: quay.io/infinispan/cli:latest
+:infinispan-kubernetes-service-name: infinispan-service
+:infinispan-pod-name: my-infinispan
+:source-code-git-repository: https://github.com/wildfly-extras/guides/tree/main/get-started-microservices-on-kubernetes
+:artemis-user: admin
+:artemis-password: admin
+:artemis-port: 61616
+:artemis-console-port: 8161
+:artemis-data-path: /home/jboss/data
+:artemis-docker-image: quay.io/artemiscloud/activemq-artemis-broker-kubernetes:latest
+:artemis-pod-name: my-artemis
+:artemis-kubernetes-service-name: artemis-service
+:artemis-port-name: artemis-port
+:artemis-console-port-name: artemis-console-port
+:my-jms-app-docker-image-name: my-jms-app
+:podman-network-name: demo-network

guides/get-started-microservices-on-kubernetes/_includes/_titles.adoc

@@ -0,0 +1,9 @@
+:simple-microservice-part1: WildFly Java Microservice - PART 1: Docker Image
+:simple-microservice-part2: WildFly Java Microservice - PART 2: Kubernetes
+:simple-microservice-database-part1: Connecting to a DB - PART 1: Docker Image
+:simple-microservice-database-part2: Connecting to a DB - PART 2: Kubernetes
+:simple-microservice-jms-part1: Using a Message Broker - PART 1: Docker Image
+:simple-microservice-jms-part2: Using a Message Broker - PART 2: Kubernetes
+:simple-microservice-infinispan-part1: Using Infinispan remote cache - PART 1: Docker Image
+:simple-microservice-infinispan-part2: Using Infinispan remote cache - PART 2: Kubernetes
+:get-enterprise-ready: Get “Enterprise” ready

guides/get-started-microservices-on-kubernetes/get-enterprise-ready.adoc

@@ -0,0 +1,7 @@
+= {get-enterprise-ready}
+include::./_includes/_titles.adoc[]
+
+
+Back to Guides
+
+< link:../get-started-microservices-on-kubernetes[Back to Getting Started with WildFly micro-services on Kubernetes]