apache / apache/apisix-helm-chart

APISIX Helm Deployment on Minikube fails

Open
#810 1 comment 0 reactions 0 assignees View on GitHub
question
Dominant language
Go Template
Stars
289
Forks
282
Avg merge
15h 55m
Merged PRs (30d)
3

Description

I’m encountering persistent issues deploying the APISIX Helm chart (version `apisix-2.10.0`, app version `3.11.0`) on a Minikube cluster. Despite resolving an initial storage class mismatch, the deployment remains unhealthy: etcd pods run but aren’t ready (0/1), the ingress controller hangs in `Init:0/1`, and the dashboard crashes repeatedly. I suspect compatibility or configuration issues with Minikube or the chart’s defaults. Here’s a detailed breakdown of my setup and troubleshooting steps.

## Environment
- **Chart Version**: `apisix-2.10.0`
- **App Version**: `3.11.0`
- **Minikube**: Started with `minikube start -n=2 --driver=docker` (2 nodes, Docker driver)
- **Kubernetes Client Version**: `v1.30.2`
- **Kubernetes Server Version**: `v1.31.0`
- **Helm Command**: `helm install apisix apisix/apisix --create-namespace -n apisix -f apisix-values.yml`

## Helm Values (`apisix-values.yml`)

```yaml
dashboard:
enabled: true
service:
type: NodePort
ingress-controller:
enabled: true
config:
apisix:
serviceName: release-name-apisix-admin
adminAPIversion: v3
kubernetes:
enableGatewayAPI: true
```

### Initial Pod Status

```sh
kubectl get po -n apisix

NAME READY STATUS RESTARTS AGE
pod/apisix-6699fffc65-78t6v 0/1 Init:0/1 0 20m
pod/apisix-dashboard-5986b9dc66-hh6dh 0/1 CrashLoopBackOff 8 (4m1s ago) 20m
pod/apisix-etcd-0 0/1 CrashLoopBackOff 6 (2m26s ago) 20m
pod/apisix-etcd-1 0/1 CrashLoopBackOff 6 (2m17s ago) 20m
pod/apisix-etcd-2 0/1 Running 6 (2m48s ago) 20m
pod/apisix-ingress-controller-57866db6fc-v88ld 0/1 Init:0/1 0 20m
```

```sh
k describe po apisix-ingress-controller-57866db6fc-v88ld -n apisix

Events:
Normal Scheduled 3m54s default-scheduler Successfully assigned ... to minikube-m02
Warning FailedMount 3m53s kubelet MountVolume.SetUp failed for volume "kube-api-access-48b9d" : failed to sync configmap cache: timed out waiting for the condition
Normal Pulled 3m52s kubelet Container image "busybox:1.28" already present on machine
Normal Created 3m52s kubelet Created container wait-apisix-admin
Normal Started 3m51s kubelet
```

### Current State
- etcd Pods: Running but not ready (0/1) with restarts.
- Ingress Controller: Stuck in `Init:0/1`
- The `FailedMount` suggests a Minikube issue, but the init container (wait-apisix-admin) started, implying it’s waiting for APISIX admin service.
- Dashboard: `CrashLoopBackOff`. Likely waiting for APISIX, which depends on etcd.
- APISIX: Stuck in `Init:0/1`, likely waiting for etcd to become ready.

Could this be a bug in the Helm chart’s defaults or Minikube compatibility?
I’m happy to test suggestions or provide more output. Thanks for any insights!

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.