Knative GithubSource Webhook测试报错：svc.cluster.local解析失败求助

问题背景 #

我在测试Knative GitHubSource的Webhook功能时，遇到了DNS解析错误，相关操作和日志信息如下：

查看Pod状态 #

$ kubectl get pod
NAME READY STATUS RESTARTS AGE
githubsourcesample-gltcb-sxz5m-deployment-cd6bd45f7-zpdzl 1/2 Running 0 3s

用户容器日志输出 #

$ kubectl logs githubsourcesample-gltcb-sxz5m-deployment-cd6bd45f7-zpdzl user-container
2020/01/19 13:02:50 Sink is: "http://github-message-dumper.default.svc.cluster.local", OwnerRepo is: "GRuuuuu/knative-github-source-test"
2020/01/19 13:02:52 Handling push
2020/01/19 13:02:52 unexpected error handling GitHub event: Post http://github-message-dumper.default.svc.cluster.local: dial tcp: lookup github-message-dumper.default.svc.cluster.local on 10.96.0.10:53: no such host

我已经修改了Knative Serving的外部域名配置：

$ kubectl edit cm config-domain --namespace knative-serving

修改后KSVC的外部URL显示正常：

$ kubectl get ksvc
NAME URL LATESTCREATED LATESTREADY READY REASON
github-message-dumper http://github-message-dumper.default.mydomain.com github-message-dumper-4zpjk github-message-dumper-4zpjk True
githubsourcesample-gltcb http://githubsourcesample-gltcb.default.mydomain.com githubsourcesample-gltcb-sxz5m githubsourcesample-gltcb-sxz5m True

我的疑问：

1. 这个报错的原因是什么？有没有办法修复svc.cluster.local的IP解析问题？
2. 我有自己的公网域名，能不能把svc.cluster.local替换成我的域名？

问题解答 #

1. 报错原因与svc.cluster.local解析修复方案 #

这个错误的核心是GitHubSource的用户容器无法在集群内部解析目标Sink的ClusterIP Service域名，常见的触发原因有这几个：

• 你的github-message-dumper Knative Service（KSVC）对应的ClusterIP Service没有正确创建，或者处于未就绪状态
• 集群的CoreDNS组件出现异常，导致内部DNS解析失效
• GitHubSource的Sink配置写错了Service名称或命名空间

你可以按以下步骤排查修复：

• 第一步：检查目标KSVC对应的ClusterIP Service是否存在
  执行命令查看default命名空间下的Service：

  kubectl get svc -n default | grep github-message-dumper
  

  如果没有任何输出，说明KSVC没有正确生成对应的Service，需要查看KSVC的事件日志找问题：

  kubectl describe ksvc github-message-dumper -n default
  

• 第二步：检查CoreDNS运行状态
  如果Service存在但还是解析失败，大概率是集群内部DNS出问题了，检查CoreDNS的Pod状态和日志：

  kubectl get pods -n kube-system -l k8s-app=kube-dns
  kubectl logs -n kube-system -l k8s-app=kube-dns
  

  确保CoreDNS Pod都处于Running状态，且日志里没有明显的解析错误提示
• 第三步：验证GitHubSource的Sink配置正确性
  查看GitHubSource的配置，确认Sink指向的地址是否正确：

  kubectl describe githubsource githubsourcesample-gltcb -n default
  

  重点看Spec.Sink字段，确认Service名称和命名空间没有写错

2. 替换svc.cluster.local为公网域名的可行性 #

完全可以！不过你需要注意几个关键细节：

• Knative Source组件（比如GitHubSource）默认会自动使用KSVC的内部ClusterIP地址（也就是svc.cluster.local域名）作为Sink地址，如果你想用外部公网域名，需要显式配置Sink为KSVC的外部URL，不能依赖自动发现的内部地址
• 具体配置步骤：
  编辑你的GitHubSource资源：

  kubectl edit githubsource githubsourcesample-gltcb -n default
  

  在spec部分添加或修改sink字段，指定你的公网域名地址：

  spec:
    sink:
      uri: "http://github-message-dumper.default.mydomain.com"
  

  保存修改后，GitHubSource的Deployment会自动重建Pod，新Pod的日志里应该会显示Sink地址已经变成你的公网域名
• 额外注意：确保集群内部能够访问这个公网域名（比如配置了内部DNS映射，或者集群网络允许出站访问公网），否则依然会出现访问失败的问题

如果你希望所有Knative Source默认使用外部域名，也可以去调整Knative Eventing的全局配置，但针对单个Source显式配置Sink URI是更灵活、更易维护的方式。

内容的提问来源于stack exchange，提问作者GRu. L