ASP.NET Core 借助 K8S 玩转容器编排

Production-Grade Container Orchestration - Automated container deployment, scaling, and management.
生产级别的容器编排系统——自动化的容器部署、扩展和管理。

1. 引言

因为最近在学习微服务，因此就基于以前docker的基础上把玩一下k8s（Kubernetes），以了解基本概念和核心功能。

2. What's k8s？

k8s涉及到不少基本概念，能够看十分钟带你理解Kubernetes核心概念快速了解。
下面这张图包含了k8s了核心组成模块：

这里就简单罗列如下：

1. k8s Master：k8s主节点，主要包括：

• API Server：提供能够用来和集群交互的REST端点。
• Replication Controller：用来建立和复制Pod。

1. Node：k8s节点，能够是虚拟机或物理机。其又包含如下组件：

• Kubelet：是主节点代理。
• Kube-proxy：Service使用其将连接路由到Pod，如上文所述。
• Docker或Rocket：Kubernetes使用的容器技术来建立容器。

1. Pod：用来托管应用程序实例，包含：

• Container：运行的容器
• Volume：共享存储 (卷)
• IP Address：IP 地址

1. Labels：标签，用于给pod打标签
2. Service：服务，由一组相同Label的Pod组成，其用来控制访问Pods的策略

3. 环境准备

梳理完基本概念，咱们来动手玩一玩吧。有三种玩法：一种就是跟随k8s官方的在线实验室进行实操；第二种就是基于Docker For Windows 中集成的k8s进行玩耍；第三种就是安装MiniKube捣鼓。这里选择第二种进行讲解。

PS：不少初学者在环境准备阶段遭遇挫折的后就直接放弃了，笔者为了搭建这个k8s环境也耗费了很多时日，其中包含一次重装系统，汗！但愿下面的步骤助你k8s之行有个好的开端。

3.1. 在Docker for Windows中启用Kubernetes

首先确保你已安装Docker for Windows。
由于那道墙，在Docker For Windows Client中启用Kubernetes，并无想象的那么顺利。最后参照这篇文章成功启用：为中国用户在 Docker for Mac/Windows 中开启 Kubernetes。
若是安装了最新版本的docker for windows 客户端（v2.0.0.3)，可参考如下步骤：

1. 为 Docker daemon 配置 Docker Hub 的中国官方镜像加速 https://registry.docker-cn.com
2. git clone https://github.com/AliyunContainerService/k8s-for-docker-desktop.git
3. cd k8s-for-docker-desktop
4. git checkout v2.0.0.2 （这一步很重要！！！）
5. Powell shell执行./load_images.ps1
6. Enable Kubernetes
7. 执行kubectl cluster-info，输出如下，表示正常启动。

Kubernetes master is running at https://localhost:6445
KubeDNS is running at https://localhost:6445/api/v1/namespaces/kube-system/services/kube-dns:dns/proxy

To further debug and diagnose cluster problems, use 'kubectl cluster-info dump'.

环境搭建成功，你就成功了一半，请再接再砺动手完成如下实验！

4. 运行第一个Pod

4.1. 建立初始镜像

1：首先咱们执行dotnet new mvc -n K8s.NET.Demo 建立一个ASP.NET Core Mvc应用K8s.NET.Demo
修改HomeController以下所示：

public class HomeController : Controller {
    public IActionResult Index () {
        var hostname = Dns.GetHostName ();
        ViewBag.HostName = hostname;
        ViewBag.HostIp = Dns.GetHostAddresses (hostname).FirstOrDefault (ip => ip.AddressFamily == AddressFamily.InterNetwork);
        return View ();
    }
    public IActionResult Privacy () {
        return View ();
    }
    public IActionResult CheckHealth () {
        if (new Random ().Next (100) > 50) {
            return Ok ("OK");
        } else {
            return BadRequest ();
        }
    }
    [ResponseCache (Duration = 0, Location = ResponseCacheLocation.None, NoStore = true)]
    public IActionResult Error () {
        return View (new ErrorViewModel { RequestId = Activity.Current?.Id ?? HttpContext.TraceIdentifier });
    }
}

