跳到主要内容

kubernetes 在本地开发和调试服务

Kubernetes 应用程序通常由多个独立的服务组成，每个服务都在自己的容器中运行。 在远端的 Kubernetes 集群上开发和调试这些服务可能很麻烦 比如云原生微服务Istio、Spring Cloud等， 需要在运行的容器上打开 Shell， 以运行调试工具。

下面介绍两款开源工具

telepresence​

Telepresence 是一个云原生计算基金会沙盒项目，是 kubernetes 和 openshift 微服务的快速本地开发工具

安装​

# Intel Macs

# Install via brew:
brew install datawire/blackbird/telepresence

# OR install manually:
# 1. Download the latest binary (~60 MB):
sudo curl -fL https://app.getambassador.io/download/tel2/darwin/amd64/latest/telepresence -o /usr/local/bin/telepresence

# 2. Make the binary executable:
sudo chmod a+x /usr/local/bin/telepresence

# Apple silicon Macs

# Install via brew:
brew install datawire/blackbird/telepresence-arm64

# OR Install manually:
# 1. Download the latest binary (~60 MB):
sudo curl -fL https://app.getambassador.io/download/tel2/darwin/arm64/latest/telepresence -o /usr/local/bin/telepresence

# 2. Make the binary executable:
sudo chmod a+x /usr/local/bin/telepresence

常用命令​

连接集群​

telepresence connect

您现在可以访问远程 Kubernetes API 服务器，就好像您在同一个网络上一样。您现在可以使用任何本地工具连接到集群中的任何服务。

拦截服务列表​

telepresence list

拦截指定服务​

telepresence intercept <service-name> --port <local-port>[:<remote-port>] --env-file <path-to-env-file>
  • For --port: 指定服务的本地实例正在运行的端口。如果被拦截的服务暴露了多个端口，在冒号后指定要拦截的端口。
  • For --env-file: 指定 Telepresence 的文件路径以写入在 pod 中设置的环境变量。下面的示例显示 Telepresence 拦截前往 example-service 服务的流量。请求现在到达集群中端口 http 上的服务，被路由到工作站上的 8080，并将服务的环境变量写入 ~/example-service-intercept.env。
telepresence intercept example-service --port 8080:http --env-file ~/example-service-intercept.env

# Using Deployment example-service
# intercepted
# Intercept name: example-service
# State         : ACTIVE
# Workload kind : Deployment
# Destination   : 127.0.0.1:8080
# Intercepting  : all TCP connections

Telepresence 是如何工作的？​

Telepresence 会在远程集群中运行的现有应用程序容器旁边安装流量代理 sidecar。 当它捕获进入 Pod 的所有流量请求时，不是将其转发到远程集群中的应用程序， 而是路由所有流量（当创建全局拦截器时） 或流量的一个子集（当创建自定义拦截器时） 到本地开发环境。

Telepresence 官方网站​

Telepresence

参考网站​

kt-connect​

来自阿里 KtConnect（Kt为Kubernetes Toolkit集群工具包的简写）是一款基于Kubernetes环境用于提高本地测试联调效率的小工具。

安装​

软件包:

下载并安装KT（以x86 64位版本为例）

curl -OL https://github.com/alibaba/kt-connect/releases/download/v0.3.6-beta1/ktctl_0.3.6-beta1_MacOS_x86_64.tar.gz
tar zxf ktctl_0.3.6-beta1_MacOS_x86_64.tar.gz
mv ktctl /usr/local/bin/ktctl
ktctl --version

| 你也可以从Github Releases下载历史版本的软件包

常用命令​

连接集群​

$ sudo ktctl connect
00:00AM INF KtConnect start at <PID>
... ...
00:00AM INF ---------------------------------------------------------------
00:00AM INF  All looks good, now you can access to resources in the kubernetes cluster
00:00AM INF ---------------------------------------------------------------

现在本地已经能够直接访问集群资源了，可通过浏览器或curl命令来验证：

$ curl http://10.51.0.162:8080    # 在本地直接访问PodIP
kt-connect demo v1

$ curl http://172.21.6.39:8080    # 在本地访问ClusterIP
kt-connect demo v1

$ curl http://tomcat:8080         # 使用<service>作为域名访问服务
kt-connect demo v1

$ curl http://tomcat.default:8080     # 使用<servicename>.<namespace>域名访问服务
kt-connect demo v1

$ curl http://tomcat.default.svc.cluster.local:8080    # 使用集群内完整域名访问服务
kt-connect demo v1

将集群流量转发到本地​

KtConnect提供了三种能够让集群访问本地服务的命令，分别用于不同的调试场景。

  • Exchange：将集群指定服务的所有流量转向本地
  • Mesh：将集群指定服务的部分流量（按Header或Label规则）转向本地
  • Preview：在集群中创建一个新服务，并将其流量转向本地

将集群里访问指定服务的所有请求拦截并转发到本地的指定端口，通常用于调试在测试环境调用链上的指定服务。

┌──────────┐     ┌─ ── ── ──     ┌──────────┐
│ ServiceA ├─┬─►x│ ServiceB │ ┌─►│ ServiceC │
└──────────┘ │    ── ── ── ─┘ │  └──────────┘
         exchange             │
             │   ┌──────────┐ │
             └──►│ ServiceB'├─┘
                 └──────────┘

使用ktctl exchange命令将先前部署到集群中的tomcat服务流量全部转到本地8080端口：

$ ktctl exchange tomcat --expose 8080
00:00AM INF KtConnect start at <PID>
... ...
---------------------------------------------------------------
Now all request to service 'tomcat' will be redirected to local
---------------------------------------------------------------

在本地或者集群中访问示例开始时部署到集群的tomcat服务，查看输出结果：

注意如果未运行ktctl connect，只能从集群内访问

$ curl http://tomcat:8080
kt-connect local v2

可以看到，访问集群里tomcat服务的请求被路由到了本地的Tomcat实例，现在就可以直接在本地调试这个服务了。

官方网站​

KtConnect