docker4dotnet #3 在macOS上应用Visual Studio Code和Docker开发asp.net core和mysql应用

.net猿遇到了小鲸鱼,觉得更加兴奋。本来.net猿只是在通过家里这田子窗看外面的社会风气,但是看着海峡对岸的苹果园越来越旺盛,实在不想再去做一只宅猿了。于是,.net猿决定搭上小鲸鱼的渡轮到苹果园去看望。

.net猿上了小鲸鱼渡轮就先问了一个问题,苹果园上有能用来编写c#代码的和Visual
Studio一样强大的IDE么?这时,天空闪过一道Gamma射线,艾瑞克神说,给你一个
Visual Studio
Code,去玩吧。于是.net猿搭这小鲸鱼的快船顺利的到达了苹果山,先河了她的吃苹果之旅。

… … 小编只能憋出来这么多了,仍然来干货吧。


前几天,我们来探望咋样在macOS上采取 Visual Studio Code 开发 Asp.net Core
应用,并应用Docker来开展开发调试和部署。以前在利用 Visual Studio
的时候,我们来看了不错的集成性,IDE把拥有的工具链全部布置好了,你要做的只是F5就足以了,前天大家来品尝一出手工编制Dockerfile和Docker-Compose文件。其余,既然要开源,大家就彻底一点,本次大家不再利用sqlite或者sql
server作为数据库,而利用开源界最盛行的mysql作为我们利用的后台数据库。

未雨绸缪开发条件

第一我们需要下载和装置多少个工具

1. Visual Studio Code 和 .Net Core

Visual Studio Code
是微软为大面积开发人员提供的免费开源的跨平台代码编辑器,和任何流行的代码编辑器,如:Sublime,
Atom一样,它不行小,运行速度快,同时经过各个插件协理不同开发语言的编辑。不同的地点在于,VSC的插件不仅仅提供静态的语言高亮,自动语法检测和成就功效外;还提供越来越高档的编译器服务支撑,那使得VSC可以在早晚水准上代表IDE的机能,进行代码的编译,调试和发布操作。

Bootstrap 1

下载地址:https://code.visualstudio.com
(同样我们可以在公众号中输入d4dtools获取最新版本的code安装包,提供Windows/Mac/Linux不同版本)

Asp.net Core 是一个跨平台的 asp.net
开发环境,可以通过以下地方下载macOS上的安装包

Bootstrap 2

Bootstrap,下载地址:http://dot.net

注:假设您此前安装过asp.net 5或者 rc版的.net
core,需要在运转以上安装命令往日先卸载,在d4dtools网盘中下载
dotnet-uninstall-pkgs.sh,运行即可。

2. Node.JS和NPM,以及 bower, gulp 和 grunt 等前端工具

Node.js是一个javascript的运作引擎,提供服务端的javascript运行能力,同时也饱含了npm这么些包管理器,可以用来安装
bower, glup,grunt等前端工具。

Bootstrap 3

下载地址:http://nodejs.org
(d4dtools中蕴藏v4.4.7 LTS安装包的Windows和Mac版本)

设置完成后,让通过以下命令安装前端工具

npm install bower gulp grunt-cli -g

3. 设置项目模版生成工具 yeoman 和 asp.net generator

YEOMAN是用来成立项目模版的工具,用惯了Visual
Studio的开发人士一定都很欢喜新建项目标指导工具,采用自己要用的门类系列就可以创设出一个可运行的骨干项目框架,这让启动一个品类或者学习编程都变的非凡容易。Yeman提供了同样的效益。

Bootstrap 4

运行以下命令就可以形成yeoman的设置

npm install yo -g

在yeoman中提供了不同的generator(模版生成器)来提供不同类其它品种的扭转,为了可以生成asp.net
core应用,我们需要安装aspnet generator

npm install generator-aspnet -g

安装好将来就足以创设项目了

Bootstrap 5

您也可以友善创制generator,参考 aspnet generator 的 github
源代码来上学。
https://github.com/omnisharp/generator-aspnet

