第十八章： Kubernetes - Rancher 控制面板使用

18.1 安装 Rancher

1. 安装 Helm（Linux 或 macOS）

curl https://get.helm.sh/helm-v3.14.4-linux-amd64.tar.gz -o helm-v3.14.4-linux-amd64.tar.gz
tar -zxvf helm-v3.14.4-linux-amd64.tar.gz
sudo mv linux-amd64/helm /usr/local/bin/helm

验证

helm version

2. 准备域名（必需）

Rancher 必须使用域名访问，不能裸 IP

# Windows / Linux / Mac
192.168.163.4 rancher.example.com

3. 安装 cert-manager（Rancher 依赖）

添加 Helm 仓库

helm repo add jetstack https://charts.jetstack.io
helm repo update

安装 cert-manager

kubectl create namespace cert-manager

helm install cert-manager jetstack/cert-manager \
  --namespace cert-manager \
  --set installCRDs=true

验证：全部 Running 才继续

kubectl get pods -n cert-manager

4. 安装 Rancher

添加 Rancher Helm 仓库

helm repo add rancher-stable https://releases.rancher.com/server-charts/stable
helm repo update

创建 Rancher 命名空间

kubectl create namespace cattle-system

安装 Rancher（推荐自动 TLS）

helm install rancher rancher-stable/rancher \
  --namespace cattle-system \
  --set hostname=rancher.example.com \
  --set replicas=1

说明：

• hostname：必须与你的域名一致
• replicas=1：测试用，生产建议：replicas=3

5. 等 Rancher 启动（需要时间）

kubectl -n cattle-system get pods -w

给 Rancher Ingress 明确指定 nginx

kubectl patch ingress rancher -n cattle-system \
  -p '{"spec":{"ingressClassName":"nginx"}}'

6. 进入 Rancher

获取 admin 密码

kubectl get secret bootstrap-secret \
  -n cattle-system \
  -o go-template='{{.data.bootstrapPassword | base64decode}}{{"\n"}}'

18.2 Rancher 的使用

1. 重置 admin 密码

使用指令重置密码

kubectl -n cattle-system exec -it deploy/rancher -- reset-password

重置密码，设置自定义密码登录进去，最好重新设置一下 admin 密码

这里再次设置一下自定义密码，防止无法登录