本教程的前提是,你已经在Linux服务器上已经成功的安装了Docker,我会大概介绍在此过程中用到的Docker命令,并不会介绍所有的Docker命令(因为我也不会)。
一、在Docker中运行Dotnet Core Hello World
微软官方提供了已经集成好Dotnet Core运行所需环境的Docker Image,我们可以直接使用命令:
docker run -it microsoft/dotnet:latest
其中
-i :交互模式 (so we can interact with it)
-t : 分配一个(伪)tty (link is external
microsoft/dotnet:这是微软提供的Docker Core的官方Image名称,
latest :表示我们使用这个版本的Image
通过上面的命令,我们就创建了一个Docker Container,并且启动它。
其实Docker Run,他是分了三步走的:
- 查看本地是否有我们所需要启动的镜像,没有的话,尝试去服务器获取
- 创建一个容器,对应的Docker命令:
docker create -it microsoft/dotnet:latest
如果创建成功了,则会输出一个容器的ID,我们也可以通过docker ps来查看
- 启动容器,对应的Docker命令
docker start -a -i 容器ID
这时候,我们就把最基本的容器启动起来了,在容器中,就可以执行一些Dotnet Core的控制台命令:
root@0260ab2fd089:/# dotnet new
Created new C# project in /.
root@0260ab2fd089:/# mkdir docker //创建一个文件夹,名字叫docker
root@0260ab2fd089:/# cd docker/
root@0260ab2fd089:/docker# dotnet new //创建一个Dotnet Core项目
Created new C# project in /docker.
root@0260ab2fd089:/docker# dotnet restore //还原Dotnet Core项目的依赖包
log : Restoring packages for /docker/project.json...
log : Writing lock file to disk. Path: /docker/project.lock.json
log : /docker/project.json
log : Restore completed in 4658ms.
root@0260ab2fd089:/docker# dotnet run //启动Dotnet Core项目
Project docker (.NETCoreApp,Version=v1.) will be compiled because expected outputs are missing
Compiling docker for .NETCoreApp,Version=v1. Compilation succeeded.
Warning(s)
Error(s) Time elapsed ::03.0599700 Hello World! //输出结果
二、部署一个 Web API项目到Docker
1.创建API
我们来使用VS 2015创建一个WebAPI项目的名称为:JaxApi,并对默认项目做以下调整:
A.升级项目所依赖的所有Nuget包
因为可能有的VS版本稍旧,他默认引用的包都是rc版本的,不升级可能会有一些小问题,我在最早尝试的时候遇到过在本地跑的好好的,但是到了docker中就跑不起来的问题。
如果你的VS默认引用的rc版本,那么你升级后可能会遇到项目编译不过的问题,好像是Nuget的一个Bug,他把project.json改了,我的解决办法是,在frameworks -> netcoreapp1.0 节点下增加如下配置:
"Microsoft.NETCore.App": {
"version": "1.0.0",
"type": "platform"
}
然后把dependencies中对Microsoft.NETCore.App的引用干掉。
这个问题最新的VS中不存在,只是我公司因为各种原因无法安装最新版
B.让WebApi不止监听localhost来的请求
新建的API项目默认他只会监听来自Localhost的web请求,我们需要在Program类中增加一个配置:
public class Program
{
public static void Main(string[] args)
{
var host = new WebHostBuilder()
.UseKestrel()
.UseContentRoot(Directory.GetCurrentDirectory())
.UseIISIntegration()
.UseUrls("http://*:9100")//监听来自所有ip的9100端口的请求
.UseStartup<Startup>()
.Build(); host.Run();
}
}
C.发布Web API
通过文件系统发布WebAPI,这里与发布普通网站并没有什么不同,所有选项默认,跟着VS一步一步来~
发布的时候最好留个后门,在Release和PublishOutput中间加上一层文件夹,待会儿告诉你啥用,比如我的发布目录:.\bin\Release\Docker\PublishOutput
2.编写DockerFile
打开刚才发布的目录,新建一个没有后缀的文件Dockerfile,与PublishOutput文件夹同级
这里我们如果使用命令行来把文件粘贴到服务器的话,文件夹要比粘贴单个文件方便的多,而且对于我本地测试来说,也没有必要来回折腾压缩文件。这种文件夹层级更加便于我们上传文件~
Docker File 内容如下,注意端口号要和上面我们Program中配置的一样:
FROM microsoft/dotnet:latest WORKDIR /root # Copy the app file to root COPY PublishOutput /root/ # Configure the listening port to
EXPOSE /tcp # Start the app
ENTRYPOINT dotnet JaxApi.dll
然后把Dockerfile和PublishOutput一起上传到Linux服务器上,具体怎么上传大家就八仙过海各显神通吧~
3.编译成Image并运行
在Linux服务器上Dockerfile所在目录下,运行命令:
docker build -t jaxapi ./
docker build:根据Dockerfile来编译一个Docker Image出来
-t : 给镜像打个tag(标签),类似于起个名字
这样子,我们的docker镜像就在我们的服务器上编译好了,这时候,我们可以来启动我们的api,供外界访问
docker run -it -p : --name jaxapi jaxapi
-p :映射docker容器的端口,docker里面的9100端口映射到Linux的9100端口上
--name: 给我的container起个别名,这个可以不加
这样子,如果你在控制台看到如下提示,就证明你已经成功了:
Hosting environment: Production
Content root path: /docker
Now listening on: http://*:9100
Application started. Press Ctrl+C to shut down.
查看一下你的Linux服务器的Ip,然后通过http://ip:9100 来访问你的api吧,默认的API项目只有/api/values这个URL可以访问,最终运行效果如下:
如果您在阅读过程中,遇到一些问题,欢迎留言讨论。
未完待续……