VCS Container

Summary

Performs the translation from eICR to vMR payloads, which is then wrapped by the RCKM Shared Service (SS) prior to transport to the Decision Support Service (DSS).

Attributes

Parameter	Value
Type	Primary
Name	vmr-converter-service
Image	vmr-converter-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

Convert an eICR payload to a qualified vMR payload

POST /convert

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

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

Explanation of Options

• -Xms1g: sets the initial heap size allocation to 1GB (1024 MiB)

• -Xmx2g: sets the maximum heap size allocation to 2GB (2048 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)
1500	2048	N/A

Limits

CPU (in millicores)	RAM (in MiB)	Storage (in GiB)
2000	2560	N/A

Technology Stack

Container is built using an Alpine Linux base image that contains JDK8 from Adoptium's Eclipse Temurin 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
Jesse Bonzo	HLN Consulting, LLC	[e-mail]
Blake Minghelli	HLN Consulting, LLC	[e-mail]