sqlitedocker4dotnet #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的成效,进行代码的编译,调试以及发表操作。

sqlite 1

下载地址:https://code.visualstudio.com
(同样大家好当民众号中输入d4dtools获取最新版本的code安装包,提供Windows/Mac/Linux不同版本)

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

sqlite 2

下载地址: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等前端工具。

sqlite 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提供了同样的效能。

sqlite 4

运行以下命令就可以完成yeoman的装置

npm install yo -g

以yeoman中提供了不同的generator(模版生成器)来供不同门类的路的变型,为了能够生成asp.net
core应用,我们得装aspnet generator

npm install generator-aspnet -g

安装好以后就可创造项目了

sqlite 5

乃啊得友善创造generator,参考 aspnet generator 的 github
源代码来学。
https://github.com/omnisharp/generator-aspnet

4. Docker for Mac

以及 Docker for Windows 一样,我们可当macOS上设置Docker for
Mac来支撑Docker环境的管理。

sqlite 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

sqlite 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中平等进行单步调试,查看变量数值的变迁。

sqlite 8

2. 创mysql容器作为支出数据库

数据库的出一般会要求我们事先安装一个数据库引擎在协调的机器上,现在利用docker,我们得于容器中运行一个数据库引擎。这样做生诸多利益,1)自己之机可以十分干净,不用顾虑各种程序中互相冲突;2)数据库随用随开,不用的时刻就合,不必占用资源;3)可以每次都为此干净的数据库进行调剂,不用担心恢复数据状态;如果需要的话,也堪管容器中之数码卷内容同步到本机上。

苟这么做,首先你需要平等华容器化主机,可以参见按系列第二首
《docker4dotnet #2
容器化主机》遭遇之做法

这里自己利用了平等光运行于地面的vmwarefusion中的docker主机

sqlite 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

sqlite 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中之ConfigureServices方法被加上依赖注入代码

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

在Configure方法吃调用SampleData.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两个说明就创办而写副了示范数据。

sqlite 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上所用的名字

sqlite 12

sqlite 13

这边当dotnet restore这同一步会较缓慢,因为需要下载所有的依赖包。

注:在普通开支被,你得将先用时因此包创建一个协调之base
image,替换Dockerfile中之microsoft/dotnet,这样便绝不每次都又生充斥包了。

今键入docker images命令就可以看到我们新创办的image了

sqlite 14

运行

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

sqlite 15

君得看看我们的容器现在也不易连接到了mysql容器的对外端口上了。在浏览器中输入docker主机的ip地址:5000端口,我们的应用即净以容器被飞起了。

sqlite 16

在docker ps中看出的2单容器是这么的

sqlite 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

sqlite 18

以上代码都曾经揭晓暨自我之github上,地址如下:

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

若是你按照本文的第一组成部分装置了独具工具,那么你该好一直用行docker-compose
up来启动这个用;以下我录制了同一段子简单的视频(3分钟)来演示这个历程。

 

有关文章:

  • docker4dotnet #1 前世今生 &
    世界而好
  • docker4dotnet #2
    容器化主机
  • docker –
    你应有懂得的10宗事

 

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

sqlite 19

网站地图xml地图