RGS Container

Summary

Creates the Knowledge Module artifacts used by Decision Support Service (DSS).

Attributes

Parameter	Value
Type	Primary
Name	rules-generation-service
Image	rules-generation-service
Image Pull Policy	Always
Command
Arguments
Port	8080
Security Context	Allow Privilege Escalation: false

Endpoints

External-to-Cluster

This container does not have any external-to-cluster exposed endpoints.

Internal

Generate a Knowledge Module

POST /generate

Headers

Name	Type	Description
Content-Type*	String	Should be set to application/json.

Liveness Probe

GET /_k8s-health-check

Refer to the Kubernetes Documentation for more information on probes.

200: OK Container is in a nominal state.

{
    // Response
}

500: Internal Server Error Container is in a failed state.

{
    // Response
}

Readiness Probe

GET /_k8s-health-check

Refer to the Kubernetes Documentation for more information on probes.

200: OK Container is in a nominal state.

{
    // Response
}

500: Internal Server Error Container is in a failed state.

{
    // Response
}

Environment Variables

All environment variables, unless otherwise indicated, are considered required.

General Variables

JAVA_TOOL_OPTIONS

Feature flags and default configuration overrides for the container's embedded JVM.

Example Value

-Xms1536m -Xmx1536m -XX:+UseG1GC -XX:+PrintGCDetails -XX:+PrintGCDateStamps -Xloggc:/hln/diagnostics/garbageCollection.log -XX:+UseGCLogFileRotation -XX:NumberOfGCLogFiles=1 -XX:GCLogFileSize=10m -XX:+UseStringDeduplication	

Explanation of Options

• -Xms1536m: sets the initial heap size allocation to 1.5GB (1536 MiB)

• -Xmx1536m: sets the maximum heap size allocation to 1.5GB (1536 MiB)

• -XX:+UseG1GC: enables the usage of the G1 garbage collector.

• -XX:+PrintGCDetails -XX:+PrintGCDateStamps controls verbosity of garbage collection logging output.

• -Xloggc:/hln/diagnostics/garbageCollection.log path for the garbage collection logging output file.

• -XX:+UseGCLogFileRotation -XX:NumberOfGCLogFiles=1 -XX:GCLogFileSize=10m enables the rotation of log files once the maximum file size of 10MB has been reached.

• -XX:+UseStringDeduplication avoids duplicate garbage collection log entries.

Logging Level Configuration

LOGGING_LEVEL_ROOT Optional

This container supports variable logging level, which gives engineers and operators more granular control over logging output.

Accepted Values

• debug Verbose logging. Useful for triaging.

• info default Standard logging output.

• warn Outputs log events classified as warnings or higher.

• error Outputs log events classified as errors or higher.

• fatal Only fatal, typically uncaught exceptions will be logged.

• silent Disables all logging output.

• trace Extremely verbose logging.

Probes

Liveness

Parameter	Value
Mode	HTTP (GET)
Arguments	Path: /_k8s-health-check Port: 8080 (must match container port)
Timings	Initial Delay of 30s Period of 30s Timeout of 5s
Thresholds	1 Successes 2 Failures

Readiness

Parameter	Value
Mode	HTTP (GET)
Arguments	Path: /_k8s-health-check Port: 8080 (must match container port)
Timings	Initial Delay of 30s Period of 30s Timeout of 5s
Thresholds	1 Successes 2 Failures

Startup

This container does not utilize startup probes.

Resources

Requests

CPU (in millicores)	RAM (in MiB)	Storage (in GiB)
500	1536	N/A

Limits

CPU (in millicores)	RAM (in MiB)	Storage (in GiB)
1000	2048	N/A

Technology Stack

Container is built using an base image that contains JRE8 from OpenJDK repository, and deploys a Spring Boot Java application.

Volume Mounts

Name	Read-Only	Mount Point	Subpath
java-diag		/hln/diagnostics

Workload Identity

Container does not require access to external-to-cluster resources.

Code Owners

Name	Organization	Email
Daryl Chertcoff	HLN Consulting, LLC	[e-mail]