庐山真面目之九微服务架构 NetCore 基于 Docker 基础镜像和挂载文件部署

庐山真面目之九微服务架构 NetCore 基于 Docker 基础镜像和挂载文件部署

一、简介

     　　我们在上一篇文章《庐山真面目之八微服务架构
NetCore 基于 Dockerfile 文件部署》中介绍了，如何在Linux系统上的Docker容器中部署Net Core项目的第一种方法。当然，有些话忘记说了，今天我们补上。如果大家要想练习我们的例子，大家必须对Linux系统有所了解，对Linux的基础操作命令也要有使用经验，因为我踩了很多坑，伤心啊。在这个基础上，也要对Docker比较熟悉，Docker的操作命令也要比较熟悉，否则，真的就有些困难了。今天作为介绍把Net Core项目部署到Linux系统中的Docker容器中第二种方式，继续我们这个系列。这三种方式要这么详细的交代，是因为，在我以后的文章里，如果再有涉及项目的部署和迁移的话题，就不会写的这么详细了。也希望大家见谅和理解，因为我们每篇文章都要突出文章的主题，而且每篇文章解决一个问题，否则，喧宾夺主就不好了。看过我文章的人会知道，我的文章会有重复的部分，这样做也是为了照顾读者，每篇文章都是独立的，让大家看的清楚和明白，避免在多篇文章之间切换，不是为了凑字数。



　　　　1、说明

    　　　　　　今天这篇文章很简单，就是介绍把Net
Core 项目部署到Linux环境的Docker容器中的第二种方式。当然了，对于高手来说，这些都是微不足道的，但是对于新手或者说刚入门的人来说可能是有帮助的，所以说，高手就不用冷嘲热讽，如果想发表自己的高论，也欢迎不灵赐教。特别说明，这里的所有代码都经过测试，所以大家可以放心使用，但是实际情况可能不一样，结果也未必一样。



　　　　2、开发环境

    　　　　　　以下就是开发环境，不用多说，都很简单，一看就知道。

   　　　　　　（1）、开发工具：Visual
Studio 2019

   　　　　　　（2）、开发语言：C#

   　　　　　　（3）、开发平台：Net
Core3.1，跨平台。

   　　　　　　（4）、操作系统：Linux（CentOS 7）。

   　　　　　　（5）、虚拟容器：Docker
19.03.13

   　　　　　　（6）、文件上传：SSH
Secure File Transfer Client或者XFTP

   　　　　　　（7）、客 户 端：SSH Secure Shell
Client或者XShell

   　　　　　　（8）、虚拟系统：VMware
Workstation Pro 14.1.3

二、Docker容器技术的简介

   

　　　　　　



　　　　1、Docker简介

      　　　　　　Docker 是一个开源的应用容器引擎，让开发者可以打包他们的应用以及依赖包到一个可移植的容器中，然后发布到任何流行的Linux机器或Windows 机器上，也可以实现虚拟化，容器是完全使用沙箱机制，相互之间不会有任何接口。

      　　　　　　Docker是Docker.Lnc公司开源的一个基于LXC技术之上搭建的Container容器引擎，源代码托管在Github上，基于Go语言并遵从Apache2.0协议开源。

      　　　　　　Docker属于Linux容器的一种封装，提供简单易用的容器使用接口。

      　　　　　　Docker将应用程序与该程序的依赖，打包在一个文件里面。运行这个文件，就会生成一个虚拟容器。程序在这个虚拟容器里运行，就好像在真实的物理机上运行一样。有了Docker，就不用担心环境问题。

      　　　　　　总体来说，Docker的接口相当简单，用户可以方便地创建和使用容器，把自己的应用放入容器。容器还可以进行版本管理、复制、分享、修改，就像管理普通的代码一样。

      

       　　　　　　一个完整的Docker有以下几个部分组成：

          　　　　　　Docker Client客户端：可以输入各种命令操作Docker镜像、容器。

          　　　　　　Docker Daemon守护进程：Docker的服务器端，完成客户端的请求和命令。

          　　　　　　Docker Image镜像：镜像就是容器实例的模板，根据该模板生成容器实例。

          　　　　　　Docker Container容器：根据镜像文件生成的容器实例，没有镜像，无法生成容器。



        　　　　　　Docker结构组成：

         　　　　　　



　　　　2、基础命令

    　　　　　　（1）、安装工具包

          　　　　　　　　命令：yum install -y
