A self-hosted instance of Tonic Ephemeral has the following requirements.
The Ephemeral application database stores information about Ephemeral objects and users.
For the application database, you must provide a PostgreSQL database with the following characteristics:
The Kubernetes cluster where you deploy Ephemeral has the following requirements:
Runtime is either:
AWS EKS - For this option, AWS EBS CSI driver must be installed and configured. For details, go to the AWS EBS documentation.
Azure AKS - For this option, Azure Disk CSI driver must be installed and configured. For details, go to the Azure Disk documentation.
Google Cloud Platform (GCP) Google Kubernetes Engine (GKE) - For this option, the Google Compute Engine persistent disk CSI driver must be installed and configured. For details, go to the GKE documentation.
Volume Snapshot CRDs and the Volume Snapshot controller are installed and configured. For installation instructions, go to the kubernetes-csi documentation. For snapshotter documentation, go to the external-snapshotter GitHub repository.
external-dns is installed and configured. For details, go to the external-dns GitHub repository.
(Optional) Kubernetes autoscaler is installed and configured. For details, go to the autoscaler GitHub repository.
Version:
PostgreSQL 16+
Database user:
Must have permission to:
Create a database
Create tables
Insert
Select
System requirements
Requirements for the application database and Kubernetes cluster.
Deploy Ephemeral with Helm
Use the Ephemeral Helm chart to install or upgrade Ephemeral.
A Tonic Ephemeral Helm chart is located at oci://quay.io/tonicai/ephemeral.
During the onboarding process, Tonic.ai provides you with the access credentials to our Quay repository, which includes both the Helm chart and the application images.
Before you pull the Helm chart from the repository, you must authenticate Helm to Quay:
helm registry login quay.io
After you authenticate, to get the values file for the Helm chart, use:
helm show values oci://quay.io/tonicai/ephemeral --version 1.023.0
The file includes documentation about the configuration options and values.
The chart version corresponds to the version of Ephemeral. For example, Ephemeral version 023 has a chart version of 1.023.0.
To install Ephemeral:
helm install -n <your-namespace> ephemeral oci://quay.io/tonicai/ephemeral --version 1.<ephemeral-version>.0 -f values.yaml
To upgrade to a newer version of Ephemeral:
helm upgrade -n <your-namespace> ephemeral oci://quay.io/tonicai/ephemeral --version 1.<ephemeral-version>.0 -f values.yaml