fc-tunnel

简介

一个快速打通本地开发环境和阿里云云上 vpc 具体实例 tcp 网络的简洁工具

快速开始

前提条件

• 本地已经有 python3.x

• 本地已经安装了docker

• 开通函数计算，并登录函数计算控制台， 第一次登录会引导您完成 FCDefaultRole 授权创建

安装

$ pip install fc-tunnel

编写配置文件 config.json, 例如:

{
  "akId": "your aliyun ak id",
  "akSecret": "your aliyun ak secret",
  "accountId": "your aliyun main account id",
  "region": "cn-beijing",
  "vpcId": "vpc-2zes9muk32e82wwt7kfef",
  "vSwitchIds": "vsw-2zek7r3kcvmu3div13bh4",
  "securityGroupId": "sg-2zed3dvbh98kzoi3cch5",
  "remoteIP": "10.20.108.195",
  "remotePorts": "8080,9000"
}

其中：

• 如果 ak 不是对应主账号或者具有 admin 权限的子账号， 请先给 ak 对应的子账号添加 FCFullAccess 和 自定义 RAM Policy:

{
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "tns:*",
            "Resource": "*"
        }
    ],
    "Version": "1"
}

• remoteIP 表示云上阿里云 vpc 的内网地址， 具体可以是 SAE 应用的实例内部 IP， ECI 实例的内部 IP， ECS 内网 IP 等

• remotePorts 对应 remoteIP 实例映射到本地的端口

如上面的 config.json 所示， 如果您有一个 vpc 内置地址为 10.20.108.195 的 SAE 实例， 这个 SAE 实例上跑的是一个 java SpringBoot 的应用， 8080 是 web 服务端口， 9000 是远程调试的端口

建立通道， 远程访问及调试

$ fct -c config.json

耐心等待， 直到输出 Session is OK! now you can remote debug, 注意不要关闭这个终端。

以上面那个 config.json 为例， 这个时候：

• 可以直接使用 http://127.0.0.1:8080 访问 SpringBoot 网站

• 直接使用本地 IDE IDEA 上的源码对实例上的 jar 包进行远程调试

  1. 在菜单栏选择 Run… > Edit Configurations 。
  2. 新建一个 Remote Debugging 。
  3. 自定义调试器名称，并将端口配置为 9000 。
  4. 上述配置完成后，在 IDEA 编辑器侧边栏为函数代码增加断点，点击"开始调试"按钮。

当然您也可以借助本地的代理容器实例，作为跳板机， 实现对云上具体实例的管理操作

$ docker ps -a | grep VPN-Local
d46a86c27abd   registry.cn-beijing.aliyuncs.com/aliyunfc/vpn-local-proxy:v0.0.1   "/usr/app/start.sh"   5 minutes ago   Up 5 minutes   0.0.0.0:8080->8080/tcp, 0.0.0.0:9000->9000/tcp   VPN-Local-S-5ecc9bda-6d83-4f5d-884c-6739d8a3925e

$ docker exec -it d46a86c27abd bash
root@d46a86c27abd:/usr/app# telnet 10.20.108.195 8080
Trying 10.20.108.195...
Connected to 10.20.108.195.
Escape character is '^]'.

关闭通道

调试完毕后， 直接 CTRL+C 结束建立通道命令执行的那个终端， 会自动执行清理 FC 资源操作， 尤其是会自动取消有付费的预留

其他

通道建立借助了 Serverless 的 FC 128M 实例, FC的计费粒度精确到毫秒计费

• 函数实例资源使用量：每月前400,000 GB-秒函数实例资源使用量免费

• 即使不考虑每个月的免费额度，我们这里折算成小时， 也就是您调试 1h, 费用大约为 0.000110592元/GB-秒128/10243600 =0.0497 元

FC 计费详情