yum-utils

             

    　　　　　　（2）、设置镜像仓库

          　　　　　　　　命令：阿里云：$ yum-config-manager --add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo

           　　　　　　　　清华大学源：$yum-config-manager --add-repo  https://mirrors.tuna.tsinghua.edu.cn/docker-ce/linux/centos/docker-ce.repo

         

    　　　　　　（3）、安装启动 docker

          　　　　　　　　命令：



    　　　　　　（4）、停止正在运行的容器

          　　　　　　　　命令：docker stop 容器名称/容器ID



    　　　　　　（5）、启动停止的容器：

          　　　　　　　　命令：docker start 容器名称/容器ID



    　　　　　　（6）、查询创建的容器:

         　　　　　　　　 命令：docker-compose ps

             

    　　　　　　（7）、删除指定容器：

         　　　　　　　　 命令：docker rm 容器名称/容器ID



    　　　　　　（8）、删除所有容器：

         　　　　　　　　 命令：docker rm $(docker
ps -aq)



    　　　　　　（9）、查询所有镜像：

          　　　　　　　　命令：docker ps –a



    　　　　　　（10）、删除镜像：

           　　　　　　　　命令：docker rmi 镜像名称/镜像ID



    　　　　　　（11）、删除所有镜像：

           　　　　　　　　命令：docker rmi $(docker images -q)



    　　　　　　（12）、docker-compose命令详细参考：

           　　　　　　　　命令：docker-compose –h



    　　　　　　（13）、停止并删除所有运行的容器实例：

           　　　　　　　　命令：docker stop
$(docker ps -q) & docker rm $(docker ps -aq)



    　　　　　　（14）、查看日志：

           　　　　　　　　命令：docker logs 容器id/容器名称



    　　　　　　（15）、查看统计：

           　　　　　　　　命令：docker stats 容器id/容器名称



    　　　　　　（16）、docker 以别名 形式运行指定镜像

           　　　　　　　　命令：docker run -itd -p
host:container --name 别名
镜像id/镜像名称



    　　　　　   （17）、限制镜像使用的内存
-m：

           　　　　　　　　命令：docker run -itd -p
hostPort:containerPort --name 别名 -m 200m 镜像id/镜像名称

          

    　　　　　　（18）、限制镜像使用的 cpu
数目 --cpus。：

           　　　　　　　　命令：docker run -itd -p
hostPort:containerPort --name 别名 --cpus 1 镜像id/镜像名称



    　　　　　　（19）、进入指定的容器

           　　　　　　　　命令：$Docker exec -it 容器ID|容器名称
/bin/bash



          　　　　　　　　

三、Docker容器和虚拟机的区别

      　　　　我在这里只是简单的介绍一下Docker容器和虚拟机的区别，给大家一个感性的认识，如果大家想去了解更详细的内容，自己去网上学习吧，内容很多，比我写的要好很多。技术来源于生活，又高于生活，所以，我们学习的技术，是可以和生活的一些事物做类比的。就拿虚拟技术来说，它的发展历程，和我们居住条件的发展有些类似。



　　　　1、虚拟技术发展史



    　　　　　　（1）、单独物理机【独栋别墅】

           　　　　　　　　

           　　　　　　　　有钱人就住自己的大别墅，有自己的草坪，独立的花园，漂亮的游泳池，当然，还有很多根本没时间住的房间，对于个人来说，当然很舒服，也是我们每个人向往的生活。但是，对于土地资源来说，利用率不高。对于网络环境来说，也是同样的道理。刚开始的时候，人们的系统都是部署在自己购买的独立的物理机中，这样的物理机有着一套完整的操作系统，安全系统，网络环境，还有很多用不到的功能，什么都有自己的独立的一套，完全没有重用的概念。每套系统就对应着这么一套完整的东西，包括硬件、软件和网络等资源，大系统是这样，小系统也是这样，这样下去肯定不行。



    　　　　　　（2）、虚拟机时代【高楼社区】

           　　　　　　　　

           　　　　　　　　虚拟技术发展的第二阶段就是虚拟机时代，这个时代，就和我们居住的社区一样，人们通过在城市买房子居住在高档社区里，这个时候比第一个阶段要好很多，可以共享很多，比如：门禁、保安、地基、物业等公共服务。但是，每个家庭还是一个独立的单元，有自己独立的卫生间，独立卧室，厨房、餐厅和网络等。这个时代的网络环境、服务器技术得到了高速发展，人们开始注意资源的利用率。虚拟机的技术也得到了很好的发展和使用，我们可以在一台大型机器上部署多台虚拟机，这个大型机器，就像我们居住的小区楼房，这样一来，提高了资源利用率，可以共用硬件、网络和其他一些基础设施，但是每个虚拟机内部还有一套完整的操作系统，服务组件等，这个时候的虚拟机使用起来，感觉和使用物理机的差别不大。



    　　　　　　（3）、Docker容器【胶囊公寓】

          　　　　　　　　

          　　　　　　　　虚拟技术发展的第三个阶段就是极简模式，也可以叫“胶囊公寓”模式。胶囊公寓这种居住方式在寸土寸金的大城市，比如：日本的东京，我国的香港还挺普遍的。在这样的公寓里，只提供一个人休息、睡觉的最基本的地方和功能，其他多余的功能一概没有，那个时候除了床、被子和灯光是你可以控制的，其他都是公用的。Docker容器技术就是这个时代的产物，为了提高资源的利用率，开始对虚拟机进行瘦身，进而诞生了容器技术，容器内部不在包含完整的操作系统，是一个极简版本的操作系统，能运行软件所必须的系统环境，除了精简的系统外，就是程序运行所依赖的必须环境，再者就是要部署的程序了。



