当前位置： 首页 > news >正文

基于k3s部署Nginx、MySQL、Golang和Redis的详细教程

news 来源：原创 2025/4/30 4:19:45

1. 安装k3s集群

1.1 安装k3s（单节点快速体验）
# 使用root用户或sudo执行
curl -sfL https://get.k3s.io | sh -

# 验证安装
sudo kubectl get nodes  # 应显示一个节点状态为Ready
sudo systemctl status k3s
1.2 设置kubectl快捷方式（可选）
mkdir -p ~/.kube
sudo cp /etc/rancher/k3s/k3s.yaml ~/.kube/config
sudo chown $USER ~/.kube/config
export KUBECONFIG=~/.kube/config

2. 部署MySQL数据库

2.1 创建持久化存储卷（PVC）
# mysql-pvc.yaml
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: mysql-pvc
spec:
  accessModes:
    - ReadWriteOnce
  resources:
    requests:
      storage: 2Gi  # 生产环境建议5Gi以上

kubectl apply -f mysql-pvc.yaml
2.2 创建数据库密码Secret
kubectl create secret generic mysql-secret \
  --from-literal=root_password=your_secure_password \
  --from-literal=database=appdb
2.3 部署MySQL
# mysql-deployment.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: mysql-deployment
spec:
  replicas: 1
  selector:
    matchLabels:
      app: mysql
  template:
    metadata:
      labels:
        app: mysql
    spec:
      containers:
        - name: mysql
          image: mysql:8.0
          env:
            - name: MYSQL_ROOT_PASSWORD
              valueFrom:
                secretKeyRef:
                  name: mysql-secret
                  key: root_password
            - name: MYSQL_DATABASE
              valueFrom:
                secretKeyRef:
                  name: mysql-secret
                  key: database
          ports:
            - containerPort: 3306
          volumeMounts:
            - mountPath: /var/lib/mysql
              name: mysql-data
      volumes:
        - name: mysql-data
          persistentVolumeClaim:
            claimName: mysql-pvc
---
apiVersion: v1
kind: Service
metadata:
  name: mysql-service
spec:
  selector:
    app: mysql
  ports:
    - port: 3306
      targetPort: 3306
  type: ClusterIP

kubectl apply -f mysql-deployment.yaml

3. 部署Redis缓存

3.1 创建Redis持久化存储
# redis-pvc.yaml
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: redis-pvc
spec:
  accessModes:
    - ReadWriteOnce
  resources:
    requests:
      storage: 1Gi

kubectl apply -f redis-pvc.yaml
3.2 部署Redis
# redis-deployment.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: redis-deployment
spec:
  replicas: 1
  selector:
    matchLabels:
      app: redis
  template:
    metadata:
      labels:
        app: redis
    spec:
      containers:
        - name: redis
          image: redis:alpine
          ports:
            - containerPort: 6379
          volumeMounts:
            - mountPath: /data
              name: redis-data
          command: ["redis-server", "--appendonly yes"]  # 启用持久化
      volumes:
        - name: redis-data
          persistentVolumeClaim:
            claimName: redis-pvc
---
apiVersion: v1
kind: Service
metadata:
  name: redis-service
spec:
  selector:
    app: redis
  ports:
    - port: 6379
      targetPort: 6379
  type: ClusterIP

kubectl apply -f redis-deployment.yaml

4. 部署Golang应用

4.1 准备Golang Docker镜像

  1. 创建示例Golang应用 main.go：

    package main

import (
    "fmt"
    "net/http"
    "database/sql"
    _ "github.com/go-sql-driver/mysql"
    "github.com/redis/go-redis/v9"
)

func handler(w http.ResponseWriter, r *http.Request) {
    // 连接MySQL
    db, _ := sql.Open("mysql", "root:${MYSQL_ROOT_PASSWORD}@tcp(mysql-service:3306)/${MYSQL_DATABASE}")
    defer db.Close()
    
    // 连接Redis
    rdb := redis.NewClient(&redis.Options{Addr: "redis-service:6379"})
    defer rdb.Close()
    
    fmt.Fprintf(w, "Connected to MySQL and Redis!")
}

func main() {
    http.HandleFunc("/", handler)
    http.ListenAndServe(":8080", nil)
}

  2. 创建 Dockerfile：

    FROM golang:1.20-alpine AS builder
WORKDIR /app
COPY . .
RUN go mod init app && go mod tidy
RUN CGO_ENABLED=0 GOOS=linux go build -o /app/main

FROM alpine:latest
COPY --from=builder /app/main /app/main
EXPOSE 8080
CMD ["/app/main"]

  3. 构建并推送镜像到仓库（或本地构建）：

    docker build -t yourusername/golang-app:v1 .
docker push yourusername/golang-app:v1
4.2 部署Golang应用到k3s
# golang-deployment.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: golang-deployment
spec:
  replicas: 2
  selector:
    matchLabels:
      app: golang
  template:
    metadata:
      labels:
        app: golang
    spec:
      containers:
        - name: golang
          image: yourusername/golang-app:v1  # 替换为你的镜像
          ports:
            - containerPort: 8080
          env:
            - name: MYSQL_ROOT_PASSWORD  # 从Secret注入
              valueFrom:
                secretKeyRef:
                  name: mysql-secret
                  key: root_password
            - name: MYSQL_DATABASE
              valueFrom:
                secretKeyRef:
                  name: mysql-secret
                  key: database
          livenessProbe:  # 健康检查
            httpGet:
              path: /
              port: 8080
            initialDelaySeconds: 10
            periodSeconds: 5
