Skip to main content
Welcome to Virtru's support portal. As we work to make this page more accessible to screen readers, please contact us at support@virtru.com for technical support.

Generate VPK Chart Details on Kubernetes Cluster

  • Updated

Overview

When configuring the Virtru Private Keystore for a Virtru Solutions for Kubernetes installation, you must generate the chart details required for deployment.

A common approach is to perform this step on a Linux server, complete the installation there, and then transfer the generated values into the Kubernetes cluster. However, you can also generate these chart details directly from within the Kubernetes environment by following the steps below.

Background

Generating the chart details directly on the Kubernetes cluster can reduce operational overhead by eliminating the need to provision a separate Linux server and manually transfer values into a Helm chart.

For new deployments, you may need to create environment variables on the Kubernetes cluster before beginning setup. This process requires the uuidgen utility.

If uuidgen is not available, setup may fail with an error indicating that the command could not be found.

What is uuidgen?

uuidgen is a command-line utility that generates a UUID (Universally Unique Identifier), for example:

550e8400-e29b-41d4-a716-446655440000

This utility is commonly used during setup to generate unique environment variable values.

Why this error occurs

In Kubernetes environments, this issue typically occurs for one of the following reasons:

  • uuidgen is not installed
  • uuidgen is installed, but not available in the system PATH
  • The environment is using a minimal Linux or container image that does not include the utility

Resolution

Install uuidgen on the system where you are preparing or running the deployment.

Ubuntu / Debian

This method works in GKE and may also work in AWS, Azure, or other Kubernetes environments. Other methods for installing uuidgen at runtime may also be valid depending on your setup.

sudo apt update
sudo apt install uuid-runtime

RHEL / CentOS / Fedora

sudo dnf install util-linux

If dnf is not available, use:

sudo yum install util-linux

Alpine

apk add util-linux

macOS

uuidgen is usually available by default. To verify, run:

which uuidgen
uuidgen

If needed, you can install supporting utilities with Homebrew, but in most cases no additional installation is required.

Verify the installation

After installation, confirm that uuidgen is available:

which uuidgen
uuidgen

If installation was successful, the command will return the path to uuidgen and generate a UUID.

Generate the Chart Details

Once uuidgen is installed and available

  1. Navigate to the cks directorty: cd cks 
  2. Run the script to generate the required chart details.
./generate-helm-details.sh

Alternative option

If you are unable to generate the required values directly on the Kubernetes cluster, you can use the traditional workflow instead:

  1. Generate the values on a Linux server
  2. Copy the generated values into your Helm chart configuration

Next step Proceed to: Deployment via Helm

Related articles