AWS SDK

OpenShift Vert.x cartridge

This project provides a cartridge for OpenShift v2 to deploy and run Vert.x 3 applications. It simplifies the deployment process by using a fat JAR approach, where the application and its dependencies are bundled into a single executable JAR file. The cartridge handles environment-specific configurations, scaling, and clustering for Vert.x applications on the OpenShift platform. ## Key Features - **Fat JAR Deployment** — Applications are deployed as self-contained fat JARs, embedding all dependencies. - **OpenShift Integration** — Configures Vert.x to bind to OpenShift-provided HTTP ports and addresses automatically. - **Scalability Support** — Enables horizontal scaling of application instances through OpenShift's scaling features. - **Clustering** — Supports Hazelcast-based clustering for scaled applications, with customizable cluster configuration. - **Environment Configuration** — Allows customization of JVM parameters, Vert.x run options, and logging via environment files. - **WebSocket Handling** — Manages WebSocket connections on separate ports (8000/8433) as required by OpenShift's routing. ## Philosophy The cartridge is designed to provide a seamless deployment experience for Vert.x applications on OpenShift, abstracting away platform-specific complexities while offering flexibility for advanced configurations.

OpenShift DIY cartridge

This project provides a template and instructions for deploying Vert.x 3 applications on the OpenShift platform using the Do-It-Yourself (DIY) cartridge. It enables developers to run reactive, non-blocking applications on OpenShift with Java 8 support, even though the DIY cartridge does not support automatic scaling. ## Key Features - **OpenShift DIY Cartridge Integration** — Uses the DIY cartridge to deploy Vert.x applications on OpenShift. - **Java 8 Provisioning** — Includes scripts to install Java 8 if not already available on the OpenShift environment. - **Fat Jar Deployment** — Supports deploying Vert.x applications packaged as executable fat jars. - **Environment-Aware Binding** — Configures the HTTP server to bind to OpenShift-provided IP and port via environment variables. - **Git-Based Deployment** — Leverages Git pushes to trigger application redeployment on OpenShift. ## Philosophy The project focuses on simplicity and practicality, providing a straightforward method to run Vert.x applications on OpenShift despite the cartridge's scalability limitations, making it accessible for development and testing scenarios.