Integrate TimescaleDB in a Kubernetes cluster

Running TimescaleDB on Kubernetes is similar to running Postgres. This procedure outlines the steps for a non-distributed system.

To connect your Kubernetes cluster to self-hosted TimescaleDB running in the cluster:

1. Create a default namespace for Tiger Data components

2. Create the Tiger Data namespace:

3. Set this namespace as the default for your session:

For more information, see [Kubernetes Namespaces][kubernetes-namespace].

1. Set up a persistent volume claim (PVC) storage

To manually set up a persistent volume and claim for self-hosted Kubernetes, run the following command:

1. Deploy TimescaleDB as a StatefulSet

By default, the [TimescaleDB Docker image][timescale-docker-image] you are installing on Kubernetes uses the default Postgres database, user and password. To deploy TimescaleDB on Kubernetes, run the following command:

1. Allow applications to connect by exposing TimescaleDB within Kubernetes

2. Create a Kubernetes secret to store the database credentials

3. Deploy an application that connects to TimescaleDB

4. Test the database connection

5. Create and run a pod to verify database connectivity using your [connection details][connection-info] saved in timescale-secret:

6. Launch the Postgres interactive shell within the created test-pod:

You see the Postgres interactive terminal.