4. Docker for Mac

与 Docker for Windows 一样,大家得以在macOS上设置Docker for
Mac来支撑Docker环境的军事管制。

Bootstrap 6

下载地址:https://www.docker.com/products/docker
(d4dtools网盘:Docker.dmg)

迄今,我们的开销条件就准备截止了。

创建asp.net core webapp

接纳上述这多少个工具,大家就可以很顺利的建立应用程序了

1. 创设项目模版

先是创立一个使用目录,源代码目录

mkdir aspnet-mysql
cd aspnet-mysql
mkdir src

接下来进入src目录使用yoman成立项目

cd src
yo aspnet

选择 Web Application [without Membership and
Authorization]作为项目系列,Bootstrap作为前端框架,并交由应用名称aspnet-mysql

Bootstrap 7

回车后,yoman创制项目中的代码文件结构,并运行 bower install
完成所需要的javascript/css的设置

接下来运行以下命令,完成asp.net的nuget倚重包安装

cd aspnet-mysql
dotnet restore

说到底,键入以下命令打开 Visual Studio Code

code .

此时,VSC会自动生成以下配置文件,用于配置VSC中的开发调试工具链

.vscode/launch.json
.vscode/task.json

现行,你就可以切换来调试视图,并点击运行按钮起初调试你的施用了,你也得以在代码中设置断点,像在Visual
Studio中一律进行单步调试,查看变量数值的变迁。

Bootstrap 8

2. 创办mysql容器作为开发数据库

数据库的支出一般会要求我们先安装一个数据库引擎在祥和的机械上,现在拔取docker,大家可以在容器中运行一个数据库引擎。这样做有那一个好处,1)自己的机器可以很彻底,不用操心各样程序之间相互争辨;2)数据库随用随开,不用的时候就关闭,不必占用资源;3)可以每趟都用干净的数据库举办调剂,不用操心恢复生机数据状态;假如需要的话,也足以把容器中的数据卷内容同步到本机上。

要如此做,首先你需要一台容器化主机,可以参照本体系第二篇
《docker4dotnet #2
容器化主机》
中的做法

这边自己动用了一台运行在该地的vmwarefusion中的docker主机

Bootstrap 9

第一通过以下命令将docker命令重定向到这台主机中

eval $(docker-machine env {machine-name})

运行以下命令启动一台mysql数据库容器,成立一个叫做ef的数码,并将3306端口透露给当地环境

docker run --name mysql-dev -e MYSQL_ROOT_PASSWORD=P2ssw0rd -e MYSQL_DATABASE=ef -p 3306:3306 -d mysql

参数表明:

  • name:
    给容器起个名字称为mysql-dev,这样有利于前面管理用,如若不给名字的话docker会给一个无限制名字
  • -e: 配置容器的环境变量,这里我安排了
    • MYSQL_ROOT_PASSWORD : root用户密码
    • MYSQL_DATABASE:
      新数据库名称,mysql容器会按部就班要求创建一个ef为名称的空数据库
  • -p: 透露端口,将3306端口显表露来,便于管理

比方您本地没有mysql的镜像,docker会到docker
hub去下载,就算已经有了镜像那么启动真的是皮秒级的,启动完成后你就可以行使管理工具连接到这么些容器上,那里我用的MySQL
Workbench

Bootstrap 10

您可以见见 ef 数据库已经创办好了。

3. 部署asp.net应用使用mysql作为Entity Framework数据源

默认的asp.net 应用程序在Windows上使用sql
server或者localdb作为数据源,在非windows系统上使用的是sqlite。这里,localdb和sqlite都只好当作开发调试用途,假若需要投入生产就需要运用sql
server,对应到开源产品,大家可以采纳mysql作为sql
server的替代品。在上一步中我们曾经布置好了用来支付的mysql服务器(容器),现在我们需要对应用程序进行布局,让Entity
Framework可以采用mysql作为数据源。

