这个例子将会向你展示如何在Kubernetes上打包运行一个Meteor
app。
从谷歌的计算引擎开始
Meteor使用MongoDB,并且我们使用GCEPersistentDisk类型的卷作为永久存储介质。所以,这个实例只使用于谷歌的计算引擎。如果想选用其它的方式,可以去查看一下卷使用文档。
首先,你需要完成如下操作:
建立一个谷歌云平台的项目。
启用Google的付费API??
安装谷歌云的SDK。
认证谷歌云并且将谷歌云的默认项目名称指向你希望部署Kubernetes集群的项目:
gcloud
auth login
gcloud config set project <project-name> |
之后,开启一个Kubernetes集群
wget
-q -O - https://get.k8s.io | bash |
所有细节和其它方式下启动集群的方法。
为你的Meteor APP创建一个容器
为了使一个Meteor APP能运行再Kubernetes上,你首先需要建立一个Docker容器。在建立之前你需要安装DOCKER。一旦这些都具备了,你需要将Dockerfile和.dockerignore这2个文件添加到当前的Meteor工程中。
Dockerfile文件中应该包含下面的语句。其中的ROOT_URL你应该替换为当前APP的主机名。
FROM
chees/meteor-kubernetes
ENV ROOT_URL http://myawesomeapp.com |
对于.dockerignore文件,应该包含下面的语句。它是为了告诉Docker,再建立你的容器时忽略以下指定路径的文件。
.meteor/local
packages/*/.build* |
你可以在下面的链接中看到一个已经建立起来的Meteor工程:meteor-gke-example。你可以随意的使用这个例子中的APP。
如果你已经在你的Meteor工程中添加了移动平台,那么下面的步骤将不起作用。所以替换你的平台为
meteor list-platforms。
现在,你就可以在你的Meteor工程中运行下面的语句来建立一个容器:
docker
build -t my-meteor . |
推送一个注册表
对于Docker Hub,你需要利用下面的命令向Hub推送一个携带了你的用户名的APP图片,请注意替换<username>为你对应的Hub
用户名。命令如下:
docker
tag my-meteor <username>/my-meteor
docker push <username>/my-meteor |
对于Google Container Registry,你需要向GCR推送一个携带你的工程ID的APP图片,同时,请注意替换<project>为你的对应工程ID。
docker
tag my-meteor gcr.io/<project>/my-meteor
gcloud docker push gcr.io/ <project>/my-meteor |
运行
现在,你已经容器化了你的Meteor APP,是时候开始建立你的集群了。编辑meteor-controller.json
同时确保image:与你刚刚推送到Docker Hub或者GCR的容器是相对应的。 我们将需要一个MongoDB作为一个永久的Kubernetes卷来存放数据。我们将利用谷歌的计算引擎永久磁盘。创建MongoDB磁盘的命令如下:
gcloud
compute disks create --size=200GB mongo-disk
|
你可以开启Mongo去使用那些磁盘,命令如下:
kubectl
create -f examples/meteor/mongo-pod.json
kubectl create -f examples/meteor/mongo-service.json
|
等待Mongo完全启动,之后你就可以开启自己的Meteor APP:
kubectl
create -f examples /meteor/meteor-service.json
kubectl create -f examples/ meteor/meteor-controller.json
|
需要注意的是,meteor-service.json创建了一个负载均衡器,所以你的APP要求能在Meteor
Pods启动时,有效的通过负载均衡器的IP。我们会再建立RC之前建立一个服务,该服务会提供反向关联(或者其它的什么)用以帮助调度程序去排列pod,从而帮助调度程序匹配对应的pods。你可以通过下面的命令获得你的负载均衡器的IP:
kubectl
get service meteor --template=" {{range
.status.loadBalancer.ingress}} {{.ip}} {{end}}"
|
之后,你需要在你的环境上开启你的80号端口。如果是使用谷歌计算引擎的用户,你需要运行下面的命令:
gcloud
compute firewal l- rules create meteo r-80
--allow = tcp:80 --target-tags kubernetes-minion
|
接下来呢?
首先,在Dockerfile中的FROM chees/meteor-kubernetes语句会指定Meteor
APP的基础镜像。这个镜像的构建代码放置在示例代码工程的dockerbase/子目录下。你可以通过阅读Dockerfile文件中的代码来了解docker
build的步骤。这个镜像是基于Node.js官方镜像构建的。它会安装Meteor并将用户的程序拷贝进去。其中的最后一行的命令指出了你的app需要通过怎样的命令在容器中运行起来。
ENTRYPOINT
MONGO_URL= mongodb://$MONGO_SERVICE_HOST :$MONGO_SERVICE_PORT
/usr/local/bin/node main.js |
在上面的命令中,我们能看到传递到Meteor App的MongoDB主机和端口信息。MONGO_SERVICE...这个环境变量是由Kubernetes设置的,同时,由mongo-service.json指定了名为mongo的服务器的详细信息。
也许你已经了解,Meteor需要使用TCP长连接,以及持续性的Session(Sticky
Sessions)。通过Kubernetes用户能够轻松的在集群Scale out时保持节点的Session相关性。在meteor-service.json文件中所包含的"sessionAffinity"*
: *"ClientIP",就向我们提供了这些。
就向之前所提到的,mongo容器使用了一个被Kubernetes映射到永久磁盘的卷。在mongo-pod.json中,容器对指定的卷进行了划分:
{
"volumeMounts": [
{ "name": "mongo-disk",
"mountPath": "/data/db"
} |
mongo-disk是指超出容器范围的卷:
{
"volumes": [
{ "name": "mongo-disk",
"gcePersistentDisk": { "pdName":
"mongo-disk", "fsType":
"ext4"
}
}
], |
|