从零搭建Kubernetes集群,顺便把Node.js和TypeScript也讲透了

说实话,很多朋友一听到"Kubernetes集群搭建"就头大。您是不是也遇到过这种情况?网上教程一大堆,照着敲命令,结果卡在某个报错上三天都过不去。更别提还要在这个集群上跑Node.js项目,用TypeScript写业务代码了。坦白讲,这事儿没那么玄乎,今天我们就把它聊透。

我做了这么多年一物一码和防伪溯源系统,后端服务基本都跑在K8s集群上。刚开始也踩了不少坑,后来发现,只要把几个关键点搞明白,剩下的就是熟练工的事儿。这篇文章,我就带您走一遍实战流程,顺便把Node.js教程和TypeScript类型系统教程里最容易迷糊的地方也串起来讲。

先搞明白:我们到底在搭什么

很多教程一上来就让你装kubeadm、kubelet、kubectl,但没告诉你这些东西是干嘛的。其实您可以这样理解:Kubernetes就像一个码头调度中心,Pod是集装箱,Node是货轮,而kubeadm就是帮您把码头建起来的施工队。

就拿我们做防伪溯源来说,一个扫码请求进来,背后可能涉及生成唯一码、校验真伪、记录流转信息好几个服务。这些服务如果全塞在一台机器上,一个挂了全完蛋。K8s的作用就是让它们各自住在自己的Pod里,互相不干扰,还能自动扩缩容。

  • Master节点:整个集群的大脑,负责调度和决策
  • Worker节点:干活的,您的Node.js服务就跑在这里
  • Pod:最小的调度单位,一个Pod里可以跑一个或多个容器
  • Service:给Pod提供一个稳定的访问入口,不然Pod重启IP就变了

您看,其实没那么复杂。关键是动手搭一遍,比看十篇文章都管用。

搭建集群时最容易踩的三个坑

坑一:网络插件选不对,Pod之间通不了信

我们第一次搭集群的时候,Master和Worker都显示Ready了,但Pod就是互相ping不通。查了半天,发现是CNI插件没装对。Flannel、Calico、Cilium,选哪个?说实话,如果您只是内部测试,Flannel最简单,一行命令搞定。但要是生产环境,尤其是我们做防伪溯源这种对网络策略有要求的,Calico更合适。

比如说,您希望扫码服务和数据库服务之间只能走特定端口,Calico的网络策略就能帮您实现。Flannel在这方面就弱一些。

坑二:Node.js服务打包成镜像后跑不起来

这个问题太常见了!本地用TypeScript写得好好的,ts-node一跑没问题。一打包成Docker镜像,放到K8s里就报错。为什么?多半是TypeScript编译配置的问题。

TypeScript类型系统教程里经常讲类型体操,但很少提编译输出。您得确保tsconfig.json里的outDir和rootDir设置正确,不然编译出来的js文件路径全是乱的。还有,Node.js版本要和基础镜像匹配。我们吃过亏,本地Node 18,镜像里用了Node 14,有些ES2022的特性直接不支持。

  • 检查tsconfig.json的target和module设置
  • 确保Dockerfile里先跑tsc再启动node
  • 用多阶段构建减小镜像体积

坑三:Service暴露方式选错,外部访问不了

Pod跑起来了,Service也建了,但从外面就是访问不了。您是不是也遇到过?NodePort、ClusterIP、LoadBalancer、Ingress,到底用哪个?

坦白讲,内部服务通信用ClusterIP就够了。要给外部访问,测试环境用NodePort最省事,生产环境建议上Ingress。我们做一物一码平台的时候,扫码请求量很大,用Ingress加Nginx Ingress Controller,既能做负载均衡,又能配SSL证书,一举两得。

把Node.js和TypeScript项目真正跑起来

集群搭好了,接下来就是部署我们的Node.js服务。这里我拿一个防伪码生成服务举例。

先用TypeScript写好业务逻辑,定义好接口类型。比如说,一个防伪码对象包含code、productId、createdAt、status这几个字段。TypeScript的类型系统能帮您在编译阶段就发现字段拼写错误,这比运行时才发现问题强太多了。

然后写Dockerfile,用多阶段构建。第一阶段装依赖、编译TypeScript,第二阶段只拷贝编译后的js文件和生产依赖。这样打出来的镜像可能只有几十MB,比直接塞个node_modules进去小多了。

接着写Deployment和Service的YAML文件。Deployment里指定副本数为3,这样即使一个Pod挂了,另外两个还能继续服务。Service用ClusterIP,前面再挂一个Ingress。

最后kubectl apply一下,看看Pod状态。kubectl get pods -w这个命令您一定要会用,-w参数能实时监控Pod状态变化,排查问题特别方便。

  • 用ConfigMap管理环境变量,别硬编码在代码里
  • 用Secret存数据库密码等敏感信息
  • 配置livenessProbe和readinessProbe,让K8s知道您的服务是否健康

我们那个防伪码服务上线后,QPS从原来的500提升到了2000多,而且再也没出现过单点故障导致的全站不可用。这就是K8s带来的实实在在的好处。

总结一下,下一步该做什么

Kubernetes集群搭建没那么可怕,关键是动手。您先搭一个单Master的测试集群,把Node.js服务跑起来,感受一下Pod自动重启、滚动更新的便利。然后再逐步加上监控、日志、CI/CD这些周边设施。

TypeScript类型系统教程看再多,不如自己写一个带完整类型定义的项目。Node.js教程也是,光看Event Loop原理没用,得真正部署到K8s里跑起来,才能理解什么叫"生产环境"。

如果您也想把一物一码或防伪溯源系统跑在K8s上,或者正在为Node.js项目的类型安全头疼,不妨从今天开始,照着这个思路搭一遍。遇到问题别慌,多半是网络插件或者镜像打包的坑,一个一个排查就是了。动手吧,搭完您会发现,这事儿真没想象中那么难!