.Net Core in Docker极简入门(上篇)

  • A+
所属分类:.NET技术
摘要

目录前言开始环境准备Docker基础概念Docker基础命令Docker命令实践构建Docker镜像Dockerfilebulid & run

前言

Docker 是一个开源的应用容器引擎,它十分火热,如今几乎成为了后端开发人员必须掌握的一项技能。即使你在生产环境中可能用不上它,就算把它当作一个辅助开发的工具来使用,也是非常方便的。本文就介绍一下.Net Core应用在Docker中的一些基本使用。

开始

环境准备

首先安装docker,去官网下载:https://www.docker.com/get-started

windows系统的话,默认win10(较新的版本更好,可以用wsl)。win7只能用Docker Toolbox,bug非常多,不建议使用。。。

windows/mac 直接下载对应的文件安装就可以(本文的系统环境是win10 2004版本。),linux可以通过命令来安装。关于安装,网上已经有很多资料了,就不多介绍。只是安装后有2个必要的设置需要注意一下:

  1. 镜像加速有很多提供免费加速服务的网站,可以自行搜索,我这里用的是阿里云。这个国内网络必须配置,不然镜像几乎拉取不下来。

.Net Core in Docker极简入门(上篇)

  1. 镜像储存路径

默认docker的运行文件是在C盘,C盘空间不够的话,可以设置到别的盘。

新版本的windows Docker Desktop默认使用wsl运行:

.Net Core in Docker极简入门(上篇)

这个设置比较麻烦,具体可以参考我之前的一篇:win10使用WSL 2运行Docker Desktop,运行文件从C盘迁移到其他目录。如果是老版本Hyper-V启动的话,界面上设置就可以。

Docker基础概念

docker中最重要的2个概念就是“镜像”和“容器”。

  • 镜像:

镜像(Image)就是一堆只读层(read-only layer)的统一视角。

  • 容器:

容器(container)的定义和镜像(image)几乎一模一样,也是一堆层的统一视角,唯一区别在于容器的最上面那一层是可读可写的。

要理解docker镜像和docker容器之间的区别,确实不容易。

想象一下,我们开发的一个asp.net mvc应用,使用Visual Studio将它发布出来后,会得到一堆发布后的文件,包含dll,cshtml,css,js,静态资源文件等等。那么这堆文件就类似于一个镜像,镜像是无法直接运行的。当我们把这堆文件挂载到IIS的一个站点上,就可以运行了,也能被外界访问了,这个IIS站点就类似是一个容器。容器相当于是镜像的一个运行实例,需要注意的是,容器的所有读写操作都只是针对容器的文件系统,并不会影响到镜像。一个镜像可以运行多个容器,容器之间是相互隔离的。

Docker基础命令

  • 镜像相关:

docker images:列出所有本地镜像。

docker rmi 镜像...|镜像ID...:删除本地镜像,可以同时指定多个。

docker build -t myimage:1.1 .:基于Dockerfile构建一个名为myimage,tag为1.1的镜像,结尾的 . 代表当前目录。

docker pull mcr.microsoft.com/mssql/server:2019-CU5-ubuntu-18.04:从微软镜像仓库中拉取tag为2019-CU5-ubuntu-18.04的sqlserver 2019镜像。

......

  • 容器相关:

docker ps:列出运行中的容器。

docker ps -a:列出所有的容器,包含未运行的。

docker run -it --rm -p 8080:80 --name mynginx nginx:使用镜像nginx创建并启动一个名为mynginx的容器;-it代表以交互模式启动,并为容器重新分配一个伪输入终端;-p指定端口映射,将容器的80端口映射到主机的8080端口;--rm代表容器停止时自动删除容器。

docker run -d -p 8080:80 -v /nginx/data:/data --name mynginx nginx:latest:使用镜像nginx(tag为latest)创建并启动一个名为mynginx的容器;-d代表以后台模式启动;-p指定端口映射,将容器的80端口映射到主机的8080端口;-v代表挂载卷,将主机的/nginx/data目录挂载到容器的 /data目录。

docker run -e "ACCEPT_EULA=Y" -e "SA_PASSWORD=<YourStrong@Passw0rd>" -d -p 1433:1433 --name sqlserver2019 mcr.microsoft.com/mssql/server:2019-CU5-ubuntu-18.04:使用sqlserver镜像(tag为2019-CU5-ubuntu-18.04)创建并启动一个名为sqlserver2019的容器;-d代表以后台模式启动;-p指定端口映射,将容器的1433端口映射到主机的1433端口;-e是指定环境变量。

docker start/stop/restart 容器名...|容器ID...:分别是启动,停止,重启容器,可以同时指定多个。

docker rm 容器名...|容器ID... :删除容器,可以同时指定多个。

docker logs 容器名|容器ID:查看容器日志。

......

Docker命令实践

下面在docker中使用sqlserver2019镜像启动一个容器。

  1. 拉取镜像:

docker pull mcr.microsoft.com/mssql/server:2019-CU5-ubuntu-18.04

.Net Core in Docker极简入门(上篇)

