使用 Azure CLI 在 Azure China Cloud 云平台上手动部署一套 Cloud Foundry

这篇文章将介绍如何使用 Azure CLI 在 Azure China Cloud 云平台上手动部署一套 Cloud Foundry。本文的目的在于：

了解作为 PaaS 的 Cloud Foundry 其底层 IaaS 平台的架构。通过本文，你将明白一个简单的 CF 所需的最低的 IaaS 配置，以及如何按实际需求自定义 CF 的 IaaS 平台。
了解用于管理 Cloud Foundry 的分布式系统生命周期管理软件的 Bosh 的搭建和使用。通过本文，你将明白如何通过 bosh-init 工具安装bosh 虚拟机，如果通过 bosh CLI 命令部署和管理 deployment。
让读者熟悉 Azure CLI 命令集，Bosh CLI 命令集和 CF CLI 命令集。

任何 PaaS 都必须依附于底层的 IaaS 环境，这里我们使用 Azure 云平台。下图中显示了 CF 与 IaaS，及其管理软件的关系。

而我们安装 CF 的步骤，将从左至右进行。主要分为以下步骤：

在 Azure 上创建 CF 所需 IaaS 环境。该过程包括创建各种资源，如存储账号，网卡，IP，虚拟网络及子网，网络安全组等，并将其集中放置在一个资源组下。配置好操作员用于管理 bosh 和 CF 的跳板机。
通过跳板机，安装配置 bosh。该过程会新建一台虚拟机，bosh 的各个组件将通过 bosh-init 安装在该虚拟机上。
通过跳板机，使用 bosh cli 操作 bosh director 部署 CF。根据 manifest 文件，该过程将会创建一台或多台虚拟机，cloud Foundry 的各个组件将会安装在虚拟机上。
使用 CF 进行应用软件开发管理。到这一步，说明 CF 环境已经准备妥当，用户可以在该 PaaS 环境中进行应用软件的管理。

为跳板虚拟机准备 ssh-key

从这一步开始，到跳板机安装完成，所有操作将在 Azure CLI 中完成。关于如何安装 Azure CLI 请参见链接。

打开 Azure CLI，将 CLI 切换到 ARM 模式。

azure config mode arm

登录Azure:

azure login -e AzureChinaCloud

根据开启浏览器，输入 URL，填写代码。代码匹配成功后，将会转到 Azure 认证界面，请输入订阅的服务管理员和密码。验证成功后，命令行界面将会出现登录成功信息。之后，可安全关闭浏览器，浏览器操作部分如下图。

输入 CLI 中的 Code：

输入账号密码登陆：

接下来使用命令查询账号的基本信息，如果一个账号下有多个订阅，使用 account set 命令选中其中一个。

查询该订阅的详细信息，并用变量记录下订阅号和租户号，后续命令中会使用。

为 bosh 准备服务主体

接下来我们将为 bosh 创建一个 AAD 账号，该账号将用于 bosh 与 Azure 订阅之间的认证授权。

azure ad app create --name lqicfad01 --password Lq1cfAD01 --home-page "https://lqicf01" --identifier-uris "https://lqicf01"

为该账号创建服务主体。

azure ad sp create -a %Client_ID%

并赋予其对应权限，使其拥有在 Azure 平台上对授权的订阅有进行资源创建管理的权限，如创建或删除虚拟机，创建或删除网卡等。

azure role assignment create --spn %SPN% --roleName "Virtual Machine Contributor" --subscription %Sub_ID%

azure role assignment create --spn %SPN% --roleName "Network Contributor" --subscription %Sub_ID%

查看以确认授权成功。

Bosh 和 CF 所需资源准备

接下来，我们要为 bosh 和 CF 准备一个 IaaS 平台。包括：

