Deploy your InfluxDB cluster

• kubectl standard deployment (with internet access)
• kubectl air-gapped deployment

kubectl standard deployment (with internet access)

Use the kubectl apply command to apply your custom-configured myinfluxdb.yml and deploy your InfluxDB cluster:

kubectl apply \
  --filename myinfluxdb.yml \
  --namespace influxdb

Standard and air-gapped deployments

This approach avoids the need for installing the kubit operator in the cluster, making it ideal for air-gapped clusters.

1. On a machine with internet access, download the kubit CLI–for example:

   curl -L -o kubit https://github.com/kubecfg/kubit/archive/refs/tags/v0.0.20.tar.gz
   chmod +x kubit
   

   • Copy
   • Fill window

   Replace v0.0.20 with the latest release version.

2. If deploying InfluxDB in an air-gapped environment (without internet access), transfer the binary to your air-gapped environment.

3. Use the kubit local apply command to process your custom-configured myinfluxdb.yml locally and apply the resulting resources to your cluster:

   # Point to Docker credentials that have access to your registry
   # (public registry for standard deployments or private registry for air-gapped)
   DOCKER_CONFIG=/path/to/credentials kubit local apply myinfluxdb.yml
   

   • Copy
   • Fill window

   If your local system doesn’t have required tools installed, use Docker mode:

   # For Linux or macOS
   DOCKER_CONFIG=/path/to/credentials kubit local apply --docker myinfluxdb.yml
   

   • Copy
   • Fill window

The kubit local apply command processes your AppInstance resource locally and applies the resulting Kubernetes resources directly to your cluster.

• Helm standard deployment (with internet access)
• Helm air-gapped deployment

Helm standard deployment (with internet access)

1. Add the InfluxData Helm chart repository:

   helm repo add influxdata https://helm.influxdata.com/
   

   • Copy
   • Fill window

2. Update your Helm repositories to ensure you have the latest charts:

   helm repo update
   

   • Copy
   • Fill window

3. Deploy the InfluxDB Clustered Helm chart with your customized values.yaml:

   helm install influxdb influxdata/influxdb3-clustered \
     -f values.yaml \
     --namespace influxdb \
     --create-namespace
   

   • Copy
   • Fill window

If you need to update your deployment after making changes to your values.yaml, use the helm upgrade command:

helm upgrade influxdb influxdata/influxdb3-clustered \
  -f values.yaml \
  --namespace influxdb

Helm air-gapped deployment

1. On a machine with internet access, download the Helm chart:

   # Add the InfluxData repository
   helm repo add influxdata https://helm.influxdata.com/
   
   # Update the repositories
   helm repo update
   
   # Download the chart as a tarball
   helm pull influxdata/influxdb3-clustered --version X.Y.Z
   

   • Copy
   • Fill window

   Replace X.Y.Z with the specific chart version you want to use.

2. Transfer the chart tarball to your air-gapped environment using your secure file transfer method.

3. In your air-gapped environment, install the chart from the local tarball and values from your customized values.yaml:

   helm install influxdb ./influxdb3-clustered-X.Y.Z.tgz \
     -f values.yaml \
     --namespace influxdb \
     --create-namespace
   

   • Copy
   • Fill window

4. Verify the deployment:

   kubectl get pods -n influxdb
   

   • Copy
   • Fill window

If you need to update your deployment after making changes to your values.yaml, use the helm upgrade command:

helm upgrade influxdb ./influxdb3-clustered-X.Y.Z.tgz \
  -f values.yaml \
  --namespace influxdb