Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ocp-devspaces-gamification/quarkus-microservices-kustomize-openshift-argocd
Showcase how to create, configure, and deploy multiple Quarkus microservices using Kustomize for configuration management, OpenShift Dev Spaces for development, and ArgoCD for continuous delivery.
https://github.com/ocp-devspaces-gamification/quarkus-microservices-kustomize-openshift-argocd
argocd gitlab kustomize openshift quarkus
Last synced: 22 days ago
JSON representation
Showcase how to create, configure, and deploy multiple Quarkus microservices using Kustomize for configuration management, OpenShift Dev Spaces for development, and ArgoCD for continuous delivery.
- Host: GitHub
- URL: https://github.com/ocp-devspaces-gamification/quarkus-microservices-kustomize-openshift-argocd
- Owner: ocp-devspaces-gamification
- Created: 2024-10-10T15:06:21.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2024-10-12T23:21:21.000Z (3 months ago)
- Last Synced: 2024-10-18T19:34:23.214Z (2 months ago)
- Topics: argocd, gitlab, kustomize, openshift, quarkus
- Language: Java
- Homepage:
- Size: 260 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
### Comprehensive Demo: Multi-Service Quarkus Application with Kustomize, OpenShift Dev Spaces, and ArgoCD
#### **Objective:**
Showcase how to create, configure, and deploy multiple Quarkus microservices using Kustomize for configuration management, OpenShift Dev Spaces for development, and ArgoCD for continuous delivery.
### Optional:
* Fork Repo into personal repo
* Update the files below for your enviornment
`Change the Git URL to yours`
```ssh
$ ls -l cluster-config/apps/devspaces
total 36
-rw-rw-r--. 1 user user 602 Oct 12 14:19 cert-manager-operator.yaml
-rw-rw-r--. 1 user user 612 Oct 12 14:19 devspaces-instance.yaml
-rw-rw-r--. 1 user user 611 Oct 12 14:19 devspaces-operator.yaml
-rw-rw-r--. 1 user user 590 Oct 12 14:19 gitlab-instance.yaml
-rw-rw-r--. 1 user user 590 Oct 12 14:19 gitlab-operator.yaml
-rw-rw-r--. 1 user user 668 Oct 12 14:19 openshift-container-storage-noobaa.yaml
-rw-rw-r--. 1 user user 682 Oct 12 14:19 openshift-data-foundation-operator.yaml
-rw-rw-r--. 1 user user 652 Oct 12 14:19 quay-registry-instance.yaml
-rw-rw-r--. 1 user user 656 Oct 12 14:19 quay-registry-operator.yaml
```
`Change the Domain`
```ssh
$ cat cluster-config/gitlab/instances/patch-gitlab-domain.yaml
apiVersion: apps.gitlab.com/v1beta1
kind: GitLab
metadata:
name: gitlab
namespace: gitlab-system
spec:
chart:
values:
global:
hosts:
domain: apps.cluster-xxxxx.xxxxx.sandbox0000.opentlc.com
```
* Configure Cluster
```sh
oc apply -k cluster-config/apps/devspaces
```
#### **Demo Steps:**
## Building the Applications
### For `service-a`
1. **Navigate to the `service-a` directory:**
```sh
cd service-a
```
2. **Build the application:**
```sh
./mvnw clean package -Dnative
```
3. Login to Quay registry
```sh
docker login quay-registry-quay-quay-registry.apps.your-ocp4-cluster.com
```
4. **Build the Docker image:**
```sh
docker build -t quay-registry-quay-quay-registry.apps.your-ocp4-cluster.com/service-a:latest .
```
5. **Push the Docker image to your registry:**
```sh
docker push quay-registry-quay-quay-registry.apps.your-ocp4-cluster.com/service-a:latest
```
### For `service-b`
1. **Navigate to the `service-b` directory:**
```sh
cd ../service-b
```
2. **Build the application:**
```sh
./mvnw clean package -Dnative
```
3. **Build the Docker image:**
```sh
docker build -t quay-registry-quay-quay-registry.apps.your-ocp4-cluster.com/service-b:latest .
```
4. **Push the Docker image to your registry:**
```sh
docker push quay-registry-quay-quay-registry.apps.your-ocp4-cluster.com/service-b:latest
```
## Testing the Applications Locally
### For `service-a`
1. **Run the application locally:**
```sh
./mvnw quarkus:dev
```
2. **Test the endpoint:**
```sh
curl http://localhost:8080/quote/isaac-newton
```
### For `service-b`
1. **Run the application locally:**
```sh
./mvnw quarkus:dev
```
2. **Test the endpoint:**
```sh
curl http://localhost:8080/hello
```
## Deploying the Applications Using Kustomize
### Update the following files
```sh
$ cat cluster-config/service-a/patch-pull-secret-data.yaml
apiVersion: v1
kind: Secret
metadata:
name: quay-pull-secret
namespace: microservice-demo
data:
.dockerconfigjson: CHANGEME
```
```sh
$ cat cluster-config/service-a/patch-image.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
name: service-a
spec:
template:
spec:
containers:
- name: service-a
image: quay-registry-quay-quay-registry.apps.cluster-xxxxx.xxxxx.sandbox0000.opentlc.com/user1/service-a
```
```sh
$ cat cluster-config/service-b/patch-image.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
name: service-b
spec:
template:
spec:
containers:
- name: service-b
image: quay-registry-quay-quay-registry.apps.cluster-xxxxx.xxxxx.sandbox0000.opentlc.com/user1/service-b
```
### Example Deployment and Service for `service-a`
```sh
# Test the configuration
kustomize build cluster-config/service-a
# Deploy the configurtation
oc apply -k cluster-config/service-a
```
### Example Deployment and Service for `service-b`
```sh
# Test the configuration
kustomize build cluster-config/service-b
# Deploy the configurtation
oc apply -k cluster-config/service-b
```
## Testing the Integration
Once the services are deployed, you can test the integration by accessing the endpoints of `service-a` and `service-b`.
### Testing service-a
```
$ curl -w '\n' https://$(oc get routes -n microservice-demo | grep service-a | awk '{print $2}')/quote/nikola-tesla
The present is theirs; the future, for which I have really worked, is mine. - Nikola Tesla
```
### Testing service-b
```
$ curl -w '\n' https://$(oc get routes -n microservice-demo | grep service-b | awk '{print $2}')/quote/sean-gerety
The technology you use impresses no one. The experience you create with it is everything. - Sean Gerety
```
# Bonus
* Integrate the service with ArgoCD so it is integrated with the cluster deployment.