修改Index.cshtml以下：

@{
    ViewData["Title"] = "Home Page";
}
<div class="text-center">
    <h1 class="display-4">Welcome</h1>
    <h1>Host Name：@ViewBag.HostName</h1>
    <h1>Host IP：@ViewBag.HostIp</h1>
    <p>Learn about <a href="https://docs.microsoft.com/aspnet/core">building Web apps with ASP.NET Core</a>.</p>
</div>

2：而后添加Dockerfile:

FROM microsoft/dotnet:sdk AS build-env
WORKDIR /app

# Copy csproj and restore as distinct layers
COPY *.csproj ./
RUN dotnet restore

# Copy everything else and build
COPY . ./
RUN dotnet publish -c Release -o out

# Build runtime image
FROM microsoft/dotnet:aspnetcore-runtime
WORKDIR /app
COPY --from=build-env /app/out .
ENTRYPOINT ["dotnet", "K8s.NET.Demo.dll"]

3：而后执行docker build -t k8s.net.demo .构造镜像，构形成功后执行docker images便可查看到名为k8s.net.demo的镜像。

4.2. 建立 pod 描述文件

添加k8s-web-pod.yaml文件以下：

apiVersion: v1
kind: Pod # 定义Kubernetes资源的类型为Pod
metadata:
  name: k8s-net-pod # 定义资源的名称
  labels: # 为Pod贴上标签，后面会介绍其用处
    app: k8s-net-pod
spec: # 定义资源的状态，对于Pod来讲，最重要属性就是containers
  containers: # containers一个数组类型，若是你但愿部署多个容器，能够添加多项
    - name: web # 定义本Pod中该容器的名称
      image: k8s.net.demo # 定义Pod启动的容器镜像地址
      imagePullPolicy: IfNotPresent # k8s默认值为Always，老是从远端拉取镜像，经过设置IfNotPresent或Never来使用本地镜像
      ports:
        - containerPort: 80 # 定义容器监听的端口（与Dockerfile中的EXPOSE相似，只是为了提供文档信息）
      livenessProbe: # 存活探针定义
        httpGet:
          path: /Home/CheckHealth # 存活探针请求路径
          port: 80 #存活探针请求端口

4.3. 使用kubectl create 建立 pod

执行如下命令完成pod的建立：

$ kubectl create -f k8s-web-pod.yaml
pod "k8s-web-pod.yaml" created
$ kubectl get pod
NAME           READY     STATUS    RESTARTS   AGE
k8s-net-pod   1/1       Running   0         1m

4.4. 访问 pod 中运行的容器

要想与 pod 进行通讯，能够经过kubectl port-forward配置端口转发，来完成。

$ kubectl port-forward k8s-net-pod 8090:80
Forwarding from 127.0.0.1:8090 -> 80
Forwarding from [::1]:8090 -> 80

浏览器访问http://localhost:8090/，效果以下图所示：

至此咱们成功跑起了第一个pod。

这时你可能会问，这和我直接用docker run -d -p 8091:80 k8s.net.demo 运行一个容器有什么区别呢？并无看到k8s强大在哪里啊？！
别急，你如今再执行一次kubectl get pod，我来告诉你答案。

$ kubectl get po
NAME           READY     STATUS    RESTARTS   AGE
k8s-net-pod   1/1       Running   17         1h

看到RESTARTS列没有，它是用来讲明pod重启了多少次。使用docker运行容器，若是容器挂掉，docker是不会负责给你重启容器的。
而在k8s中，只须要配置存活探针，k8s就会自动探测容器的运行状态，进行自动重启。而存活探针仅须要在yaml文件中指定livenessProbe节点便可。（PS：/home/checkhealth 使用随机数来模拟容器应用运行状态，当随机数小于50，就返回BadRequest。）

而这，只是k8s的冰山一角。

