注:在阅读本篇文章之前,最好先阅读《Docker & Kubernetes 小抄》一文。
下载源码:
mkdir springboot-k8s && cd springboot-k8s
curl https://start.spring.io/starter.tgz -d dependencies=webflux,actuator | tar -xzvf -
# 以上命令为 MacOS 下测试通过,如果失败,则将其下载后自行解压。
# curl https://start.spring.io/starter.tgz -d dependencies=webflux,actuator -o starter.tgz
# tar -xzvf starter.gz
./mvnw install
java -jar target/*.jar
curl localhost:8080/actuator | jq .
注:jq .
的意思是格式化 JSON 的输出,需要单独安装,非常方便。也可以替换成 python -m json.tool
。
在当前目录下创建 Dockerfile:
FROM openjdk:8-jdk-alpine AS builder
WORKDIR target/dependency
ARG APPJAR=target/*.jar
COPY ${APPJAR} app.jar
RUN jar -xf ./app.jar
FROM openjdk:8-jre-alpine
VOLUME /tmp
ARG DEPENDENCY=target/dependency
COPY --from=builder ${DEPENDENCY}/BOOT-INF/lib /app/lib
COPY --from=builder ${DEPENDENCY}/META-INF /app/META-INF
COPY --from=builder ${DEPENDENCY}/BOOT-INF/classes /app
ENTRYPOINT ["java","-cp","app:app/lib/*","com.example.demo.DemoApplication"]
构建 Docker 镜像:
docker build -t springguides/demo .
-
-t springguides/demo
的意思是将构建好的镜像标记为 springguides/demo,可以通过docker images
查看。 -
.
的意思是当前目录为构建的上下文目录(Context)。
可以直接启动:
docker run -p 8080:8080 springguides/demo
然后我们可以通过以下命令测试:
curl localhost:8080/actuator/health
注:执行下面的命令前请先停止刚运行的 Docker 容器,使用 docker ps
查看当前运行的容器列表,执行 docker stop <CONTAINER ID>
即可。
将该 Docker 镜像部署到 Kubernetes:
kubectl create deployment demo --image=springguides/demo --dry-run -o=yaml > deployment.yaml
echo --- >> deployment.yaml
kubectl create service clusterip demo --tcp=8080:8080 --dry-run -o=yaml >> deployment.yaml
使用该文件创建资源:
kubectl apply -f deployment.yaml
查看当前 Kubernetes 集群内部的所有资源:
kubectl get all
最简单的从外部访问 Kubernetes 集群内部服务的方式为端口转发,这种方式通常只用于开发调试阶段:
kubectl port-forward svc/demo 8080:8080
然后测试服务是否正常运行:
curl localhost:8080/actuator/health
实际使用中通常会用 Ingress 方式从外部访问 Kubernetes 内部的服务,创建 ingress.yml:
apiVersion: extensions/v1beta1
kind: Ingress
metadata:
name: demo-ingress
spec:
rules:
- http:
paths:
- path: /
backend:
serviceName: demo
servicePort: 8080
使用该文件创建资源:
kubectl apply -f ingress.yml
这里使用 Kong for Kubernetes:
kubectl apply -f https://bit.ly/k4k8s
删除该文件内的资源:
kubectl delete -f ingress.yml
查看 Kong Ingress 入口地址(-n kong
是指查看 kong
命名空间下的资源):
kubectl get service -n kong
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE
kong-proxy LoadBalancer 10.96.192.16 localhost 80:31660/TCP,443:31110/TCP 56m
kong-validation-webhook ClusterIP 10.96.2.150 <none> 443/TCP 56m
这里我们访问 curl localhost/actuator/health
。
我们可以使用 kubectl
进行动态扩容,首先查看当前运行的实例数:
kubectl get all
NAME READY UP-TO-DATE AVAILABLE AGE
deployment.apps/demo 1/1 1 1 65m
扩容为 5 个实例:
kubectl scale deployment.apps/demo --replicas=5
kubectl get deployments
NAME READY UP-TO-DATE AVAILABLE AGE
demo 5/5 5 5 66m
缩容为 3 个实例:
kubectl scale deployment.apps/demo --replicas=3