ARM 模式下的一个资源组。
一个存储账号。该账号下包含两个容器，分别用于存放 bosh 虚拟机和 stemcell 镜像文件。
一个静态公网 IP，在部署 Cloud Foundry 将会使用。
一个虚拟网络。该网络下属三个子网，分别用于 bosh，cf 和 diego。
两个网络安全组。分别用于限制 bosh 和 cf 子网的网络端口。
一台虚拟机，及其对应的网卡和公网 IP。该虚拟机将作为用户的跳板机。
配置跳板机。在进项 bosh 安装前，需要更新虚拟机到最新版本，并安装 bosh-init，bosh cli 等工具。通过这些工具才能安装 bosh director 及其他 bosh 组件。Bosh 安装好之后，用户也会使用这台机器与 bosh director 通行，来部署和管理 Cloud Foundry。

资源组

azure group create --name lqicfrg01 --location "China East"

存储账号

azure storage account create --location "China East" --type GRS --resource-group lqicfrg01 lqicfsa01

创建完成后，可以查看存储账号信息。

将存储账号的密钥保存下来，以备后续使用。

接下里要在存储里创建两个容器，bosh 和 stemcell。Bosh 用于存放 bosh director 虚拟机的磁盘等数据；stemcell 用于存放下载的stemcell 镜像文件。这两个容器名字不能更改。

azure storage container create --account-name lqicfsa01 --account-key %Storage_Key% --container bosh

azure storage container create --account-name lqicfsa01 --account-key %Storage_Key% permission Blob --container stemcell

CF 公网 IP

CF 公网 IP 是最后一步中部署 CF 环境中需要使用的。需要给 CF 分配一个公网 IP，这样应用可以通过该 IP 从外网被访问到。

azure network create --resource-group lqicfrg01 --location "China East" --allocation-meth Static --name lqicfip01-cf

虚拟网络及其子网

为整套环境创建一个虚拟网络。该网络包含三个子网，分别用户 bosh director 环境，CF 环境和 Diego 环境。

azure network vnet create --resource-group lqicfrg01 --name lqicfvnet01 --location "china East" --address-prefixes 10.0.0.0/16

azure network vnet subnet create --resource-group lqicfrg01 --vnet-name lqicfvnet01 --name lqicfvnet01-bosh --address-prefixes 10.0.1.0/24
azure network vnet subnet create --resource-group lqicfrg01 --vnet-name lqicfvnet01 --name lqicfvnet01-cf --address-prefix 10.0.2.0/24
azure network vnet subnet create --resource-group lqicfrg01 --vnet-name lqicfvnet01 --name lqicfvnet01-diego --address-prefix 10.0.3.0/24

网络安全组

为防止不必要的网络流量以及考虑到各个子网的安全性，为 bosh 和 CF 分别创建了网络安全组。

azure network nsg create --resource-group lqicfrg01 --location "China East" --name lqicfnsg01-bosh
azure network nsg create --resource-group lqicfrg01 --location "China East" --name lqicfnsg01-cf

为不同安全组设置规则。

azure network nsg rule create --resource-group lqicfrg01 --nsg-name lqicfnsg01-bosh --access Allow --protocol Tcp --direction Inbound --priority 200 --source-address-prefix Internet --source-port-range * --destination-address-prefix * --name ssh --destination-port-range 22
azure network nsg rule create --resource-group lqicfrg01 --nsg-name lqicfnsg01-bosh --access Allow --protocol Tcp --direction Inbound --priority 201 --source-address-prefix Internet --source-port-range * --destination-address-prefix * --name bosh-agent --destination-port-range 6868
azure network nsg rule create --resource-group lqicfrg01 --nsg-name lqicfnsg01-bosh --access Allow --protocol Tcp --direction Inbound --priority 202 --source-address-prefix Internet --source-port-range * --destination-address-prefix * --name bosh-director --destination-port-range 25555
azure network nsg rule create --resource-group lqicfrg01 --nsg-name lqicfnsg01-bosh --access Allow --protocol * --direction Inbound --priority 203 --source-address-prefix Internet --source-port-range * --destination-address-prefix * --name dns --destination-port-range 53
azure network nsg rule create --resource-group lqicfrg01 --nsg-name lqicfnsg01-cf --access Allow --protocol Tcp --direction Inbound --priority 201 source-address-prefix Internet --source-port-range * --destination-address-prefix * --name cf-https --destination-port-range 443
azure network nsg rule create --resource-group lqicfrg01 --nsg-name lqicfnsg01-cf --access Allow --protocol Tcp --direction Inbound --priority 202 source-address-prefix Internet --source-port-range * --destination-address-prefix * --name cf-log --destination-port-range 4443