5. 运行第一个 Service

Pod运行于集群内部，虽然使用kubect port-forward能够映射端口在本机访问，但对于外部依旧没法访问，若是须要暴露供外部直接访问，则须要建立 service。

5.1. 使用 kubectl expose 建立 service

咱们能够经过kubectl expose pod直接将当前运行的pod实例暴露出去。

$ kubectl expose pod k8s-net-pod --name k8s-net-service --type=NodePort
service "k8s-net-service" exposed
$ kubectl get service
NAME               TYPE        CLUSTER-IP      EXTERNAL-IP   PORT(S)        AGE
k8s-net-service    NodePort    10.98.62.192    <none>        80:30942/TCP   7m

如上，它有一个CLUSTER-IP为10.98.62.192，所以咱们能够在集群内使用10.98.62.192:80来访问该服务，若是是在集群外部，可使用NodeIP:30942(节点所在服务器IP)来访问。

5.2. 使用 servive 描述文件建立

另一种方式就是建立描述文件来建立了，添加k8s-net-service.yaml文件：

apiVersion: v1
kind: Service # 定义Kubernetes资源的类型为Service
metadata:
  name: k8s-net-service # 定义资源的名称
spec:
  selector: # 指定对应的Pod
    app: k8s-net-pod # 指定Pod的标签为k8s-net-pod
  ports:
  - protocol: TCP # 协议类型
    port: 80 # 指定Service访问的端口
    targetPort: 80 # 指定Service转发请求的端口
    nodePort: 30000
  type: NodePort # 指定Service的类型，在这里使用NodePort来对外访问

执行kubectl create -f k8s-net-service.yaml来建立service。

$ kubectl create -f k8s-net-service.yaml
service "k8s-net-service" created
$ kubectl get service
NAME              TYPE        CLUSTER-IP      EXTERNAL-IP   PORT(S)        AGE
k8s-net-service   NodePort    10.98.62.192    <none>        80:30942/TCP   23m
k8s-net-service   NodePort    10.97.110.150   <none>        80:30000/TCP   34s
kubernetes        ClusterIP   10.96.0.1       <none>        443/TCP        1d

6. 试试 k8s 的自由伸缩

是时候来体验下k8s强大的自动伸缩功能了。k8s中经过建立ReplicaSet或Deployment来管理 pod，进而完成自动化扩展和管理。
PS: 也可使用ReplicaController，但推荐使用ReplicaSet，由于其标签匹配功能更强大。

6.1. 运行第一个 ReplicaSet

首先定义 ReplicaSet 描述文件k8s-net-replicaset.yaml：

apiVersion: apps/v1beta2 # rs 的版本号为apps/v1beta2
kind: ReplicaSet # 定义Kubernetes资源的类型为ReplicaSet
metadata:
  name: k8s-net-replicaset # 定义资源的名称
spec:
  replicas: 3 # 指定pod实例的个数
  selector: # pod选择器
    matchLabels: # 指定匹配的标签
      app: k8s-net-pod # 指定Pod的标签为k8s-net-pod
  template: # 建立新的pod模板配置
    metadata:
      labels:
        app: k8s-net-pod # 指定使用哪一个pod
    spec:
      containers:
      - name: k8s-net-replicaset
        image: k8s.net.demo # 指定使用的镜像 
        imagePullPolicy: IfNotPresent # k8s默认值为Always，老是从远端拉取镜像，经过设置IfNotPresent或Never来使用本地镜像

执行如下命令建立 ReplicaSet，并观察自动建立的pod实例。