那边,我们采纳的是由国内开发人士贡献的开源库,github地址如下:
https://github.com/PomeloFoundation/Pomelo.EntityFrameworkCore.MySql

率先在 project.json 文件的 dependencies 配置节中进入以下引述:

"Pomelo.EntityFrameworkCore.MySql": "1.0.0-prerelease-20160726"

而且添加一个nuget.config配置文件,并在里头添加Pomelo的源地址,那根本是因为这多少个nuget库现在还从未正式宣布,公布之后就无须举办这一个布局了

<?xml version="1.0" encoding="utf-8"?>
<configuration>
 <packageSources>
 <add key="NuGet official package source" value="https://nuget.org/api/v2/" />
 <add key="PomeloMysql" value="https://www.myget.org/F/pomelo/api/v2/"/>
 </packageSources>
</configuration>

 

然后重新运行 dotnet restore,这一次需要添加 –configfile
nuget.config这一个参数确保dotnet restore可以正确利用nuget源

dotnet restore --configfile nuget.config

4. 添加 MVC Model到项目中

今昔咱们就可以在品种中开创大家的实体类了,并且为了演示方便,我在还添加了一部分示范数据。

代码文件 https://github.com/ups216/aspnet-mysql/blob/master/src/aspnet-mysql/Models/Blog.cs

 

接下来在starup.cs中的Configure瑟维斯(Service)s方法中添加依赖注入代码

services.AddDbContext(options=>
 options.UseMySql(Configuration.GetConnectionString("Mysql")));

在Configure方法中调用山姆pleData.InitDB来创制示范数据

await SampleData.InitDB(app.ApplicationServices);

代码文件:https://github.com/ups216/aspnet-mysql/blob/master/src/aspnet-mysql/Startup.cs

在 appsetting.json 中开创名为Mysql的总是字符串

"ConnectionStrings": {
 "DefaultConnection": "Data Source=aspnetweb01.db",
 "Mysql": "Server={docker machine ip};database=ef;uid=root;pwd=P2ssw0rd;"
 }

代码文件:https://github.com/ups216/aspnet-mysql/blob/master/src/aspnet-mysql/appsettings.json

担保 uid及pwd参数与docker
run命令中的MYSQL_DATABASE,MYSQL_ROOT_PASSWORD一致
[docker machine ip]地点能够经过以下命令获取

docker-machine ip

现在,再度使用VSC启动应用举行调节,你可以观望在mysql中的ef数据中Blogs和Users四个表已经创办并且写入了演示数据。

Bootstrap 11

运用Docker打包发布应用

如上大家早就完结了asp.net应用的创导,并且利用了一个运转在容器中的mysql举办支付调试,现在大家需要将这个利用使用docker打包并运行在容器中。

1. 创建Dockerfile

行使yoman创制的运用本身就早已包含了一个Dockerfile,我们只需要举办简要修改即可
文件内容如下

FROM microsoft/dotnet:latest
COPY . /app
WORKDIR /app
RUN ["dotnet", "restore", "--configfile", "nuget.config"]
RUN ["dotnet", "build"]
EXPOSE 5000/tcp
ENTRYPOINT ["dotnet", "run", "--server.urls", "http://0.0.0.0:5000"]

代码链接:https://github.com/ups216/aspnet-mysql/blob/master/src/aspnet-mysql/Dockerfile

