Cloud Foundry中vmc tunnel与caldecott原理

        在Cloud Foundry中，用户可以vmc create-service创建一个service instance，但是常规情况下，用户不能手动地进一步对service instance进行设计。以MySQL为例，用户可以创建一个MySQL instance，但是一般情况下，用户不能直接对整个MySQL的database进行schema设计，或者进行增删改查的操作。对于MySQL service instance的内部操作，都是由部署在Cloud Foundry上的app应用程序来完成的。

        为了可以使得用户在Cloud Foundry外部，对该用户创建的service instance进行schema设计或者增删改查的操作，Cloud Foundry的指令客户端vmc通过vmc tunnel指令来实现。以MySQL为例，vmc tunnel最直接的功能就是：允许用户在Cloud Foundry外部的MySQL client对MySQL node上的service instance进行schema设计或者增删改查的操作。

       该文档主要基于Cloud Foundry v1版本，vmc版本为0.3.18 。

       以下是具体实现流程：

       上图为vmc与Cloud Foundry的Cloud Controller，DEA，MySQL node等组件的交互图。该图的应用背景为：已经创建完一个MySQL instance，需要通过vmc tunnel来完成用户对该MySQL instance的内部操作。以下为vmc tunnel指令执行过程中所涉及的操作。

       步骤1：用户通过vmc向Cloud Foundry部署一个app应用caldecott。vmc获取app应用的配置信息，并与该应用的程序代码发送给Cloud Foundry的Cloud Controller。

       步骤2：Cloud Controller接受到用户的vmc请求后，成功在DEA上部署应用caldecott，并启动该应用。

       步骤3：vmc发送绑定请求给Cloud Controller，将caldecott应用与需要执行内部操作的MySQL instance进行绑定。

       步骤4：Cloud Controller将该MySQL instance的credentials与该应用的脚本，程序代码放在一起重新打包，并在DEA中启动。

       以上4个步骤均为简单的vmc push以及vmc bind-service操作，了解的Cloud Foundry应用部署的开发者一定不会感到陌生。

       以下是vmc如何通过caldecott应用与MySQL instance进行交互。在介绍实现机制之前，先来了解一下caldecott这个应用程序的功能与框架。

       caldecott应用

      首先该caldecott应用是一个sinatra框架的应用。在功能上，主要分为两个部分：第一，接收vmc发送来的http请求，并从该应用的环境变量中获取绑定的service instance的信息，并将这些service instance的credentials返回给vmc；第二，接受vmc的caldecott client发送来的建立tunnel请求，本身作为一个caldecott server建立与caldecott client的连接之后，将client发送来的内容再发给mysql server。以下为caldecott应用程序的大部分ruby代码：

# add vcap specific stuff to Caldecott
class VcapHttpTunnel < Caldecott::Server::HttpTunnelget '/info' do{ "version" => '0.0.4' }.to_jsonenddef self.get_tunnelssuperendget '/services' doservices_env = ENV['VMC_SERVICES']return "no services env" if services_env.nil? or services_env.empty?services_envendget '/services/:service' do |service_name|services_env = ENV['VMC_SERVICES']not_found if services_env.nil?services = JSON.parse(services_env)service = services.find { |s| s["name"] == service_name }not_found if service.nil?service["options"].to_jsonend
endVcapHttpTunnel.run!(:port => port, :auth_token => ENV["CALDECOTT_AUTH"])

       紧接着步骤4，vmc通过应用caldecott操作MySQL instance：

       步骤5：vmc通过restful请求，向caldecott索取已绑定service instance的credentials信息。

       步骤6：caldecott从环境变量中读取service的credentials，并将其返回给vmc。

       步骤7：vmc在用户的机器上开辟一个端口，并使用该端口，caldecott的url，service instance的host以及port来创建一条tunnel。创建的发起者为caldecott::client，该连接的接受者为caldecott::server，也就是部署在DEA上的caldecott应用的第二个功能，如以上代码继承部分与最后一行。其中vmc端的创建连接代码如下：

def start_tunnel(local_port, conn_info, auth)@local_tunnel_thread = Thread.new doCaldecott::Client.start({:local_port => local_port,:tun_url => tunnel_url,:dst_host => conn_info['hostname'],:dst_port => conn_info['port'],:log_file => STDOUT,:log_level => ENV["VMC_TUNNEL_DEBUG"] || "ERROR",:auth_token => auth,:quiet => true})endat_exit { @local_tunnel_thread.kill }
end

       步骤8：caldecott应用作为一个caldecott::server，建立一条与MySQL server的TCPConnection。

      以上的8个步骤，实现了Cloud Foundry的外部用户通过vmc与部署在Cloud Foundry上的应用caldecott建立与MySQL server的连接。

      完成了以上的操作，当用户执行mysql指令时，执行“mysql --protocol=TCP --host=localhost --port=10000 --user=uQQMx1PDleAlh --password=p31HW4mHr7LVd d52a850c9721d4f30b1652fa438bbdc79”。其中10000为本机与caldecott创建tunnel的端口号，所以该请求会通过caldecott::client发给应用caldecott中的caldecott::server，而caldecott::server又会将请求发给MySQL server，最后由MySQL server解析执行并返回结果。

关于作者：

孙宏亮，DAOCLOUD软件工程师。两年来在云计算方面主要研究PaaS领域的相关知识与技术。坚信轻量级虚拟化容器的技术，会给PaaS领域带来深度影响，甚至决定未来PaaS技术的走向。

转载请注明出处。

这篇文档更多出于我本人的理解，肯定在一些地方存在不足和错误。希望本文能够对开始接触Cloud Foundry中service的人有些帮助，如果你对这方面感兴趣，并有更好的想法和建议，也请联系我。

我的邮箱：allen.sun@daocloud.io

新浪微博：@莲子弗如清