　　　　2、二者区别，看图理解吧！

        
　　　　　　     

         　　　　虚拟机就是我们社区的高楼，容器就是“胶囊公寓”

         　　　     　



　　　　3、容器能给我们带来什么呢？

       

　　　　　　　　

四、Net Core项目基于Docker 容器的部署方式



     　　今天，我们就开始介绍将Net Core项目部署到Linux系统上的Docker容器中的第二种方法。开始之前，说明一下，因为我们今天要将系统部署到Docker容器里，所以，在开始之前，必须安装好了Docker容器，我当前安装的版本是：19.03.13，如果你登录了Linux系统（CentOS7）,可以通过输入命令：Docker --version检查是否安装了Docker，如果没有安装，提示：没有这个命令（command not found），如果安装了，会显示具体的版本号：Docker version 19.03.13,build 4484c46d9d。还要说明一点，Docker的版本尽量要最新，最起码要在18或者以上，否则会出现一些问题，我就是遇到了问题，最后升级后才解决的，如果想升级自己的Docker，可以查看《如何将Docker升级到最新版本》。
 

　　　　今天我们开始创建项目镜像和挂载文件，开始之前，我们先创建测试项目。



　　　　1、搭建测试项目。



       　　　　　　（1）、PatrickLiu.MicroService.Interfaces（NetCore类库项目），定义抽象接口层，代码很简单，因为它不是重点，重点是框架。

              

                   　　　　　　

　　　　　　　　　　　　

                   

              　　　　　　　　样例代码：

 1 using PatrickLiu.MicroService.Models;
 2 using System.Collections.Generic;
 3
 4 namespace PatrickLiu.MicroService.Interfaces
 5 {
 6     /// <summary>
 7     /// 用户服务的接口定义。
 8     /// </summary>
 9     public interface IUserService
10     {
11         /// <summary>
12         /// 查找指定主键的用户实例对象。
13         /// </summary>
14         /// <param name="id">用户的主键。</param>
15         /// <returns>返回查找到的用户实例对象。</returns>
16         User FindUser(int id);
17
18         /// <summary>
19         /// 获取所有用户的实例集合。
20         /// </summary>
21         /// <returns>返回所有的用户实例。</returns>
22         IEnumerable<User> UserAll();
23     }
24 }

　　　　　　（2）、PatrickLiu.MicroService.Models（NetCore类库项目），定义用于传递数据的实体模型，代码很简单，因为它不是重点，重点是框架。

              

　　　　　　　　　　　　

　　　　　　　　　　　　



               　　　　　　　　样例代码：

 1 using System;
 2
 3 namespace PatrickLiu.MicroService.Models
 4 {
 5     /// <summary>
 6     /// 用户模型。
 7     /// </summary>
 8     public class User
 9     {
10         /// <summary>
11         /// 获取或者设置用户主键。
12         /// </summary>
13         public int ID { get; set; }
14
15         /// <summary>
16         /// 获取或者设置用户姓名。
17         /// </summary>
18         public string Name { get; set; }
19
20         /// <summary>
21         /// 获取或者设置用户账号名称。
22         /// </summary>
23         public string Account { get; set; }
24
25         /// <summary>
26         /// 获取或者设置用户密码。
27         /// </summary>
28         public string Password { get; set; }
29
30         /// <summary>
31         /// 获取或者设置用户的电子邮箱地址。
32         /// </summary>
33         public string Email { get; set; }
34
35         /// <summary>
36         /// 获取或者设置用户角色。
37         /// </summary>
38         public string Role { get; set; }
39
40         /// <summary>
41         /// 获取或者设置用户的登录时间。
42         /// </summary>
43         public DateTime LoginTime { get; set; }
44     }
45 }