---
apiVersion: v1
kind: Service
metadata:
  name: golang-service
spec:
  selector:
    app: golang
  ports:
    - port: 8080
      targetPort: 8080
  type: ClusterIP

kubectl apply -f golang-deployment.yaml

5. 部署Nginx反向代理

5.1 创建Nginx配置文件
# nginx-config.yaml
apiVersion: v1
kind: ConfigMap
metadata:
  name: nginx-config
data:
  default.conf: |
    server {
        listen 80;
        server_name localhost;

        location / {
            proxy_pass http://golang-service:8080;  # 转发到Golang服务
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
        }
    }

kubectl apply -f nginx-config.yaml
5.2 部署Nginx
# nginx-deployment.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx-deployment
spec:
  replicas: 2
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
        - name: nginx
          image: nginx:alpine
          ports:
            - containerPort: 80
          volumeMounts:
            - mountPath: /etc/nginx/conf.d
              name: nginx-config
      volumes:
        - name: nginx-config
          configMap:
            name: nginx-config
---
apiVersion: v1
kind: Service
metadata:
  name: nginx-service
spec:
  selector:
    app: nginx
  ports:
    - port: 80
      targetPort: 80
  type: NodePort  # 或LoadBalancer

kubectl apply -f nginx-deployment.yaml

6. 验证部署

6.1 查看所有资源状态
kubectl get pods,svc,pvc
  • 确保所有Pod状态为 Running，服务正常启动。
6.2 访问应用
# 获取Nginx的NodePort
kubectl get svc nginx-service -o jsonpath='{.spec.ports[0].nodePort}'

# 访问应用（假设节点IP为192.168.1.100，NodePort为30007）
curl http://192.168.1.100:30007
  • 预期输出：Connected to MySQL and Redis!

7. 扩展与维护

7.1 扩容Golang副本
kubectl scale deployment golang-deployment --replicas=3
7.2 更新Golang应用

  1. 修改代码后重新构建镜像：

    docker build -t yourusername/golang-app:v2 .
docker push yourusername/golang-app:v2

  2. 更新Deployment镜像版本：

    kubectl set image deployment/golang-deployment golang=yourusername/golang-app:v2

8. 关键配置说明

组件核心配置项作用说明
MySQLpersistentVolumeClaim数据持久化到PVC
Rediscommand: ["redis-server", "--appendonly yes"]启用AOF持久化
GolanglivenessProbe自动重启不健康的Pod
Nginxproxy_pass http://golang-service反向代理到后端服务

附：常见问题排查

  1. Golang无法连接MySQL/Redis

    • 检查服务名称是否正确（mysql-service、redis-service）
    • 验证Secret中的密码是否匹配
    kubectl exec -it <golang-pod> -- env | grep MYSQL_ROOT_PASSWORD

  2. Nginx返回502错误

    • 检查Golang服务是否正常运行：

      kubectl logs <golang-pod>

  3. 持久化存储未生效

    • 确认PVC状态是否为 Bound：

      kubectl get pvc

相关文章：

  • 文件解析漏洞
  • 协程池是调用端并发请求的缓释胶囊
  • 每日定投40刀BTC（9）20250312 - 20250315
  • 剑指 Offer II 078. 合并排序链表
  • 一对一交友App源码开发新趋势：精准匹配与多元盈利模式解析
  • 微服务即时通信系统---（八）用户管理子服务
  • 目标检测任务，如何区分两个相近似的目标
  • 3.17日Man2Marine
  • 卓越的用户体验需要智能内容
  • 【css酷炫效果】纯CSS实现气泡上升动画
  • C语言及内核开发中的回调机制与设计模式分析
  • 【NLP】 12. 解决不同长度文本问题，RNN, LSTM，双重RNN，双向递归神经网络
  • 【css酷炫效果】纯CSS实现立体纸张折叠动效
  • 《AI大模型趣味实战》 No3：快速搭建一个漂亮的AI家庭网站-相册/时间线/日历/多用户/个性化配色/博客/聊天室/AI管家(下)
  • Redis 持久化机制：AOF 与 RDB 详解
  • Django 集成 Redis 数据库指南
  • Kafka跨集群数据备份与同步：MirrorMaker运用
  • C语言经典代码题
  • 启动、关闭集群
  • 算法及数据结构系列 - 二分查找
  • 制定出台民营经济促进法有何重大意义？全国人大常委会法工委回应
  • 启程回家！神十九轨道舱与返回舱成功分离
  • 李铁案二审今日宣判
  • 神舟十九号载人飞船因东风着陆场气象原因推迟返回
  • 一季度我国服务进出口总额19741.8亿元，同比增长8.7%
  • BNEF：亚洲、中东和非洲是电力基础设施投资的最大机会所在