Dotnet core 2.0 + NPOCO + Oracle

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

1. 准备

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

2. 新建项目

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

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

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

3. 数据库驱动

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

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

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

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

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

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

5. 数据库的操作

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

6. 项目发布

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

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

这里的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容器即可.