bosh 跳板机

接下来需要手动创建一个 bosh 跳板机，这台跳板机将用于部署 bosh director, CF 及用来访问 bosh director 和 CF 环境。

首先创建获取 IP，并将 IP 绑定到网卡。

azure network public-ip create --resource-group lqicfrg01 --location "china east" --allocation-method Dynamic --name lqicfip01-bosh
azure network nic create --resource-group lqicfrg01 --location "china East" --name lqicfnic01-bosh --public-ip-name lqicfip01-bosh --private-ip-address 10.0.1.10 --subnet-vnet-name lqicfvnet01 --subnet-name lqicfvnet01-bosh

查询并选择需要的镜像文件用于创建 VM:

azure vm image list --location "china east" --publisher canonical --offer UbuntuServer

创建 VM:

azure vm create --resource-group lqicfrg01 --name lqicfvm01-bosh --location "China East" --os-type linux --nic-name lqicfnic01-bosh --vnet-name lqicfvnet01 --vnet-subnet-name lqicfvnet01-bosh --storage-account-name lqicfsa01 --image-urn canonical:UbuntuServer:14.04.3-LTS:14.04.201606270 --ssh-publickey-file C:\Test\lqicfvm01-bosh.pub --admin-username boshuser

创建完成后，用户将可以使用 ssh 密钥通过 putty 登录到跳板机上。

配置跳板机

通过 putty 导入 ssh 密钥，输入用户名，就可以成功登录到跳板机。

更新 OS 到最新版本。

安装 Bosh 和 CF 需要的软件包。

sudo apt-get install -y build-essential ruby2.0 ruby2.0-dev libxml2-dev libsqlite3-dev libxslt1-dev libpq-dev libmysqlclient-dev zlibc zlib1g-dev openssl libxstl-dev libssl-dev libreadline6 libreadline6-dev libyam                                                                                                                                                             l-dev sqlite3 libffi-dev

将命令指向最新的软件版本。

配置使用于中国区域的 gem。Gem 是用于管理 ruby 开发环境的。

通过 gem 更新 ruby 环境。

下载安装 bosh-init。该工具用于部署安装 bosh director。

wget -O bosh-init https://s3.amazonaws.com/bosh-init-artifacts/bosh-init-0.0.51-linux-amd64

使用 bosh-init 安装 bosh

为了解 bosh-init 在安装 bosh 过程中，IaaS 层的作用，建议将现有的资源组中的资源及其状态都记录下来。你可以看到的是，网络安全组尚未关联任何网络或虚拟机；cf 的公网 IP 没有分配给任何虚拟机；资源组中只有一台虚拟机；存储账户中，stemcell 和 bosh 容器下没有任何内容。

首先，我们要创建一堆 ssh 密钥对，用于 bosh 跳板机与即将创建的 bosh director 之间的登录认证。公钥放在配置文件 bosh.yml 中，私钥放在当前目录下，命名为 bosh（也可以命名为其他名字，但需要同时在 bosh.yml 中更改）。具体方式可以参见本文“为跳板虚拟机准备 ssh-key” 这一节.

其次，下载或编写 bosh 的 manifest 文件 bosh.yml。你需要参考一下链接，以获得你要安装的 bosh 的版本及其验证码：

https://bosh.cloudfoundry.org/releases/github.com/cloudfoundry/bosh?all=1

你要安装的 bosh azure cpi 的版本及其验证码：

https://bosh.io/releases/github.com/cloudfoundry-incubator/bosh-azure-cpi-release?all=1

安装 bosh 使用的镜像文件及其验证码

http://bosh.cloudfoundry.org/stemcells/

