小编推荐

客户需要搭建苍穹开发环境，但服务器与客户端不在同一个网络，且客户对网络安全要求较高，不允许直接访问服务器，存在内外部端口不一致的情况。对此，开发环境的搭建需要特殊处理，否则无法远程通过服务器的组件搭建开发环境。

本期实践案例提供了相应的解决方案，教你如何在内外网IP端口不一致的情况下，搭建苍穹开发环境，一起学起来~

案例撰稿人：杨鹏。

业务背景

客户需要搭建苍穹开发环境，在项目交付中发现，客户服务器与客户端不在同一个网络，此时客户一般通过转发把我们需要的端口暴露出来，如果转发出来的端口和内部端口一致，往往我们只需要设置解析即可。

但客户对网络安全要求较高，不允许直接访问服务器，存在内外部端口不一致的情况。对此，开发环境的搭建需要特殊处理，否则无法远程通过服务器的组件搭建开发环境。

因此，客户希望提供内外网IP端口不一致时的苍穹开发环境搭建方案，保障网络安全的前提下有序开展后续开发工作。

解决方案

方案整体思路

苍穹开发环境的搭建流程如下图所示：

上传图片

苍穹开发环境搭建流程

当苍穹开发助手连接上配置的MC信息后，会拉取对应的静态资源和jar包。接着，需要在开发环境变量中配置集群编码、租户ID、Zookeeper地址信息，然后本地开发环境会访问Zookeeper来读取苍穹所有的配置信息。

但由于MC中配置的内外网地址与端口不一致，故需要利用域名去进行解析，不同的应用解析到不同的地址。而针对内外网端口不一致的情况，可以通过端口代理解决。

本质上，就是使内外网访问的域名地址和端口信息一致，但是又通过解析和转发指定到了内外网不同的地址上。

关键步骤

1.对于JDK和IDEA的安装，网上有很多资料，此处不作赘述。苍穹开发助手安装可以参考社区文档：开发助手简介及安装（https://vip.kingdee.com/link/s/laCKB）

2.安装完苍穹助手后，配置服务地址信息，如下图所示：

上传图片

配置服务地址信息

然后，点击“苍穹开发助手>更新环境”同步文件。

上传图片

上传图片

更新环境

3. 配置端口映射，将中间件的端口映射出来以便客户端访问。配置方法参考如下：

ZooKeeper映射配置

上传图片

ZooKeeper端口映射配置

RabbitMQ映射配置

上传图片

RabbitMQ端口映射配置

Redis映射配置

Redis需要特殊注意，因为哨兵模式是先暴露一个XXXX端口映射Redis具体的6379端口，然后应用连接XXXX端口会自动选出Master节点，并把Master节点的信息和端口反馈给应用服务去连接。

上传图片

Redis端口映射配置

MC中配置的中间件访问地址是用域名配置，这些域名会自动解析到具体IP地址上（Redis配置也需要域名）。

注意：因为该案例容器是中间件部署，故会自动解析，如果非容器部署，需要手动在gPaaS上配置域名解析。

上传图片

配置域名解析

最后，这些外部端口都映射到192.168.XXX.XXX IP上。

4. 配置本地解析：

本机hosts
127.0.0.1 kd-adcc-cs.ca159-middleware             -- zookeeper
127.0.0.1 dev-redis.ca159-middleware              --redis
127.0.0.1 rabbitmq-rabbitmq-ha.ca159-middleware   --MQ

5. 然后，在windows上配置代理转发：

netsh interface portproxy add v4tov4 listenaddress=0.0.0.0 listenport=2181 connectaddress=192.168.XXX.XXX connectport=39110   --zookeeper
netsh interface portproxy add v4tov4 listenaddress=0.0.0.0 listenport=6379 connectaddress=192.168.XXX.XXX connectport=39916   --redis
netsh interface portproxy add v4tov4 listenaddress=0.0.0.0 listenport=5672 connectaddress=192.168.XXX.XXX connectport=30203   --MQ

注：配置0.0.0.0是让所有流量都走这个代理。

6. 启动类配置，更改苍穹配置文件，相关代码如下：

# kd.cosmic.Application文件
cosmic.setClusterNumber("ceair");
cosmic.setTenantNumber("dev");
cosmic.setConfigUrl("kd-adcc-cs.ca159-middleware:2181");   
  
# kd.cosmic.server.Launcher文件
set("lightweightdeploy", "false");
set("redis.serversForSession","dev-redis.ca159-middleware:6379/Cosmic@2020");
set("redis.serversForCache","dev-redis.ca159-middleware:6379/Cosmic@2020");

注意事项

1. 有时候不小心添加错了对应命令，可以进行删除，方法如下：

删除端口转发：

netsh interface portproxy del v4tov4 listenport=10001 listenaddress=192.168.xxx.xxx

查看端口转发：

netsh interface portproxy show all

2. 因为代理不稳定，端口转发时可能会因为网络波动失效，重启端口转发可以解决，方法如下：

net stop iphlpsvcnet start iphlpsvc

方案的复用价值

该方案可以解决因无法直接访问服务器，而不能使用苍穹开发环境进行联调开发的场景，具备普适性。

#往期推荐#

# 实践案例 | 苍穹数据库扩容及分应用部署方案，保你系统稳定！

# 实践案例 | 超详细苍穹环境迁移方案，你值得拥有！

# 实践案例 | 如何实现苍穹对接云之家智能审批单

# 实践案例｜GetFieldValue函数在凭证模板中的应用

更多精彩内容，“码”上了解！↓

上传图片

实践案例 | 如何在内外网IP端口不一致下搭建苍穹开发环境

实践案例 | 如何在内外网IP端口不一致下搭建苍穹开发环境

恭喜您！