一.介绍
本篇完整介绍asp.net core web api如何部署到docker容器中,并通过外部访问web api服务。在编写完成dockerfile之后,可以通过docker [image] build命令来创建镜像。
基本的格式为:docker build [options] path | url | -
该命令将读取指定路径(包括子目录)的dickerfile,并将该路径下所有数据作为上下文发送给docker服务端。docker服务端在校验dockerfile格式通过后,啄条执行其中定义的指令,碰到ADD, COPY 和RUN指令会生成一层新的镜像。最终如果创建镜像成功,会返回最终镜像的ID。
1. dockerfile文件创建
创建asp.net core web api应用程序,项目名为:k8swebapi。 dockerfile如下所示:
FROM mcr.microsoft.com/dotnet/core/aspnet:2.2 AS runtime
WORKDIR /app
EXPOSE 5000
COPY . .
ENTRYPOINT ["dotnet", "k8swebapi.dll", "--urls", "http://*:5000;http://*:5001"]
2.上传
asp.net core web api 发布后,上传到云服务器opt目录下
[root@VM_0_12_centos opt]# ls
containerd kubectl-1.17.3-0.x86_64.rpm rh webapipublish
定位到webapipublish目录下,查看刚上传的web文件
[root@VM_0_12_centos opt]# cd webapipublish
[root@VM_0_12_centos webapipublish]# ls
appsettings.Development.json Microsoft.OpenApi.dll
appsettings.json Swashbuckle.AspNetCore.Swagger.dll
dll Swashbuckle.AspNetCore.SwaggerGen.dll
Dockerfile Swashbuckle.AspNetCore.SwaggerUI.dll
k8swebapi.deps.json System.Runtime.CompilerServices.Unsafe.dll
k8swebapi.dll System.Text.Encodings.Web.dll
k8swebapi.pdb System.Text.Json.dll
k8swebapi.runtimeconfig.json web.config
k8swebapi.Views.dll wwwroot
k8swebapi.Views.pdb YLYUN.Common.Dapper.dll
Microsoft.AspNetCore.Mvc.Versioning.ApiExplorer.dll YLYUN.Common.Dapper.pdb
Microsoft.AspNetCore.Mvc.Versioning.dll YLYUN.Common.Dapper.xml
Microsoft.Bcl.AsyncInterfaces.dll
3.构建镜像
执行格式:docker build -t <要生成的镜像的名称> .
k8swebapi为镜像的名称
结尾的 . 指dockerfile路径(.是代表上下文路径,因为dockerfile就在当前目录下)
[root@VM_0_12_centos webapipublish]# docker build -t k8swebapi .
Sending build context to Docker daemon 7.513MB
Step 1/5 : FROM mcr.microsoft.com/dotnet/core/aspnet:2.2 AS runtime
---> e7e3b238011c
Step 2/5 : WORKDIR /app
---> Running in f6496d30d085
Removing intermediate container f6496d30d085
---> 5657f984ae35
Step 3/5 : EXPOSE 5000
---> Running in 93c58d4b5fc1
Removing intermediate container 93c58d4b5fc1
---> 1a6657883eb9
Step 4/5 : COPY . .
---> 9badab908e55
Step 5/5 : ENTRYPOINT ["dotnet", "k8swebapi.dll", "--urls", "http://*:5000;http://*:5001"]
---> Running in 25a44038e606
Removing intermediate container 25a44038e606
---> 3068b399a9f4
Successfully built 3068b399a9f4
Successfully tagged k8swebapi:latest
构建镜像成功后,显示Successfully ,返回镜像ID 3068b399a9f4
4.创建容器并启动容器
使用docker run
-d代表是后台运行容器
--rm指定容器停止后自动删除容器, 用docker stop contriner 停止后自动删除该容器
--P(大写) 宿主主机自动分配端口并关联容器暴露的5000端口,外部使用宿主主机自动分配的端口访问web api服务
--name 容器名称
最后一个参数是镜像名称,前面的参数都是[OPTIONS] 格式:docker run [OPTIONS] IMAGE [COMMAND] [ARG...]
[root@VM_0_12_centos webapipublish]# docker run -d --rm -P --name k8swebapi k8swebapi
dd8b01b33183f621d98043fdddbb7fda5817d312b7943a53718d6e6b0b0b94aa
通过docker ps查看创建的容器,和宿主自动分配的端口32770。 容器内访问api服务端口5000, 容器外访问api服务端口32770
[root@VM_0_12_centos webapipublish]# docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
dd8b01b33183 k8swebapi "dotnet k8swebapi.dl…" About an hour ago Up About an hour 0.0.0.0:32770->5000/tcp k8swebapi
3ddee94cef3a ubuntu:latest "/bin/bash" 6 days ago Up 6 days quizzical_nash
5. 进入容器
进入k8swebapi容器,查看app目录,再请求api服务,如下所示:
[root@VM_0_12_centos webapipublish]# docker exec -it dd8b01b33183 /bin/bash
root@dd8b01b33183:/app# ls
Dockerfile System.Text.Encodings.Web.dll k8swebapi.Views.pdb
Microsoft.AspNetCore.Mvc.Versioning.ApiExplorer.dll System.Text.Json.dll k8swebapi.deps.json
Microsoft.AspNetCore.Mvc.Versioning.dll YLYUN.Common.Dapper.dll k8swebapi.dll
Microsoft.Bcl.AsyncInterfaces.dll YLYUN.Common.Dapper.pdb k8swebapi.pdb
Microsoft.OpenApi.dll YLYUN.Common.Dapper.xml k8swebapi.runtimeconfig.json
Swashbuckle.AspNetCore.Swagger.dll appsettings.Development.json web.config
Swashbuckle.AspNetCore.SwaggerGen.dll appsettings.json wwwroot
Swashbuckle.AspNetCore.SwaggerUI.dll dll
System.Runtime.CompilerServices.Unsafe.dll k8swebapi.Views.dll
root@dd8b01b33183:/app# curl http://localhost:5000/api/v1/user/IndexList
[{"id":1,"name":"张三"},{"id":2,"name":"李四"}]root@dd8b01b33183:/app#
6. 外部访问
在宿主主机上访问,如下所示:
[root@VM_0_12_centos webapipublish]# curl http://localhost:32770/api/v1/user/IndexList
[{"id":1,"name":"张三"},{"id":2,"name":"李四"}][root@VM_0_12_centos webapipublish]#
外面通过windows系统的浏览器访问(这里的ip为服务器云网ip),如下所示: