JetBrains Rider调试Docker Compose部署后报名称或服务未知异常

• 运行环境：Mac OS Catalina 10.15.7，JetBrains Rider 2020.3.4（Build #RD-203.7717.10，2021年3月17日构建）
• 故障现象：调试Docker Compose编排的多服务应用栈时，服务部署完成后抛出Name or service not known异常
• 对照验证：同套配置在Visual Studio for Mac中可正常启动调试，但运行速度很慢
• 已完成的排查操作：
  • 使用Rider重新生成docker-compose编排文件
  • 补充添加调试专属的override配置文件
  • 以上操作均未解决问题
• 想确认的点：这套配置能不能在Rider里正常调试，以及怎么消除这个服务名解析报错

这套配置完全可以在Rider中正常调试，Name or service not known的本质是容器间DNS解析失败，结合Rider 2020.3.x的已知特性，按以下顺序调整即可解决：

• 调整Rider Docker Compose调试的服务选中范围
  Rider 2020.3.4默认启动调试时，仅会把用户勾选的单个服务纳入调试网络域，其余编排里的服务虽会被启动，但不在同一网络命名空间下，导致api容器无法解析postgres、redis、apm-server等依赖服务的名称。
  操作：打开Rider的Docker Compose运行配置，在服务选择列表里，把api以及它依赖的postgres、redis、apm-server、Kafka相关服务、Elastic相关服务全部勾选为调试启动时需要加载的服务，不要仅勾选api单个服务。
• 关闭调试网络隔离开关
  Rider 2020.x版本默认开启Isolate debug services选项，该功能会为被调试的.Net服务创建独立的隔离网络，和其他非.Net服务完全断开网络连通性，这也是Rider和VS for Mac的行为核心差异。
  操作：打开Rider设置面板，进入Build, Execution, Deployment | Docker | Docker Compose分类，关闭Isolate debug services选项，保存设置后重启Rider。
• 统一修正compose文件的缩进
  提供的compose配置里，Kafka相关的4个服务块存在缩进偏移：cp-zookeeper、cp-broker、cp-schema-registry、connect-file-pulse的配置缩进和前面的服务不对齐，会导致Rider内置的compose解析器错误识别服务边界，把部分服务判定为独立栈的服务，不加入默认网络。
  操作：统一所有顶级服务的缩进为2空格，和elasticsearch、kibana等服务的缩进保持一致，消除解析歧义。
• 补全跨服务的hostname配置
  Compose默认的DNS解析规则是优先匹配容器的hostname，当未显式配置hostname时，Rider的解析逻辑不会自动把服务名写入容器的DNS解析记录。
  操作：为所有需要被其他服务访问的组件，在配置块中添加和服务名完全一致的hostname字段，比如为elasticsearch、kibana、apm-server、redis、postgres添加对应同名的hostname配置，示例：

  elasticsearch:
    image: docker.elastic.co/elasticsearch/elasticsearch:7.10.1
    hostname: elasticsearch
  

完成调整后，先在终端执行docker-compose config命令校验配置文件无解析错误，再手动执行docker-compose up验证所有服务可通过服务名互相连通，之后再回到Rider启动调试流程即可。调整后Rider的调试启动速度会远快于Visual Studio for Mac的运行表现。

内容的提问来源于stack exchange，提问作者Mehmet Utku Kul