Creating Routes to the Wildfly Application and Admin Pages

Oct 13, 2025 by wbrum.org 59 views

Introduction

As a beginner in the world of OpenShift and Kubernetes, navigating the complexities of routing can be overwhelming. In this article, we will explore the process of deploying a Wildfly server on OpenShift Local (CRC) and creating routes to access the application and admin pages. By the end of this guide, you will have a solid understanding of how to configure routes in OpenShift Local (CRC) and access your Wildfly application.

Prerequisites

Before we dive into the deployment process, make sure you have the following prerequisites:

OpenShift Local (CRC) installed on your Windows Notebook
A basic understanding of Kubernetes and OpenShift concepts
Wildfly server installed on your local machine

Deploying Wildfly on OpenShift Local (CRC)

To deploy Wildfly on OpenShift Local (CRC), follow these steps:

Step 1: Create a New Project

First, create a new project in OpenShift Local (CRC) using the following command:

oc new-project wildfly-project

Step 2: Create a Docker Image for Wildfly

Create a Docker image for Wildfly using the following command:

docker build -t wildfly-image .

Step 3: Push the Docker Image to OpenShift Local (CRC)

Push the Docker image to OpenShift Local (CRC) using the following command:

docker tag wildfly-image <your-username>/wildfly-image
docker push <your-username>/wildfly-image

Step 4: Create a Deployment for Wildfly

Create a deployment for Wildfly using the following YAML file:

apiVersion: apps/v1
kind: Deployment
metadata:
  name: wildfly-deployment
spec:
  replicas: 1
  selector:
    matchLabels:
      app: wildfly
  template:
    metadata:
      labels:
        app: wildfly
    spec:
      containers:
      - name: wildfly
        image: <your-username>/wildfly-image
        ports:
        - containerPort: 8080

Apply the YAML file using the following command:

oc apply -f deployment.yaml

Step 5: Create a Service for Wildfly

Create a service for Wildfly using the following YAML file:

apiVersion: v1
kind: Service
metadata:
  name: wildfly-service
spec:
  selector:
    app: wildfly
  ports:
  - name: http
    port: 8080
    targetPort: 8080
  type: ClusterIP

Apply the YAML file using the following command:

oc apply -f service.yaml

Creating Routes to the Wildfly Application and Admin Pages

Now that we have deployed Wildfly on OpenShift Local (CRC), let's create routes to access the application and admin pages.

Step 1: Create a Route for the Wildfly Application

Create a route for the Wildfly application using the following YAML file:

apiVersion: route.openshift.io/v1
kind: Route
metadata:
  name: wildfly-route
spec:
  to:
    kind: Service
    name: wildfly-service
  port:
    targetPort: 8080
  tls:
    termination: passthrough

Apply the YAML file using the following command:

oc apply -f route.yaml

Step 2: Create a Route for the Wildfly Admin Page

Create a route for the Wildfly admin page using the following YAML file:

apiVersion: route.openshift.io/v1
kind: Route
metadata:
  name: wildfly-admin-route
spec:
  to:
    kind: Service
    name: wildfly-service
  port:
    targetPort: 8080
  tls:
    termination: passthrough
  path: /admin

Apply the YAML file using the following command:

oc apply -f admin-route.yaml

Accessing the Wildfly Application and Admin Pages

Now that we have created routes to the Wildfly application and admin pages, let's access them using the following commands:

Access the Wildfly application: oc get route wildfly-route -o jsonpath='{.spec.host}'
Access the Wildfly admin page: oc get route wildfly-admin-route -o jsonpath='{.spec.host}'

Conclusion

In this article, we have explored the process of deploying Wildfly on OpenShift Local (CRC) and creating routes to access the application and admin pages. By following the steps outlined in this guide, you should now have a solid understanding of how to configure routes in OpenShift Local (CRC) and access your Wildfly application.

Troubleshooting

If you encounter any issues during the deployment process, refer to the following troubleshooting tips:

Check the OpenShift Local (CRC) logs for any errors: oc logs -f
Verify that the Wildfly image is correctly pushed to OpenShift Local (CRC): docker images
Check the route configuration for any errors: oc get route <route-name> -o jsonpath='{.spec}'

Frequently Asked Questions

In this article, we will address some of the most frequently asked questions related to deploying Wildfly on OpenShift Local (CRC).

Q: What is OpenShift Local (CRC)?

A: OpenShift Local (CRC) is a local version of OpenShift that allows developers to run OpenShift on their local machine. It provides a sandbox environment for testing and developing applications before deploying them to a production environment.

Q: What is Wildfly?

A: Wildfly is a Java-based application server that provides a robust and scalable platform for developing and deploying enterprise-level applications.

Q: How do I deploy Wildfly on OpenShift Local (CRC)?

A: To deploy Wildfly on OpenShift Local (CRC), follow these steps:

Create a new project in OpenShift Local (CRC) using the oc new-project command.
Create a Docker image for Wildfly using the docker build command.
Push the Docker image to OpenShift Local (CRC) using the docker push command.
Create a deployment for Wildfly using the oc apply command.
Create a service for Wildfly using the oc apply command.

Q: How do I create routes to the Wildfly application and admin pages?

A: To create routes to the Wildfly application and admin pages, follow these steps:

Create a route for the Wildfly application using the oc apply command.
Create a route for the Wildfly admin page using the oc apply command.

Q: How do I access the Wildfly application and admin pages?

A: To access the Wildfly application and admin pages, use the following commands:

Access the Wildfly application: oc get route wildfly-route -o jsonpath='{.spec.host}'
Access the Wildfly admin page: oc get route wildfly-admin-route -o jsonpath='{.spec.host}'

Q: What are some common issues that may arise during deployment?

A: Some common issues that may arise during deployment include:

Incorrect Wildfly image configuration
Incorrect route configuration
Issues with OpenShift Local (CRC) logs

Q: How do I troubleshoot issues during deployment?

A: To troubleshoot issues during deployment, follow these steps:

Check the OpenShift Local (CRC) logs for any errors: oc logs -f
Verify that the Wildfly image is correctly pushed to OpenShift Local (CRC): docker images
Check the route configuration for any errors: oc get route <route-name> -o jsonpath='{.spec}'

Q: What are some best practices for deploying Wildfly on OpenShift Local (CRC)?

A: Some best practices for deploying Wildfly on OpenShift Local (CRC) include:

Use a consistent naming convention for projects and resources
Use labels and selectors to organize and manage resources
Use OpenShift Local (CRC) features such as build and deployment pipelines to automate the deployment process

Conclusion

In this article, we have addressed some of the most frequently asked questions related to deploying Wildfly on OpenShift Local (CRC). By following the steps outlined in this guide, you should now have a solid understanding of how to deploy Wildfly on OpenShift Local (CRC) and troubleshoot common issues that may arise during deployment.