Dotnet core 2.0 + NPOCO + Oracle数据库 + Docker 部署小例子

前言:公司要上dotnet core 项目,让我先搞研究。本人Javaer,已多年没搞过dotnet,但是老板有要求只能上网搜,但是网上比较少相关的例子。所以花了两个星期研究之后,写了这篇文章。

1. 准备

我用的是最新的VS2017,至少需要安装的workload如下图:

Dotnet core 2.0 + NPOCO + Oracle数据库 + Docker 部署小例子_第1张图片
Dotnet core 2.0 + NPOCO + Oracle数据库 + Docker 部署小例子_第2张图片

2. 新建项目

当上面的安装完之后,dotnet core 2.0 就已经安装完毕。打开VS 2017 -> New -> Project。我这里是做后台API框架,为前端和手机端提供API的,不需要做页面,因此选择ASP.NET Core Web Application. 

Dotnet core 2.0 + NPOCO + Oracle数据库 + Docker 部署小例子_第3张图片

这样建好的项目就已经可以运行了,使用 IIS Express启动就可以访问默认的API了。API的端口以及URL,可以在launchSettings.json修改。

Dotnet core 2.0 + NPOCO + Oracle数据库 + Docker 部署小例子_第4张图片

项目新建好之后,会自动生成一个Controller,在Controller里面已经生成好了几个API,跟根据需要可以自行修改.

Dotnet core 2.0 + NPOCO + Oracle数据库 + Docker 部署小例子_第5张图片

3. 数据库驱动

这是使用的数据库是oracle 11g,使用的驱动是oracle官方驱动preview版,因为当前的还没有正式版的驱动for dotnet core。这里默认已经在docker上安装的oracle,安装过程不在赘述。

首先是下载驱动,一种方法是到官方网站下载再导入。我这里选择在VS的NuGet下载。选择Tools -> NuGet package manager -> Manage NuGet packages for solution.

Dotnet core 2.0 + NPOCO + Oracle数据库 + Docker 部署小例子_第6张图片

在打开的对话框中Search oracle,在查找结果中选择 Oracle.ManagedDataAccess.Core,注意不要选错了,要选择的是for dotnet core的驱动,一般查找结果第一个是.net framework的.

Dotnet core 2.0 + NPOCO + Oracle数据库 + Docker 部署小例子_第7张图片

使用相同的方法安装NPOCO,NPOCO是一个轻量级的ORM框架

Dotnet core 2.0 + NPOCO + Oracle数据库 + Docker 部署小例子_第8张图片

Oracle驱动和NPOCO都安装好之后,在Solution Explorer中会看到。

Dotnet core 2.0 + NPOCO + Oracle数据库 + Docker 部署小例子_第9张图片

4. 数据库连接

我这个写了一个DataManager的类来连接数据库。数据库连接串写在了appsettings.json。这个有个点需要注意,在开发环境连接docker的数据库只能使用IP,但是当项目部署的docker中,在docker环境连接数据库时,则需要将IP地址改为数据库的docker容器名。即:192.168.38.131 需要改为 oracle_11g,这个oracle_11g是oracle的容器名。这点不像Java,在java的开发环境也是可以直接使用docker容器名的。我查询过NPOCO的文档,是可以使用主机名连接的,但是我实测是不行的,不知是不是dotnet core的原因。毕竟NPOCO是dotnet framework的框架,没有专门对dotnet core的版本。

使用如下脚本安装docker容器:

docker run -d -P -p 1521:1521 --network='bridge' --name='oracle' oracle:11g

Dotnet core 2.0 + NPOCO + Oracle数据库 + Docker 部署小例子_第10张图片

5. 数据库的操作

在连接好数据库之后就可以操作数据库了,操作的模版代码也很简单,需要更复杂的可以自己取NPOCO的网站查询。以下是代码。

Dotnet core 2.0 + NPOCO + Oracle数据库 + Docker 部署小例子_第11张图片

6. 项目发布

项目可以直接发布到微软的docker或者服务器,这里我选择发布到文件夹,并最终我们是要发布到docker上的。在项目中右键选择Publish,首次发布会弹出对话框选择发布目标,这里我们选择Folder,如下图。

Dotnet core 2.0 + NPOCO + Oracle数据库 + Docker 部署小例子_第12张图片

然后点击Publish,VS会将代码打包成DLL文件,以及copy相关的dll文件到一个文件夹中。

Dotnet core 2.0 + NPOCO + Oracle数据库 + Docker 部署小例子_第13张图片

这里的WebApplicationDemo是项目名称,而WebApplicationDemo.dll就是程序入口。这个名称在之后编写Dockerfile时,要将这个dll指定为entry point。

WinScp登录服务器,将整个publish文件copy到服务器中,这里我的路径是/root/publish。这个路径在之后创建docker容器时挂载到容器中。

7. 部署docker

到上面这一步为止,项目已经可以正常运行并且可以操作数据库了。但是这些操作都是在本地,现在需要经项目部署的docker上。

首先下载dotnet core 的docker镜像。运行命令: docker search dotnet 并下载官方的dotnet镜像。

下载好镜像之后,登录远程服务器上,切换到/root文件夹下.

创建Dockerfile并写入以下内容:

FROM microsoft/dotnet

WORKDIR /publish

ENTRYPOINT ["dotnet", "WebApplicationDemo.dll"]

注意:WebApplicationDemo.dll是项目的主程序入口.

运行命令创建一个名为dotenetcore的镜像

docker build -t dotnetcore .(这里还有一个点)

然后运行命令:

docker run --name 'dotnetcore' --network='bridge' --link oracle_11g:oracle_11g -v "/root/publish":"/publish" -p 80:80 -e "ASPNETCORE_URLS=http://+:80" dotnetcore

注意:oracle_11g 是 oracle docker 容器的名字. 如果出现挂载目录后容器内访问权限错误,可以加上--privileged=true 参数.

到这里将容器运行起来之后,就可以访问程序了. URL类似: http://192.168.38.131/api/BMBS.

以后更新代码只需要将本机publish里面的代码都copy到/root/publish中,重启docker的dotnet容器即可.

你可能感兴趣的:(Dotnet core 2.0 + NPOCO + Oracle数据库 + Docker 部署小例子)