本条文件很简短,我们来看看它都做了些什么:

  • FROM microsoft/dotnet:latest 告诉docker
    build使用microsoft/dotnet这多少个镜像的风行版作为我们的base image
  • COPY . /app
    将本机上Dockerfile所在目录的保有文件拷贝到容器的/app目录中
  • WORKDIR /app
    设置容器使用/app作为工作目录,那样持续的操作就都在那多少个目录中举行
  • RUN dotnet restore 和 RUN dotnet build告诉docker build要执行dotnet
    restore和dotnet
    build五个指令,同时采纳nuget.config作为restore的配备文件
  • EXPOSE 5000/tcp 暴露5000端口
  • ENTRYPOINT [“dotnet”, “run”, “–server.urls”,
    http://0.0.0.0:5000”\],设置容器入口为dotnet
    run命令,这多少个命令将开行我们使用

2. 构建容器镜像并运行容器

现今,大家就可以运行以下命令完成容器构建了

docker build -t {image name}.

个中 {image name}
你能够随便起,我那里用的是ups216/aspnet-mysql,那是本身背后要上传到docker
hub上所用的名字

Bootstrap 12

Bootstrap 13

这边在dotnet restore这一步会相比较慢,因为需要下载所有的依赖包。

注:在平日支付中,你能够将先用常用包创建一个要好的base
image,替换Dockerfile中的microsoft/dotnet,这样就绝不每一遍都再也下载包了。

现今键入docker images命令就足以观望我们新成立的image了

Bootstrap 14

运行

docker run --name aspnet-msyql-dev -p 5000:5000 ups216/aspnet-msyql

Bootstrap 15

您可以看来大家的容器现在也不利连接到了mysql容器的对外端口上了。在浏览器中输入docker主机的ip地址:5000端口,大家的使用就完全在容器中跑起来了。

Bootstrap 16

在docker ps中观看的2个容器是那般的

Bootstrap 17

3. 生育布局打包

以上过程中我们曾经将利用部署到了容器中,并且总是到此外一个容器中运作的mysql服务。然则,我们这么些连续是经过mysql容器表露给主机的端口来连续的,这样做在支付过程中会相比方便,因为您可以容器的实用工具连接到mysql举行操作,不过只要要拓展对外发表就不是个好主意了。

与此同时,我盼望可以将web应用和mysql容器一同部署,形成一个完整的行使部署包。这时,就需要依靠docker-compose来完成了。

率先,大家创造一个用于生产环境的布局文件,appsettings.Production.json,内容如下:

{
 "ConnectionStrings": {
       "DefaultConnection": "Data Source=aspnetweb01.db",
       "Mysql": "Server=db;database=ef;uid=ef;pwd=P2ssw0rd;"
 },
 "Logging": {
      "IncludeScopes": false,
           "LogLevel": {
           "Default": "Debug",
           "System": "Information",
           "Microsoft": "Information"
           }
      }
 }

代码链接:https://github.com/ups216/aspnet-mysql/blob/master/src/aspnet-mysql/appsettings.Production.json

此间我们重点修改了Mysql的连天字符串,使用db作为数据库,并使用ef作为连接用户。

然后,大家创制一个 docker-compose.yml 文件,内容如下:

version: '2'
 services:
   db:
     image: mysql
     restart: always
     environment:
       MYSQL_ROOT_PASSWORD: P2ssw0rd
       MYSQL_DATABASE: ef
       MYSQL_USER: ef
       MYSQL_PASSWORD: P2ssw0rd

   web:
     build: .
     depends_on:
       - db
     links:
       - db
     ports:
       - "5000:5000"
     restart: always
     environment:
     ASPNETCORE_ENVIRONMENT: Production

其间的内容大多可以从字面意思读懂,这里最重要创造了db和web四个容器,web容器依赖db容器,并通过db这一个名字链接过去,同时设置asp.net
core的environment环境变量为Production。

对应以上大家在appsettings.Production.json文件中做的改动,你就可以清楚大家透过Production这么些环境变量配置我们的采纳去到一个称作db的mysql服务器上链接名为ef的数据库,并且采用ef作为用户名。

今昔,你只需要周转以下那个命令就足以成功这七个容器的启动了

docker-compose up

Bootstrap 18

以上代码都已经公布到自己的github上,地址如下:

https://github.com/ups216/aspnet-mysql/

比方你依据本文的率先片段设置了颇具工具,那么你应该可以直接用行docker-compose
up来启动这多少个利用;以下我录制了一段简单的视频(3分钟)来演示这一个过程。

 

连带作品:


 

请关注微信公众号 【devopshub】,获取更多关于DevOps研发运维一体化的音信

Bootstrap 19

相关文章