$ kubectl create -f k8s-net-replicaset.yaml
replicaset.apps "k8s-net-replicaset" created
$ kubectl get rs
NAME                 DESIRED   CURRENT   READY     AGE
k8s-net-replicaset   3         3         3         8s
$ kubectl get pod
NAME                       READY     STATUS    RESTARTS   AGE
k8s-net-pod                1/1       Running   61         12h
k8s-net-replicaset-bxw9c   1/1       Running   0          35s
k8s-net-replicaset-k6kf7   1/1       Running   0          35s
$ kubectl delete po k8s-net-replicaset-bxw9c
pod "k8s-net-replicaset-bxw9c" deleted
$ kubectl get po
NAME                       READY     STATUS        RESTARTS   AGE
k8s-net-pod                1/1       Running       61         12h
k8s-net-replicaset-bxw9c   0/1       Terminating   0          2m
k8s-net-replicaset-k6kf7   1/1       Running       0          2m
k8s-net-replicaset-xvb9l   1/1       Running       0          6s

从上面看到，k8s-net-replicaset以k8s-net-pod为模板建立了额外两个pod副本，当咱们尝试删除其中一个副本后，再次查看pod列表，replicaset会自动帮咱们从新建立一个pod。
那咱们尝试把刚建立的k8s-net-replicaset暴露为Service，看看实际运行是什么效果吧。依次执行如下命令：

$ kubectl expose replicaset k8s-net-replicaset --type=LoadBalancer --port=8091 --target-port=80 --name k8s-net-rs
-service
service "k8s-net-rs-service" exposed
$ kubectl get service
NAME                 TYPE           CLUSTER-IP      EXTERNAL-IP   PORT(S)          AGE
k8s-net-rs-service   LoadBalancer   10.99.134.237   localhost     8091:32641/TCP   8s
k8s-net-service      NodePort       10.104.21.80    <none>        80:30000/TCP     12h
kubernetes           ClusterIP      10.96.0.1       <none>        443/TCP          12h

而后浏览器访问http://localhost:8091/，尝试屡次刷新浏览器，显示效果以下，咱们发现ReplicaSet已帮咱们作好了负载均衡。

假如如今网站访问量剧增，3个实例任然没法有效支撑，能够不中止应用的状况下作到水平伸缩吗？Of course, Yes!
仅需执行kubectl scale命令进行扩展便可。

$ kubectl get pod
NAME                       READY     STATUS    RESTARTS   AGE
k8s-net-replicaset-g4n6g   1/1       Running   0          13m
k8s-net-replicaset-lkrf7   1/1       Running   0          13m
k8s-net-replicaset-tf992   1/1       Running   0          13m
$ kubectl scale replicaset k8s-net-replicaset --replicas=6
replicaset.extensions "k8s-net-replicaset" scaled
$ kubectl get pod
NAME                       READY     STATUS              RESTARTS   AGE
k8s-net-replicaset-cz2bs   0/1       ContainerCreating   0          3s
k8s-net-replicaset-g4n6g   1/1       Running             0          13m
k8s-net-replicaset-lkrf7   1/1       Running             0          13m
k8s-net-replicaset-pjl9m   0/1       ContainerCreating   0          3s
k8s-net-replicaset-qpn2l   0/1       ContainerCreating   0          3s
k8s-net-replicaset-tf992   1/1       Running             0          13m

从以上的输出能够看，咱们一句命令就扩展pod实例到6个，是否是很简单？！

你可能又问了，我如今访问高峰过了，我怎么快速缩放应用呢？啊，和上面同样的，你把--replicas参数改小点就是了，就像这样kubectl scale replicaset k8s-net-replicaset --replicas=3。

7. 最后

本文从使用docker建立image，到使用k8s建立第一个pod，到暴露第一个Service，再到使用ReplicaSet 进行容器伸缩，基本串通了k8s的核心基础概念，从而对k8s有了基础的认知，但愿对你的K8S之路有所帮助。

因为篇幅有限，笔者也是初玩，k8s的不少功能并未一一罗列，那就留着下次分享吧。
若是要问我，k8s有什么好书推荐，首推《Kubernetes In Action》，国内已经有中文版了，翻译的不错！
本文示例代码已上传至GitHub： K8S.NET.Demo。

参考资料
雨夜朦胧 - Kubernetes初探[1]：部署你的第一个ASP.NET Core应用到k8s集群