Setting up a Kubernetes cluster to use to write output data to container artifacts
A Docker instance of Tonic Structural does not automatically support the option to write destination data to a container artifact.
To enable this option, you can set up a separate Kubernetes cluster. You then configure Structural environment settings to enable Structural to use that Kubernetes cluster as the destination location.
Installing the Kubernetes cluster
You can install the Kubernetes cluster on the same server where Docker is installed, or on a remote host that has network access to the Docker server.
You can use any compatible Kubernetes distribution. Here are links to the installation instructions for a few different options that will work:
The Structural service account must have the permissions listed in Required access to write destination data to container artifacts.
Setting the host location in the mounted kubeconfig
In the kubeconfig file, you must change the server
property value from localhost
to either:
If the cluster is remote, the Kubernetes host IP address or hostname
If the cluster is on the same host, to
host.docker.internal
Configuring Structural environment settings
To allow Structural to connect to the Kubernetes cluster and to write destination data to it, you must configure the following environment settings.
You can add these settings manually to the list on the Environment Settings tab of Structural Settings.
Specifying the kubeconfig path
To allow Structural to write output data to the Kubernetes cluster, Structural also needs the path where kubeconfig is mounted to the Structural worker.
In the Docker Compose file, to specify the kubeconfig path, add the KUBECONFIG
environment variable to the tonic_worker environment
section.
Last updated