Initial commit: k3s deployment configurations
This commit is contained in:
K3s Admin
23
k3s/tool/portainer-ingress.yaml
Normal file
23
k3s/tool/portainer-ingress.yaml
Normal file
@@ -0,0 +1,23 @@
|
||||
apiVersion: networking.k8s.io/v1
|
||||
kind: Ingress
|
||||
metadata:
|
||||
name: portainer-ingress
|
||||
namespace: portainer
|
||||
annotations:
|
||||
cert-manager.io/cluster-issuer: letsencrypt-prod
|
||||
spec:
|
||||
tls:
|
||||
- hosts:
|
||||
- portainer.u9.net3w.com # <--- 换个新子域名
|
||||
secretName: portainer-tls
|
||||
rules:
|
||||
- host: portainer.u9.net3w.com
|
||||
http:
|
||||
paths:
|
||||
- path: /
|
||||
pathType: Prefix
|
||||
backend:
|
||||
service:
|
||||
name: portainer
|
||||
port:
|
||||
number: 9000
|
||||
148
k3s/tool/portainer.md
Normal file
148
k3s/tool/portainer.md
Normal file
@@ -0,0 +1,148 @@
|
||||
这是一个非常棒的想法！天天面对黑底白字的命令行确实容易累，而且在查看日志流、多 Pod 资源占用时，图形化界面（GUI）有着无法比拟的优势。
|
||||
|
||||
对于 K3s，我有 **三个最强推荐**，分别对应不同的使用场景。
|
||||
|
||||
---
|
||||
|
||||
### 方案一：最强桌面端神器 —— OpenLens (推荐开发使用)
|
||||
|
||||
如果您希望在**自己的电脑（Windows/Mac）**上管理远程的 K3s，而不占用 VPS 的资源，Lens 是绝对的王者。它就像是一个专门用来操作 K8s 的“远程桌面”。
|
||||
|
||||
**优点：**
|
||||
|
||||
* **零资源占用**：运行在您自己电脑上，不消耗 VPS 内存。
|
||||
* **功能极其强大**：查看日志、进入终端、编辑 YAML、查看监控，点击即达。
|
||||
* **体验流畅**：原生应用，比网页版更丝滑。
|
||||
|
||||
#### 🚀 如何连接 (只需 3 步)
|
||||
|
||||
要让本地的 Lens 连上远程的 K3s，您需要把 VPS 上的“钥匙”拿回来。
|
||||
|
||||
1. **在 VPS 上获取 Kubeconfig**：
|
||||
执行命令查看配置文件内容：
|
||||
```bash
|
||||
cat /etc/rancher/k3s/k3s.yaml
|
||||
|
||||
```
|
||||
|
||||
|
||||
*(复制这一大段内容)*
|
||||
2. **在本地电脑创建配置文件**：
|
||||
在您的电脑上新建一个文件（例如 `my-k3s-config`），粘贴刚才的内容。
|
||||
**⚠️ 关键修改**：找到 `server: https://127.0.0.1:6443` 这一行，把 `127.0.0.1` 改成您的 **域名** (比如 `dev.u9.net3w.com`，前提是 6443 端口已开放) 或者 **VPS 公网 IP**。
|
||||
3. **导入 Lens**：
|
||||
下载并安装 **OpenLens** (免费开源版) 或 **Lens Desktop**。
|
||||
打开软件 -> File -> Add Cluster -> 粘贴刚才修改后的配置内容。
|
||||
|
||||
**瞬间，您的 K3s 集群全貌就会展现在眼前！**
|
||||
|
||||
---
|
||||
|
||||
### 方案二：最强网页版 —— Portainer (推荐运维/监控)
|
||||
|
||||
如果您希望打开浏览器就能管理，而且您习惯了 Docker 的管理方式，那么 **Portainer** 是不二之选。它对 K8s 的支持非常友好，界面简洁漂亮。
|
||||
|
||||
**优点：**
|
||||
|
||||
* **随时随地访问**：有浏览器就能管。
|
||||
* **可视化极佳**：有漂亮的仪表盘，能看到 CPU/内存使用率。
|
||||
* **部署简单**：它自己就是 K3s 里的一个 Pod。
|
||||
|
||||
#### 🚀 如何安装 (30秒搞定)
|
||||
|
||||
直接在您的 VPS 上执行：
|
||||
|
||||
1. **安装 Portainer**：
|
||||
```bash
|
||||
kubectl apply -n portainer -f https://raw.githubusercontent.com/portainer/k8s/master/deploy/manifests/portainer/portainer.yaml
|
||||
|
||||
```
|
||||
|
||||
|
||||
*(这一步会自动创建命名空间和所有资源)*
|
||||
2. **暴露端口 (我们要用 NodePort 访问)**：
|
||||
默认 Portainer 用的是 LoadBalancer，我们改一下让它能直接通过端口访问。
|
||||
```bash
|
||||
# 编辑服务配置
|
||||
kubectl edit service portainer -n portainer
|
||||
|
||||
```
|
||||
|
||||
|
||||
找到 `type: LoadBalancer` 改为 `type: NodePort`。
|
||||
或者，既然您已经玩得很溜了，**建议直接写一个 Ingress** 给它！
|
||||
**创建 `portainer-ingress.yaml`：**
|
||||
```yaml
|
||||
apiVersion: networking.k8s.io/v1
|
||||
kind: Ingress
|
||||
metadata:
|
||||
name: portainer-ingress
|
||||
namespace: portainer
|
||||
annotations:
|
||||
cert-manager.io/cluster-issuer: letsencrypt-prod
|
||||
spec:
|
||||
tls:
|
||||
- hosts:
|
||||
- portainer.u9.net3w.com # <--- 换个新子域名
|
||||
secretName: portainer-tls
|
||||
rules:
|
||||
- host: portainer.u9.net3w.com
|
||||
http:
|
||||
paths:
|
||||
- path: /
|
||||
pathType: Prefix
|
||||
backend:
|
||||
service:
|
||||
name: portainer
|
||||
port:
|
||||
number: 9000
|
||||
|
||||
```
|
||||
|
||||
|
||||
3. **应用并访问**：
|
||||
`kubectl apply -f portainer-ingress.yaml`。
|
||||
稍等片刻，访问 `https://portainer.u9.net3w.com`，设置管理员密码即可。
|
||||
|
||||
---
|
||||
|
||||
### 方案三：官方全家桶 —— Rancher (企业级)
|
||||
|
||||
K3s 是 Rancher Labs 开发的，Rancher 是他们的旗舰管理平台。
|
||||
|
||||
**优点：** 功能最全，企业级标准，可以管理成百上千个集群。
|
||||
**缺点：** **非常吃内存**。Rancher 本身启动就需要占用 2G+ 内存。如果您的 VPS 只有 4G 或更少，**强烈不推荐**，它会把您的业务挤垮。
|
||||
|
||||
---
|
||||
|
||||
### 💡 极客的选择：K9s (终端里的 GUI)
|
||||
|
||||
如果您还是离不开终端，但想要图形化的便利，**K9s** 是必备神器。它是一个运行在终端里的图形界面。
|
||||
|
||||
**安装：**
|
||||
|
||||
```bash
|
||||
# 在 VPS 上安装 Linuxbrew 后安装，或者直接下载二进制文件
|
||||
curl -sS https://webinstall.dev/k9s | bash
|
||||
|
||||
```
|
||||
|
||||
**启动：**
|
||||
输入 `k9s`。
|
||||
|
||||
您可以像打游戏一样：
|
||||
|
||||
* 按 `0` 显示所有 Pod。
|
||||
* 按 `l` 看日志。
|
||||
* 按 `s` 进入 Shell。
|
||||
* 按 `ctrl-d` 删除 Pod。
|
||||
* 全键盘操作，酷炫到没朋友。
|
||||
|
||||
---
|
||||
|
||||
### 我的建议
|
||||
|
||||
1. **首选方案**：先在本地安装 **OpenLens**。不用在 VPS 上装任何东西，无负担，体验最好。
|
||||
2. **次选方案**：如果经常需要在不同电脑上管理，在 VPS 上部署一个 **Portainer**。
|
||||
|
||||
**您想先试试哪一个？如果是 OpenLens，我可以教您怎么把 VPS 的 6443 端口安全地放行。**
|
||||
98
k3s/tool/rancher/note.md
Normal file
98
k3s/tool/rancher/note.md
Normal file
@@ -0,0 +1,98 @@
|
||||
**有眼光！** 既然您的 VPS 配置不错（之前提到有 16GB 内存），跑 Rancher 是**绝对最爽**的选择。它就像给您的 Kubernetes 集群装了一个“Windows 操作系统”，所有操作都能点点鼠标完成。
|
||||
|
||||
虽然您喜欢用 YAML 硬编码（这很好），但在安装 Rancher 这种巨型软件时，**Helm**（Kubernetes 的包管理器，类似于 Python 的 pip 或 Linux 的 apt）是唯一标准且靠谱的途径。手动写 YAML 安装 Rancher 会涉及到几百个文件，极易出错。
|
||||
|
||||
请按照以下步骤，把这头“牛”（Rancher 的 Logo）牵进您的集群。
|
||||
|
||||
---
|
||||
|
||||
### 🚀 第一步：安装 Helm (如果您还没有)
|
||||
|
||||
Helm 是安装 Rancher 的必备工具。在 Node 1 上执行：
|
||||
|
||||
```bash
|
||||
curl https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash
|
||||
|
||||
```
|
||||
|
||||
### 第二步：添加 Rancher 仓库
|
||||
|
||||
告诉 Helm 去哪里下载 Rancher。
|
||||
|
||||
```bash
|
||||
# 1. 添加仓库
|
||||
helm repo add rancher-latest https://releases.rancher.com/server-charts/latest
|
||||
|
||||
# 2. 创建 Rancher 专属的命名空间
|
||||
kubectl create namespace cattle-system
|
||||
|
||||
```
|
||||
|
||||
### 第三步：一键安装 Rancher (关键)
|
||||
|
||||
我们要安装 Rancher，并让它**自动利用**您集群里已经存在的 `cert-manager` 来申请 `rancher.u9.net3w.com` 的 HTTPS 证书。
|
||||
|
||||
请**直接复制**下面这整段命令（我已经帮您把参数配好了）：
|
||||
|
||||
* **域名**: `rancher.u9.net3w.com`
|
||||
* **初始密码**: `admin123456` (进去后强制要求改)
|
||||
* **副本数**: `1` (为了节省资源，生产环境通常用 3，但 1 个也够用)
|
||||
* **证书**: 使用 Let's Encrypt 自动生成
|
||||
|
||||
```bash
|
||||
helm install rancher rancher-latest/rancher \
|
||||
--namespace cattle-system \
|
||||
--set hostname=rancher.u9.net3w.com \
|
||||
--set bootstrapPassword=admin123456 \
|
||||
--set replicas=1 \
|
||||
--set ingress.tls.source=letsEncrypt \
|
||||
--set letsEncrypt.email=admin@net3w.com \
|
||||
--set letsEncrypt.ingress.class=traefik
|
||||
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 第四步：等待“巨兽”苏醒
|
||||
|
||||
Rancher 是一个庞大的 Java/Go 应用，启动需要一点时间（通常 2-5 分钟）。
|
||||
|
||||
您可以像看电影一样监控它的启动过程：
|
||||
|
||||
```bash
|
||||
watch kubectl get pods -n cattle-system
|
||||
|
||||
```
|
||||
|
||||
* **阶段 1**: 您会看到 `rancher-webhook` 先启动。
|
||||
* **阶段 2**: 接着 `rancher-xxxx` 主 Pod 开始 `ContainerCreating`。
|
||||
* **阶段 3**: 当 `rancher-xxxx` 状态变为 **`Running`** 且 **`READY 1/1`** 时，说明启动成功。
|
||||
|
||||
*(如果 Ready 很久都是 0/1，不要急，那是它在做数据库初始化，只要不报错 CrashLoopBackOff 就等着)*
|
||||
|
||||
---
|
||||
|
||||
### 第五步：登录并接管一切
|
||||
|
||||
一旦 Pod 跑起来，证书也签发好（Ingress 生效）后：
|
||||
|
||||
1. 打开浏览器访问：**[https://rancher.u9.net3w.com](https://www.google.com/search?q=https://rancher.u9.net3w.com)**
|
||||
2. **密码**：输入刚才设置的 `admin123456`。
|
||||
3. **接管**：
|
||||
* 登录后，它会提示您设置一个新的复杂密码。
|
||||
* 然后您会看到一个名为 **"local"** 的集群 —— **这就是您的 K3s 集群！**
|
||||
|
||||
|
||||
|
||||
---
|
||||
|
||||
### 🎉 您现在可以用图形界面做什么？
|
||||
|
||||
进入 "local" 集群后，您可以尝试以下操作，体验一下为什么我说它是“神器”：
|
||||
|
||||
1. **看工作负载**：点击左侧菜单 **Workload (工作负载)**，您会看到之前的 `my-python-app`, `registry`, `wordpress` 全都在列表里，CPU/内存占用一目了然。
|
||||
2. **查看日志**：点进 `my-python-app` -> 点击 Pod 名字 -> 右上角三个点 -> **View Logs**。界面非常舒服，支持实时滚动。
|
||||
3. **进入终端**：同上，点击 **Execute Shell**，直接在浏览器里获得一个 root 终端，再也不用 SSH 连来连去了。
|
||||
4. **拖拽扩容**：找到 Deployment，点一下 `+` 号，瞬间从 1 个 Pod 变成 5 个 Pod，感受 Kubernetes 的弹性。
|
||||
|
||||
**快去试试吧！如果安装过程中卡在 Pulling Image 或者 Pending，请告诉我 `kubectl get pods -n cattle-system` 的截图。**
|
||||
Reference in New Issue
Block a user