Skip to main content
This section is going to be focused on showing how you can work with Aletyx Playground to fully make it your enterprise’s own.

Deploying in a Containerized Environment

Customizing the Git Providers for Aletyx Playground

Today Aletyx Playground provides support for the following Git providers with plans to expand to more in the future:
  • GitHub
  • BitBucket Cloud
  • GitHub Enterprise

To Add a Supported Git Provider

To add a supported Git Provider, your environment variable passed into Aletyx Playground would look similar to the sample.

Configuring Architecture Connections between Aletyx Playground and CORS-Proxy and Extended Services

KIE_SANDBOX_EXTENDED_SERVICES_URL KIE_SANDBOX_CORS_PROXY_URL

Building a Custom Commit Validation Message Checking Service

KIE_SANDBOX_CUSTOM_COMMIT_MESSAGE_VALIDATION_SERVICE_URL: http://localhost:3000/validate Service must return:

Custom Commit Validation Service Build

The following is a sample service that can obviously be extended far further than a character counting message, but does provide a lot of the basis for creating a commit message validation service.
  1. Set up your project:
  1. Copy both main.go and go.mod files into the directory:
  1. Create a Dockerfile to run the Go Application within:
  1. Build the application:
  1. Run the service:
  1. Test with a sample request:
Now that this service is setup, change your Aletyx Playground’s KIE_SANDBOX_CUSTOM_COMMIT_MESSAGE_VALIDATION_SERVICE_URL variable to having http://localhost:5555/validate to enable git commit message validation!

Branding Customization

You can customize the appearance of Aletyx Playground by replacing logo images:
  • Replace app_logo_rgb_fullcolor_reverse.svg for the homepage logo
  • Replace app_logo_rgb_fullcolor_default.svg for the info screen logo
  • SVGs should have a maximum height of 38 pixels
Example:

Custom Dev Deployment Images

Organizations can create custom deployment images with specific configurations:
  • Based on the apache/incubator-kie-sandbox-dev-deployment-quarkus-blank-app:10.0.0 image or custom images
  • Must include the Dev Deployment Upload Service
  • Must implement a /q/health endpoint
  • Can pre-configure asset extraction locations

Custom Accelerators

Accelerators can be customized to implement organization-specific templates:
  • Define project structures tailored to your organization
  • Include CI/CD pipelines for your deployment environment
  • Apply coding standards and best practices
  • Incorporate security configurations and dependencies

Working with VSCode and Aletyx Playground