　　　　　　（3）、PatrickLiu.MicroService.Services（NetCore类库项目），定义实现接口的服务层，代码很简单，因为它不是重点，重点是框架。

             

　　　　　　　　　　　　

　　　　　　　　　　　　           



              　　　　　　　　样例代码：

 1 using PatrickLiu.MicroService.Interfaces;
 2 using PatrickLiu.MicroService.Models;
 3 using System;
 4 using System.Collections.Generic;
 5 using System.Linq;
 6
 7 namespace PatrickLiu.MicroService.Services
 8 {
 9     /// <summary>
10     /// 实现用户服务接口的实现类型。
11     /// </summary>
12     public class UserService : IUserService
13     {
14         private IList<User> dataList;
15
16         /// <summary>
17         /// 初始化类型的实例
18         /// </summary>
19         public UserService()
20         {
21             dataList = new List<User>()
22             { new User {ID=1,Name="黄飞鸿",Account="HuangFeiHong",Password="HuangFeiHong123456",Email="huangFeiHong@sina.com", Role="Admin", LoginTime=DateTime.Now },
23             new User {ID=2,Name="洪熙官",Account="HongXiGuan",Password="HongXiGuan54667",Email="HongXiGuan@sina.com", Role="Admin", LoginTime=DateTime.Now.AddDays(-5) },
24             new User {ID=3,Name="方世玉",Account="FangShiYu",Password="FangShiYu112233",Email="fangShiYu@163.com", Role="Admin", LoginTime=DateTime.Now.AddDays(-30) },
25             new User {ID=4,Name="苗翠花",Account="MiaoCuiHua",Password="MiaoCuiHua887766",Email="miaoCuiHua@sohu.com", Role="Admin", LoginTime=DateTime.Now.AddDays(-90) },
26             new User {ID=5,Name="严咏春",Account="YanYongChun",Password="YanYongChun09392",Email="yanYongChun@263.com", Role="Admin", LoginTime=DateTime.Now.AddMinutes(-50) }};
27         }
28
29         /// <summary>
30         /// 查找指定主键的用户实例对象。
31         /// </summary>
32         /// <param name="id">用户的主键。</param>
33         /// <returns>返回查找到的用户实例对象。</returns>
34         public User FindUser(int id)
35         {
36             return dataList.FirstOrDefault(user => user.ID == id);
37         }
38
39         /// <summary>
40         /// 获取所有用户的实例集合。
41         /// </summary>
42         /// <returns>返回所有的用户实例。</returns>
43         public IEnumerable<User> UserAll()
44         {
45             return dataList;
46         }
47     }
48 }

　　　　　　（4）、PatrickLiu.MicroService.ServiceInstance（Asp.Net Core
WebAPI项目），对外提供业务功能WebApi项目，该项目必须引入其他关联项目：

                   　　　　　　PatrickLiu.MicroService.Interfaces

                   　　　　　　PatrickLiu.MicroService.Models

                   　　　　　　PatrickLiu.MicroService.Services



                   　　　　　　

    

                   　　　　　　样例代码：

                   　　　　　　

  1 using System;
  2 using System.Collections.Generic;
  3 using System.Linq;
  4 using System.Threading;
  5 using Microsoft.AspNetCore.Authorization;
  6 using Microsoft.AspNetCore.Mvc;
  7 using Microsoft.Extensions.Configuration;
  8 using Microsoft.Extensions.Logging;
  9 using PatrickLiu.MicroService.Interfaces;
 10 using PatrickLiu.MicroService.Models;
 11
 12 namespace PatrickLiu.MicroService.ServiceInstance.Controllers
 13 {
 14     /// <summary>
 15     /// 用户的 API 类型。
 16     /// </summary>
 17     [Route("api/[controller]")]
 18     [ApiController]
 19     public class UsersController : ControllerBase
 20     {
 21         #region 私有字段
 22
 23         private readonly ILogger<UsersController> _logger;
 24         private readonly IUserService _userService;
 25         private IConfiguration _configuration;
 26
 27         #endregion
 28
 29         #region 构造函数
 30
 31         /// <summary>
 32         /// 初始化该类型的新实例。
 33         /// </summary>
 34         /// <param name="logger">日志记录器。</param>
 35         /// <param name="userService">用户服务接口。</param>
 36         /// <param name="configuration">配置服务。</param>
 37         public UsersController(ILogger<UsersController> logger, IUserService userService, IConfiguration configuration)
 38         {
 39             _logger = logger;
 40             _userService = userService;
 41             _configuration = configuration;
 42         }
 43
 44         #endregion
 45
 46         #region 实例方法
 47
 48         /// <summary>
 49         /// 获取一条记录
 50         /// </summary>
 51         /// <param name="id"></param>
 52         /// <returns></returns>
 53         [HttpGet]
 54         [Route("Get")]
 55         public User Get(int id)
 56         {
 57             return _userService.FindUser(id);
 58         }
 59
 60         /// <summary>
 61         /// 获取所有记录。
 62         /// </summary>
 63         /// <returns></returns>
 64         [HttpGet]
 65         [Route("All")]
 66         //[Authorize]
 67         public IEnumerable<User> Get()
 68         {
 69             Console.WriteLine($"This is UsersController {this._configuration["port"]} Invoke");
 70
 71             return this._userService.UserAll().Select((user => new User
 72             {
 73                 ID = user.ID,
 74                 Name = user.Name,
 75                 Account = user.Account,
 76                 Password = user.Password,
 77                 Email = user.Email,
 78                 Role = $"{this._configuration["ip"]}：{this._configuration["port"]}",
 79                 LoginTime = user.LoginTime
 80             })); ;
 81         }
 82
 83         /// <summary>
 84         /// 超时处理
 85         /// </summary>
 86         /// <returns></returns>
 87         [HttpGet]
 88         [Route("Timeout")]
 89         public IEnumerable<User> Timeout()
 90         {
 91             Console.WriteLine($"This is Timeout Start");
 92             //超时设置。
 93             Thread.Sleep(3000);
 94
 95             Console.WriteLine($"This is Timeout End");
 96
 97             return this._userService.UserAll().Select((user => new User
 98             {
 99                 ID = user.ID,
100                 Name = user.Name,
101                 Account = user.Account,
102                 Password = user.Password,
103                 Email = user.Email,
104                 Role = $"{this._configuration["ip"]}：{this._configuration["port"]}",
105                 LoginTime = user.LoginTime
106             })); ;
107         }
108
109         #endregion
110     }
111 }