http://bosh.cloudfoundry.org/stemcells/bosh-azure-hyperv-ubuntu-trusty-go_agent

设置安装日志存储位置

安装 bosh

安装完成后，使用 bosh cli 命令查看 bosh 状态:

上图显示 bosh 目前没有关联到任何 director；.bosh_config 中为没有任何内容。使用 bosh target 命令为当前会话指定 bosh director。Target 后跟的 IP 为 bosh.yml 中定义的 director IP。指定 target 后，.bosh_config 中会记录下当前 target 的详细信息。Status 显示也有所不同。

可以使用 releases 查看是否有上传的 release；deployments 查看该 director 下的部署。因为是新环境，所以没有任何 release 和部署。

同时，你也可以登录到 bosh director 上去查看信息。

在 azure portal 中，你也能看到变化。

部署 CF

本小节包含

创建 CF 的 manifest
上传 stemcell 和 release
指定当前部署
部署 CF

因为没有注册域名，这里使用 xip.io 作为 CF 实验环境的域名；该域名解析会将域名直接解析为前面添加的 IP 地址。接下来我们将通过命令 bosh 命令行操作 Bosh Director 来管理 deployment。首先是要创建一个 deployment。基本步骤为

创建 CF 的 manifest

创建一个 deployment 的 manifest，说明该 deployment 需要什么 stemcell 来创建 VM，使用哪些 releases 来进行 VM 上的配置，并列出要安装的应用或软件，使用的网络，VM 大小等资源，需要创建的用户名密码等等等等详尽的信息。Manifest 可以自己手动创建，也可以从 github 上下载现成的模板再进行自定义。

从 github 上下载对应的 cf manifest 文件，并将里面的变量设置成自定义的值。

上传 stemcell 和 release

上传该 manifest 要使用的 stemcell 和 release。一个特定的 deployment 需要一个或多个 stemcell 作为其基本镜像，以及一个或多个 release 说明其应该安装的软件包，组件或者配置信息。在使用 Director 开始部署 deployment 前，需要完成以下两个步骤：

在 director 上为每个 resource pool 指定一个 stemcell,下面为 manifest 文件的部分截屏，显示的是 stemcell 的信息。

将 stemcell 从网站上下载下来，并上传到 bosh director 指定的存储账号中，这里是我们之前创建的容器 stemcell。
将该 deployment 需要的所有 release 上传到 director。需要的 release 已经定义在 manifest 文件中，请确保所有 release 已经传到 director。

两种方式：URL 或者本地。如果网络不好，URL 方式有可能会上传失败，因此可以通过先下载到本地再上传的方式。

指定当前部署

如果 yml 文件格式有误，将会提示错误，请根据错误修正文件。

部署 CF

部署过程中可能出现错误，可以通过 bosh task --debug 查看具体信息，再进行修复。

如此，CF 搭建完成。你可以在 Azure 门户上看到该资源组中会新增几台虚拟机等资源。使用 CF 需要安装 Cloud Foundry CLI。使用 wget 下载（该命令可能会失败，请再次运行）。

wget -O cf.deb http://go-cli.s3-website-us-east-1.amazonaws.com/releases/v6.14.1/cf-cli-installer_6.14.1_x86-64.deb

如此，CF 环境搭建成功。使用 cf --help 命令可以查看 cf 的操作有哪些。首先找到配置好的 CF 的公网 IP。在该家目录下的 setting 文件中，记录了 BOSH 环境的相关信息，可以在此查到 cf 的 IP 地址。接下来，用户可以使用该环境进行应用的管理了。

Table of Contents

使用 Azure CLI 在 Azure China Cloud 云平台上手动部署一套 Cloud Foundry

IaaS 环境准备

为跳板虚拟机准备 ssh-key

为 bosh 准备服务主体

Bosh 和 CF 所需资源准备

资源组

存储账号

CF 公网 IP

虚拟网络及其子网

网络安全组

bosh 跳板机

配置跳板机

使用 bosh-init 安装 bosh

部署 CF

创建 CF 的 manifest

上传 stemcell 和 release

指定当前部署

部署 CF