K3s轻量Kubernetes¶

# 安装 K3s Server（控制平面+工作节点）
curl -sfL https://get.k3s.io | sh -

# 安装完成后：
# - K3s 以 systemd 服务运行
# - kubectl 自动可用
# - kubeconfig 文件位于 /etc/rancher/k3s/k3s.yaml

# 验证安装
sudo kubectl get nodes                 # 查看节点
sudo kubectl get pods -A               # 查看所有命名空间的 Pod

# === Server 节点（主节点）===
curl -sfL https://get.k3s.io | sh -

# 获取 Node Token（用于 Agent 加入集群）
sudo cat /var/lib/rancher/k3s/server/node-token

# === Agent 节点（工作节点）===
# 在其他服务器上运行：
curl -sfL https://get.k3s.io | K3S_URL=https://SERVER_IP:6443 K3S_TOKEN=YOUR_TOKEN sh -
# K3S_URL → Server 的地址
# K3S_TOKEN → 从 Server 获取的 Token

# 第一个 Server 节点
curl -sfL https://get.k3s.io | sh -s - server \
  --cluster-init                       # 启用嵌入式 etcd

# 第二、三个 Server 节点
curl -sfL https://get.k3s.io | K3S_TOKEN=TOKEN sh -s - server \
  --server https://FIRST_SERVER_IP:6443  # 加入已有集群

# 禁用不需要的组件以节省资源
curl -sfL https://get.k3s.io | sh -s - \
  --disable=traefik \                  # 不装 Traefik（自己选 Ingress）
  --disable=servicelb \                # 不装 ServiceLB
  --write-kubeconfig-mode=644          # kubeconfig 文件权限

# K3s 自带 kubectl，直接使用：
sudo k3s kubectl get nodes             # 查看节点
# 或设置别名：
echo 'alias kubectl="sudo k3s kubectl"' >> ~/.bashrc
source ~/.bashrc

# === 常用操作 ===
kubectl get pods                       # 查看 Pod
kubectl get svc                        # 查看 Service
kubectl get deployments                # 查看部署
kubectl logs POD_NAME                  # 查看日志
kubectl exec -it POD_NAME -- sh       # 进入 Pod
kubectl apply -f manifest.yaml        # 应用配置
kubectl delete -f manifest.yaml       # 删除资源

# app.yaml — 部署一个 Nginx 应用
apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx                          # 部署名
spec:
  replicas: 3                          # 3 个副本
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
        - name: nginx
          image: nginx:alpine          # 使用 Nginx 镜像
          ports:
            - containerPort: 80        # 容器端口
          resources:
            requests:
              memory: "64Mi"           # 最低内存
              cpu: "100m"              # 最低 CPU
            limits:
              memory: "128Mi"          # 最大内存
              cpu: "250m"              # 最大 CPU
---
apiVersion: v1
kind: Service
metadata:
  name: nginx-svc
spec:
  type: LoadBalancer                   # 暴露到外部
  ports:
    - port: 80                         # Service 端口
      targetPort: 80                   # 容器端口
  selector:
    app: nginx

kubectl apply -f app.yaml              # 部署
kubectl get pods -w                    # 监控 Pod 状态

# 在边缘环境中预拉取镜像：
# K3s 支持从 /var/lib/rancher/k3s/agent/images/ 加载本地镜像

# 方法1：导入 Docker 镜像
docker save myapp:v1 -o myapp.tar
sudo k3s ctr images import myapp.tar   # 导入到 containerd

# 方法2：配置私有镜像仓库
# /etc/rancher/k3s/registries.yaml
mirrors:
  "registry.example.com":
    endpoint:
      - "https://registry.example.com"
configs:
  "registry.example.com":
    auth:
      username: user
      password: pass

# 使用 system-upgrade-controller 自动升级 K3s
kubectl apply -f https://github.com/rancher/system-upgrade-controller/releases/latest/download/system-upgrade-controller.yaml

# 创建升级计划
kubectl apply -f - <<EOF
apiVersion: upgrade.cattle.io/v1
kind: Plan
metadata:
  name: k3s-server
  namespace: system-upgrade
spec:
  concurrency: 1
  nodeSelector:
    matchExpressions:
      - key: node-role.kubernetes.io/master
        operator: Exists
  upgrade:
    image: rancher/k3s-upgrade
  version: v1.34.6+k3s1
EOF

# K3s 内置 Helm Controller，直接用 HelmChart CRD：
kubectl apply -f - <<EOF
apiVersion: helm.cattle.io/v1
kind: HelmChart
metadata:
  name: grafana
  namespace: kube-system
spec:
  repo: https://grafana.github.io/helm-charts
  chart: grafana
  targetNamespace: monitoring
  valuesContent: |-
    adminPassword: admin123
    service:
      type: LoadBalancer
EOF

# === 安装/卸载 ===
curl -sfL https://get.k3s.io | sh -   # 安装
/usr/local/bin/k3s-uninstall.sh        # 卸载 Server
/usr/local/bin/k3s-agent-uninstall.sh  # 卸载 Agent

# === 服务管理 ===
sudo systemctl status k3s             # 查看状态
sudo systemctl restart k3s            # 重启
sudo journalctl -u k3s -f             # 查看日志

# === 关键路径 ===
/etc/rancher/k3s/k3s.yaml             # kubeconfig
/var/lib/rancher/k3s/                  # 数据目录
/etc/rancher/k3s/registries.yaml      # 镜像仓库配置

# === 资源需求 ===
# 最低：512MB RAM（轻负载）
# 推荐：2GB RAM + 2 vCPU