注意,mcr.microsoft.com是微软的镜像源,国内访问会比较慢。。。

  1. 启动容器:

docker run -e "ACCEPT_EULA=Y" -e "SA_PASSWORD=Password@2020" -d -p 1433:1433 --name sqlserver2019 mcr.microsoft.com/mssql/server:2019-CU5-ubuntu-18.04

.Net Core in Docker极简入门(上篇)

  1. 连接测试

使用可视化工具连接数据库测试,工具有很多,我这里使用的是SQL Server Management(也可以直接在docker中使用命令进入容器连接数据库测试)。

使用账号sa/Password@2020连接。服务器名称localhost,1433这个1433也可以省略,默认端口就是1433。

.Net Core in Docker极简入门(上篇)

.Net Core in Docker极简入门(上篇)

测试连接成功。以上通过2个命令即可得到一个sqlserver2019数据库,是不是比直接安装到电脑上要方便很多呢。类似的很多开发环境都可以这么搭建,比如mysql,postgres,redis,mongodb,rabbitmq等等,各种工具随便折腾,玩坏了大不了删除容器,重新再来。。。

构建Docker镜像

下面使用docker构建一个asp.net core web应用的镜像。

首先使用vs2019新建一个asp.net core web应用程序,选择web api作为项目模板。

Dockerfile

右键项目-添加-Docker支持,目标OS选择Linux。

.Net Core in Docker极简入门(上篇)

.Net Core in Docker极简入门(上篇)

.Net Core in Docker极简入门(上篇)

添加docker支持后,vs2019会自动帮我们创建Dockerfile文件。Dockerfile就是用来构建镜像的文件,其中包含了各种指令。以下是Dockerfile指令详解:

#使用asp.net core 3.1作为基础镜像,起一个别名为base FROM mcr.microsoft.com/dotnet/core/aspnet:3.1-buster-slim AS base #设置容器的工作目录为/app WORKDIR /app #暴露80端口 EXPOSE 80  #使用.net core sdk 3.1作为基础镜像,起一个别名为build FROM mcr.microsoft.com/dotnet/core/sdk:3.1-buster AS build #设置容器的工作目录为/src WORKDIR /src #拷贝WebApplication1/WebApplication1.csproj项目文件到容器中的/src/WebApplication1/目录 COPY ["WebApplication1/WebApplication1.csproj", "WebApplication1/"] #执行dotnet restore命令,相当于平时用vs还原nuget包 RUN dotnet restore "WebApplication1/WebApplication1.csproj" #拷贝当前目录的文件到到容器的/src目录 COPY . . #设置容器的工作目录为/src/WebApplication1 WORKDIR "/src/WebApplication1" #执行dotnet build命令,相当于平时用vs生成项目。以Release模式生成到容器的/app/build目录 RUN dotnet build "WebApplication1.csproj" -c Release -o /app/build  #将上面的build(.net core sdk 3.1)作为基础镜像,又重命名为publish FROM build AS publish #执行dotnet publish命令,相当于平时用vs发布项目。以Release模式发布到容器的/app/publish目录 RUN dotnet publish "WebApplication1.csproj" -c Release -o /app/publish  #将上面的base(asp.net core 3.1)作为基础镜像,又重命名为final FROM base AS final #设置容器的工作目录为/app WORKDIR /app #拷贝/app/publish目录到当前工作目录 COPY --from=publish /app/publish . #指定容器入口命令,容器启动时会运行dotnet WebApplication1.dll ENTRYPOINT ["dotnet", "WebApplication1.dll"] 

内容挺长,实际上做的事情主要就是通过.net core cli命令来定义了一系列打包发布运行的过程。

bulid & run

来到项目根目录,启动PowerShell或cmd执行docker命令。

.Net Core in Docker极简入门(上篇)

构建镜像:docker build -t webapp1 -f ./WebApplication1/Dockerfile .参数-f是指定Dockerfile所在的目录。

.Net Core in Docker极简入门(上篇)

使用docker images查看本地镜像,webapp1就是上面构建完成的镜像:

.Net Core in Docker极简入门(上篇)

启动容器:docker run -d -p 5000:80 --name web1 webapp1

.Net Core in Docker极简入门(上篇)

使用docker ps查看运行中的容器:

.Net Core in Docker极简入门(上篇)

浏览器访问:http://localhost:5000/weatherforecast

.Net Core in Docker极简入门(上篇)

至此,一个简单的asp.net core web应用就成功运行于docker之中。

其实vs2019本身对docker支持就非常好,以上操作直接可以在vs2019中完成,无需手动执行docker命令。

将项目设置为Docker启动:

.Net Core in Docker极简入门(上篇)

Ctrl+F5即可启动:

.Net Core in Docker极简入门(上篇)

注意,这里容器工具首次加载会比较慢。。。启动完成后会自动打开浏览器,并绑定了一个随机端口:

.Net Core in Docker极简入门(上篇)

这就是vs2019自动帮我们创建的容器:

.Net Core in Docker极简入门(上篇)

查看vs2019中容器工具的输出日志,可以看到vs2019执行的指令内容。


本篇先写到这里。