使用 Helm 安装 Redis 集群

在 Kubernetes 集群中使用 Helm 安装 Redis 集群可以极大地简化部署和管理 Redis 的过程。本文将详细介绍如何使用 Helm 安装 Redis 集群，并提供一些常见问题的解决方案。

前提条件

• Kubernetes 集群。（略）
• 已安装 Helm 工具。
• 搭建了存储类nfs-storage

提示：搭建存储类 nfs-storage，可以参考另一篇文章-第二小节， 点击查看

一、安装 Helm

1. 下载 Helm

首先，访问 Helm 官网 下载适用于您 Kubernetes 版本的 Helm。这里假设 Kubernetes 版本是 1.27.7，因此需要下载对应版本的 Helm。

wget https://get.helm.sh/helm-v3.9.4-linux-amd64.tar.gz
tar xf helm-v3.9.4-linux-amd64.tar.gz
mv linux-amd64/helm /usr/local/bin/
helm version

2. 配置 Helm 仓库

安装完成后，添加一些常见的 Helm 仓库，如 Bitnami、Aliyun 和 Azure 等。

helm repo add bitnami https://charts.bitnami.com/bitnami
helm repo add stable http://mirror.azure.cn/kubernetes/charts
helm repo add aliyun https://kubernetes.oss-cn-hangzhou.aliyuncs.com/charts
helm repo add incubator https://charts.helm.sh/incubator
helm repo update

3. 搜索 Redis Chart

使用 Helm 搜索可用的 Redis Chart。

helm search repo redis

4. 拉取 Redis Cluster Chart

根据搜索结果拉取所需的 Redis 集群 Chart。此时，我们可以下载 Redis 集群的 Chart 包：

helm pull bitnami/redis-cluster

如果此操作失败，您还可以通过直接下载 Chart 包来解决：

wget https://charts.bitnami.com/bitnami/redis-cluster-11.4.0.tgz
tar xf redis-cluster-11.4.0.tgz
cd redis-cluster

二、配置 Redis 集群

1. 修改 values.yaml 配置文件

编辑 values.yaml 文件，以指定存储类、密码等配置：

global:
  imageRegistry: ""
  imagePullSecrets: []
  storageClass: "nfs-storage"  # 这里使用的是 NFS 存储类
  redis:
    password: "123456"
usePassword: true
password: "123456"
persistence:
  storageClass: "nfs-storage"
  accessModes:
    - ReadWriteMany
  size: 8Gi
updateJob:
  resources:
     requests:
       cpu: 2
       memory: 512Mi
     limits:
       cpu: 3
       memory: 1024Mi
service:
  type: NodePort  # 这里可以修改ClusterIP或者NodePort

2. 安装 Redis 集群

完成配置后，使用 Helm 安装 Redis 集群：

helm install redis-cluster ./redis-cluster

3. 查看 Redis Pod

安装完成后，您可以查看 Redis 集群的 Pod 状态，确保它们已成功启动：

kubectl get pod -n default

三、常见错误及解决方法

1. Redis 镜像版本问题

如果安装失败，可能是由于 Redis 集群镜像版本不匹配。您可以尝试使用 latest 标签来拉取最新的镜像。

docker images
REPOSITORY                                  TAG                  IMAGE ID       CREATED       SIZE
docker-0.unsee.tech/bitnami/redis-cluster   latest               b26f68aaf802   10 days ago   144MB

2. PVC 无法绑定 PV

如果 PVC 无法绑定 PV，您需要手动创建 PersistentVolume（PV）以供使用：

apiVersion: v1
kind: PersistentVolume
metadata:
  name: redis-cluster-pv-0
spec:
  capacity:
    storage: 8Gi
  accessModes:
    - ReadWriteMany
  persistentVolumeReclaimPolicy: Retain
  storageClassName: nfs-storage
  nfs:
    server: 192.168.80.130
    path: /data/nfs-demo/redis-data-redis-cluster-0
---
apiVersion: v1
kind: PersistentVolume
metadata:
  name: redis-cluster-pv-1
spec:
  capacity:
    storage: 8Gi
  accessModes:
    - ReadWriteMany
  persistentVolumeReclaimPolicy: Retain
  storageClassName: nfs-storage
  nfs:
    server: 192.168.80.130
    path: /data/nfs-demo/redis-data-redis-cluster-1
....依次类推

说明：PVC 和 PV 之间的绑定关系是通过 storageClassName 和 accessModes 来进行匹配的，而 PVC 请求的存储容量应小于等于 PV 的容量。

3. 确保 NFS 服务器目录已创建并有写权限

在 NFS 服务器上，您需要确保相关目录已经创建并具有适当的写权限。例如：

/data/nfs-demo/redis-data-redis-cluster-0
/data/nfs-demo/redis-data-redis-cluster-1

4. Redis 集群未正确创建

如果 Pod 已经启动，但 Redis 集群没有创建，您可以通过以下命令手动创建 Redis 集群：

kubectl exec -it redis-cluster-0 -- redis-cli --cluster create \
  10.0.1.247:6379 \
  10.0.1.61:6379 \
  10.0.1.190:6379 \
  10.0.1.91:6379 \
  10.0.1.35:6379 \
  10.0.1.2:6379 \
  --cluster-replicas 1

然后，可以使用以下命令验证集群状态：

kubectl exec -it redis-cluster-0 -- redis-cli -c -h 10.0.1.247 -p 6379 cluster info

查看所有节点的详细信息：

kubectl exec -it redis-cluster-0 -- redis-cli -c -h 10.0.1.247 -p 6379 cluster nodes

如果使用的NodePort类型的Service，可通过以下命令测试：

redis-cli -h <节点IP地址> -p <端口> -a <密码>
查看端口：
kubectl get svc

5. CoreDNS 配置问题

如果运行 kubectl logs -n kube-system -l k8s-app=kube-dns 时遇到以下错误：

[ERROR] plugin/errors: 2 redis-cluster-0.redis-cluster-headless. AAAA: read udp 10.0.0.180:35846->8.8.8.8:53: i/o timeout

说明 CoreDNS 在解析 Redis 集群的域名时出现问题，您可以通过以下步骤解决：

1. 检查 CoreDNS 配置：

kubectl -n kube-system get configmap coredns -o yaml

2. 修改 /etc/systemd/resolved.conf 配置并重启：

sudo vi /etc/systemd/resolved.conf
[Resolve]
DNS=8.8.8.8 1.1.1.1

然后执行以下命令重启服务：

sudo systemctl restart systemd-resolved

3. 修改 Kubernetes 节点的 /etc/resolv.conf：

sudo vi /etc/resolv.conf
nameserver 8.8.8.8
nameserver 1.1.1.1

4. 更新 CoreDNS 配置：

kubectl -n kube-system edit configmap coredns

将 DNS 配置修改为：

forward . 8.8.8.8 1.1.1.1

重启 CoreDNS 部署：

kubectl -n kube-system rollout restart deployment coredns

验证网络连接和 DNS 配置：

ping 8.8.8.8
nslookup google.com
kubectl exec -it redis-cluster-0 -- nslookup redis-cluster-1.redis-cluster-headless

总结

使用 Helm 安装 Redis 集群是一种简单而高效的方式，能够帮助我们快速部署 Redis 服务。在安装过程中，可能会遇到一些常见问题，例如镜像版本不匹配、PVC 无法绑定 PV 等。通过本文的步骤和解决方案，您应该能够顺利解决这些问题并成功部署 Redis 集群。

希望本文对您有所帮助，如果有任何问题，请随时与我联系！