查看原文
其他

Docker 结合.NET Core 初步使用

DotNet 2021-09-23

(给DotNet加星标,提升.Net技能

转自:跳跃的键盘手
cnblogs.com/chenxf1117/p/13853651.html

前言


Docker是一项比较流行的容器化技术,可以让开发者将应用以及应用依赖的环境,依赖包一起打包到容器中,然后部署容器到生产环境就可以了,解决了应用程序部署到不同服务器环境带来的问题(很多开发人员都遇到过应用程序在自己本地服务器跑的好好的,部署到生产环境就运行不起来,各种奇葩的异常),实现了"一次构建,处处运行"。


官方为我们提供了针对不同系统的Docker版本,今天我们基于windows系统简单介绍下如何使用。


Windows部署Docker


目前官方发布的Docker桌面版,仅支持Windows 10 64-bit: Pro, Enterprise(企业版), Education(教育版),其他windows操作系统版本使用Docker需借助官方发布的Docker ToolBox工具。


1、首先,我们到Git上下载Docker 


ToolBox(https://github.com/docker/toolbox/releases)


注意点:


  • 需要windows 7及以上的64位操作系统   


  • 系统上的虚拟化(Hyper-V )功能启用


2、下载完成之后,直接双击启动DockerToolbox-19.03.1.exe 安装程序。


按着指示往下执行即可



3、安装成功之后桌面上会出现如下三个图标:



  • Docker QuickStart shell - 这是一个已经配置好Docker的命令行环境,启动docker。


  • Oracle VM Virtualbox - 虚拟机,windows系统模拟了一个linux虚拟环境


  • Kitematic - 这是 Docker 的 GUI 版本,相较于以前的敲命令行,操作简单了。


4、启动docker


双击桌面上的Docker QuickStart shell的快捷方式,程序窗口显示出“鲸鱼”就表示启动成功了。



这里我们会看到启动成功后,提供给我们一个IP地址:192.168.99.100。大家这里需要注意,后面我会具体描述下。


Docker基础使用


1、Image文件


Docker容器将应用程序及其依赖,打包到image文件中。然后,通过image文件来生成Docker容器,image文件可以当做是容器的模板,一个image文件可以生成多个同时运行容器。


image操作:


1.列出所有image
$ docker image ls<br data-filtered="filtered">

2.从仓库拉取可用的image
$ docker image pull (image文件地址)<br data-filtered="filtered">

3.image文件删除
$ docker image rmi (image文件ID)


我们可以自己制作image文件,也可以直接从仓库拉取别人上传的image文件。


Docker Hub为我们提供了image文件的上传和下载,实现了文件的共用。


2、容器Container


 前面我们提到Docker容器是依靠image文件生成的,但是Docker容器生成后确是区别于image文件存在的。需要通过关键字“container”对容器进行操作。


# 列出正在运行的容器
$ docker container ls

# 列出所有容器,包括终止运行的容器
$ docker container ls --all

#终止容器运行
$ docker container kill (容器ID)

#删除容器
$ docker container rm (容器ID)


这里我们需要注意下,在删除image文件时如果存在依赖image文件生成的容器,我们需先删除容器才能删除image文件。


3、Dockerfile文件


前面我们介绍了image文件和容器文件,那么image文件和容器具体是怎么生成的呢?实际项目中,image文件的生成需要依赖dockerfilew文件(一个不带后缀的文本文件),大家可以把dockerfile理解成是生成image文件的一个配置文件,我们这里简单介绍几个常用的配置节点:


  • FROM:配置一个基础镜像,也就是后面你要生成的镜像是基于此基础来的。


  • WORKDIR:指定image文件的工作目录


  • COPY:格式:copy [源地址] [目标地址],将源地址文件拷贝到image文件中的目标地址。


  • EXPOSE:暴露出容器对外的端口


  • ENTRYPOINT:容器运行后默认执行的cmd命令。


样例:


FROM microsoft/dotnet:2.2-aspnetcore-runtime

WORKDIR /app
#指定工作目录为/app

COPY . .
#.表示当前目录 将当前命令行执行程序所在目录文件都拷贝到image文件的当前工作目录下

EXPOSE 7000
#容器对外暴露7000端口

ENTRYPOINT ["dotnet", "NetCoreSqlSugar.dll"]
#容器生成后,默认执行cmd命令:dotnet NetCoreSqlSugar.dll


4、生成image文件和容器


有了dockerfile文件之后,我们就可以通过如下cmd命令生成image文件和容器。


1、首先cmd定位到dockerfile所在文件目录。



2、生成image文件


$ docker image build -t myimage .


  • -t 参数:指定image文件名称。


  • myimage是文件名称。


  • "."最后还有个符号,千万不要忘记,这里表示的是dockerfile文件的路径。



成成功之后,我们通过命令 docker image ls  可以看到image文件已存在了。


3、生成容器


$ docker container run -p 8001:7000 -it -d myimage


  • -p参数:容器的 7000 端口映射到宿主机的 8001 端口。


  • -it参数:容器的 Shell 映射到当前的 Shell,然后你在本机窗口输入的命令,就会传入容器。


  • myimage:image 文件的名字(如果有标签,还需要提供标签,默认是 latest 标签)。


  • -d参数:容器启动后,后台运行。


容器生成之后,我们通过命令 docker container ls  可以看到正在运行的容器。


.NET Core WebApi部署docker


好了,前面我们简单了介绍了一些Docker的一些简单入门,下面我们结合.NET Core Webapi应用程序具体给大家说一说实际项目中如何使用Docker。


1、新建一个.NET Core WebApi项目,并启用docker支持。



如果创建的项目忘记启用docker,也不用担心,我们可以右键项目,添加-->docker支持。


2、修改dockerfile文件,如下:


FROM microsoft/dotnet:2.2-aspnetcore-runtime
WORKDIR /app
COPY . .
EXPOSE 7000
ENTRYPOINT ["dotnet", "NetCoreSqlSugar.dll"]


dockerfile文件右键--属性,选择始终复制,可以直接发布到目录。



3、修改应用程序端口号(Program.cs文件)


public static IWebHostBuilder CreateWebHostBuilder(string[] args) =>
WebHost.CreateDefaultBuilder(args)
.UseUrls("http://*:7000")
.UseStartup<Startup>();


我这里用了最简单的方式UseUrls方法定义了端口号,实际项目中并不推荐大家这么使用。偷懒了。。。哈哈


4、发布项目


发布应用程序到执行目录,我们会发现发布目录多了一个dockerfile文件。


5、生成image文件和容器


#生成image文件
$ docker image build -t myimage .

#创建容器并运行
$ docker container run -p 8001:7000 -it -d myimage


到了这里,基本上我们任务都完成了。


但是使用windows的同学会发现当我们使用http://localhost:8001/api/Values访问API应用程序模板接口时,并不可行,那么问题来了???


这里我们回到docker启动,docker启动成功之后会提供我们一个IP地址:192.168.99.100。那么这个IP到底是干什么用的呢?


我们知道Docker是运行在Linux上的,在Windows中运行docker,实际上还是在Windows下先安装了一个Linux虚拟环境,然后再运行的docker。


也就是说,应用程序中使用的localhost指的是这个Linux环境的地址,而不是我们的宿主环境Windows。这下大家也就恍然大悟了。


我们在浏览器输入:http://192.168.99.100:8001/api/Values 果然可以正常访问。


Nginx实现局域网访问


上面我们在本地虽然可以通过192.168.99.100这个IP访问容器中的API接口,但是并不能被其他同事访问。


前端时间刚好接触了Nginx,于是,这里果断搬了出来,通过Nginx的"反向代理"来解决这个问题。至于为什么选择这种方式,其实也是自己想重温下Nginx的使用,小小自私一下。关于Nginx的使用我这里就不赘述了,感兴趣的同学可以去了解下。


Nginx配置


upstream serlist{
server 192.168.99.100:8001;#实际请求地址
}
server {
listen 8001;
server_name 192.168.60.4;#本机地址
#charset koi8-r;
#access_log logs/host.access.log main;
location ~ {
proxy_pass http://serlist;
proxy_connect_timeout 10; #连接超时 默认为60秒
proxy_send_timeout 10; #读取超时 默认为60秒
proxy_read_timeout 10; #发送超时 默认为60秒
}
}


有了如上配置之后,局域网内的同事就可以通过我Windows下的本机地址192.168.60.4:8001直接访问我本机容器内的接口了,方便了大家调试调用。


- EOF -


推荐阅读  点击标题可跳转

打造跨平台.NET Core后台服务

C# 9.0 新特性预览 - init-only 属性.NET Core 微服务快速开发框架 Viper 限流


看完本文有收获?请转发分享给更多人

关注「DotNet」加星标,提升.Net技能 

好文章,我在看❤️

: . Video Mini Program Like ,轻点两下取消赞 Wow ,轻点两下取消在看

您可能也对以下帖子感兴趣

文章有问题?点此查看未经处理的缓存