Go项目集成K8S常见问题

本文记录在将 Go 项目部署到 Kubernetes(K8S)集群时遇到的两类典型问题:如何编写 K8S 部署与访问配置文件,以及 Go 项目在容器中连接本地 MySQL/Redis 失败的排查与解决。

核心思路是:**通过 Deployment 定义应用负载、用 Service 暴露访问入口,并在容器内改用宿主机真实 IP 访问本机数据库,避免容器网络隔离导致的连接失败**。

传统方式下直接在 localhost 连接数据库的做法在 K8S 容器中会失效,因为容器拥有独立网络命名空间;本文给出用 NodePort Service 暴露服务、用本机 IP 打通本地数据库的可落地方案。

K8S / Go 集成指南

1. 概述

将 Go 项目集成到 Kubernetes 时,通常面临两个层面的工作:

  • 资源编排:编写 Deployment(定义应用副本与容器)与 Service(定义集群内外访问方式)。
  • 网络连通:容器内的 Go 应用需要访问宿主机上的 MySQL、Redis 等本地服务,不能直接使用 localhost。

下文先给出标准的 K8S 配置文件,再针对“容器无法连接本地 MySQL”这一痛点给出完整排查步骤。

2. K8S 部署配置文件

部署一个 Go 应用一般需要两份清单:一份 Deployment 描述应用本身,一份 Service 负责暴露端口。

2.1 Deployment 配置

定义名为 go-app-deployment 的部署,运行单副本、监听容器端口 8081:

apiVersion: apps/v1
kind: Deployment
metadata:
  name: go-app-deployment
spec:
  replicas: 1
  selector:
    matchLabels:
      app: go-app
  template:
    metadata:
      labels:
        app: go-app
    spec:
      containers:
        - name: go-app
          image: go-app:v1
          ports:
            - containerPort: 8081

2.2 Service 配置

使用 NodePort 类型将服务暴露到集群节点端口 30081,外部可通过 节点IP:30081 访问:

---
apiVersion: v1
kind: Service
metadata:
  name: go-app-service
spec:
  type: NodePort
  selector:
    app: go-app
  ports:
    - port: 8081
      targetPort: 8081
      nodePort: 30081
配置项 说明
kind: Deployment 声明无状态应用部署,管理 Pod 副本
kind: Service 为一组 Pod 提供稳定的访问入口
type: NodePort 在每个节点上开放固定端口供外部访问
nodePort: 30081 节点层面暴露的静态端口
containerPort: 8081 容器内部监听的应用端口

3. Go 项目连接本地 MySQL 问题

当 Go 项目运行在 K8S 容器中、但依赖本机(宿主机)的 MySQL 与 Redis 时,直接使用 localhost 或 127.0.0.1 无法连通,因为容器拥有独立的网络栈。解决思路是改用宿主机的真实局域网 IP。

3.1 获取本机 IP

先在宿主机上获取本机对局域网暴露的 IP 地址(下文以 192.168.0.194 为例):

本地的ip

3.2 修改项目配置文件

将配置中的数据库、Redis 地址改为宿主机的真实 IP,而非 127.0.0.1:

server:
  port: 0.0.0.0:8081
mysql:
  host: 192.168.0.194
  port: 3306
  database: study_room_management
  password: password
  username: root
redis:
  addr: 192.168.0.194:6379
  password:
  db: 0

192.168.0.194 需替换为你本地本机的真实 IP。

3.3 创建远程访问的 MySQL root 账号

本地 MySQL 默认只允许本机连接,需创建允许任意 IP 的 root@'%' 账号:

  1. 登录本地 MySQL:
mysql -u root -p
  1. 执行以下 SQL,创建允许所有 IP 连接的 root 账号并授权:
-- 创建用户 root@%
CREATE USER 'root'@'%' IDENTIFIED BY '你的密码';

-- 赋予所有权限
GRANT ALL PRIVILEGES ON *.* TO 'root'@'%' WITH GRANT OPTION;

-- 刷新权限生效
FLUSH PRIVILEGES;
**账号与权限说明** `root@'%'` 中的 `%` 代表任意 IP 都能连接;`*.*` 表示所有库、所有表的权限。

3.4 验证账号创建

查询用户表,确认出现 root | % 一行即表示配置成功:

SELECT user,host FROM mysql.user;

看到有一行 root | % 就成功了。

**排查要点** 若仍无法连接,请依次检查:宿主机防火墙是否放行 `3306`/`6379`、MySQL 是否监听在 `0.0.0.0`、以及 Go 配置中的 IP 是否为宿主机可达地址。

4. 总结

本文的两类问题均围绕“容器与本地资源如何互通”展开:用 Deployment + NodePort Service 完成 Go 应用的 K8S 编排,并通过将数据库地址改为宿主机真实 IP、开放 MySQL 远程账号,解决容器内访问本地 MySQL/Redis 的连接失败问题。


一句话总结:Go 项目上 K8S 时,用 Deployment 与 NodePort Service 完成编排,并把容器内数据库地址改为宿主机真实 IP 并开放远程账号,即可解决本地 MySQL/Redis 连接失败问题。