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::HttpTunnel
  get '/info' do
    { "version" => '0.0.4' }.to_json
  end

  def self.get_tunnels
    super
  end

  get '/services' do
    services_env = ENV['VMC_SERVICES']
    return "no services env" if services_env.nil? or services_env.empty?
    services_env
  end

  get '/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_json
  end
end

VcapHttpTunnel.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 do
        Caldecott::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
        })
      end

      at_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解析执行并返回结果。

转载清注明出处。

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

我的邮箱：shlallen@zju.edu.cn

新浪微博：@莲子弗如清