1         /// <summary>
2         /// 配置注入容器的实例。
3         /// </summary>
4         /// <param name="services"></param>
5         public void ConfigureServices(IServiceCollection services)
6         {
7             services.AddSingleton<IUserService, UserService>();
8         }    

　　　　　　Program.cs

1         public static void Main(string[] args)
2         {
3             new ConfigurationBuilder()
4                 .SetBasePath(Directory.GetCurrentDirectory())
5                 .AddCommandLine(args)//支持命令行
6                 .Build();
7
8             CreateHostBuilder(args).Build().Run();
9         }        

　　　　2、发布项目。

       　　　　　　我们为了将Net Core项目部署到Linux（CentOS7）环境的Docker容器中去，先要发布我们的项目：PatrickLiu.MicroService.ServiceInstance，因此，我们就要在该项目上点击鼠标右键选择菜单【发布】。



        　　　　　　 （1）、开始发布项目。

               　　　　　　　　

         　　　　　　（2）、项目发布成功


              　　　　　　　　



        　　　　　　 （3）、发布后的项目文件。


                    　　　　 　　



　　　　3、生成Docker镜像文件。

       　　　　　　（1）、拷贝文件

              　　　　　　　　项目文件必须发布成功，然后将发布成功的程序文件拷贝的Linux服务器上。

　　　　　　　　　　　　

              　　　　　　　　服务器路径：/root/testProject/second

　　　　　　　　　　　　

             

             　　　　 　　　　Linux（CentOS7）服务器上的文件目录结构。

              　　　　　　　　



       　　　　　　（2）、查看Linux服务器上的文件结构。

              　　　　　　　　命令：ls –a

             

　　　　　　　　　　　　



　　　　4、生成容器实例。

      　　　　　　我们可以直接生成容器实例了。

       　　　　　　命令：docker run -d -p
8083:80 -v /root/testProject/second:/app 
--workdir /app mcr.microsoft.com/dotnet/core/aspnet dotnet  /app/PatrickLiu.MicroService.ServiceInstance.dll

         　　　　　　



　　　　5、通过命令测试容器是否正常运行。

      　　　　　　命令：Docker ps –a



        　　　　　　



　　　　6、通过浏览器访问来测试。

      　　　　　　容器启动正常，那我们就可以通过浏览器访问看看，我们先获取我们的地址。

       　　　　　　命令：ifconfig



         　　　　　　



       　　　　　　有了地址，我们访问：http://192.168.127.141:8083/api/users/all



       　　　　　　　　

五、结束语

    　　　　好了，今天就写到这里了。这个系列整理起来还是很费劲的，因为每个环节都要测试到，保证所写的代码都在测试环境中能运行的，但是累并快乐着。正所谓，不积跬步，无以至千里，每天进步一点点，加油。