在Docker中运行SQLServer ASP.NET应用

本文涉及的产品
容器镜像服务 ACR,镜像仓库100个 不限时长
容器服务 Serverless 版 ACK Serverless,952元额度 多规格
容器服务 Serverless 版 ACK Serverless,317元额度 多规格
简介: 本文介绍了如何在Docker中运行.NET程序并访问SQL Server云数据库。

logos

云栖社区的文章在阿里云上运行ASP.NET Docker应用一文和大家探讨了如何在Docker中运行ASP.NET应用。本文是上一篇文章的续篇,讨论如何让应用访问SQLServer数据库。

创建SQLServer数据库

我们首先在阿里云上开通一个SQLServer服务器实例,创建用户user1

user

创建一个名为Blog的数据库,并授权user1能够访问数据库。为数据库开通外网访问,获得数据库外网访问地址。

database

所有这些操作都能够在控制台完成,如果你想进入SQLServer的控制台,可以点击上图的登录数据库进入数据库的访问界面:

dbmgmt

上图显示的内容示例程序运行完成后的结果,现在不用手工创建数据库表,我们会利用Entity Framework的数据库Migration功能初始化数据库。

至此你应当有如下数据库访问信息,记录下这些信息以备下文的程序使用。

  • 数据库地址
  • 端口号
  • 用户名
  • 密码

引入ORM框架Entity Framework

Entity Framework是.NET上的ORM框架,支持多种常见数据库,包括MS SQL Server、SQLite、Postgres等。详细信息请访问官方博客:Announcing Entity Framework Core 1.0

我们在project.json中引入Entity Framework和SQLServer。

"dependencies": {
"Microsoft.EntityFrameworkCore.Sqlite": "1.0.0",
"Microsoft.EntityFrameworkCore.Design": {
  "version": "1.0.0-preview2-final",
  "type": "build" 
},
"Microsoft.EntityFrameworkCore.SqlServer": "1.0.0",
"Microsoft.EntityFrameworkCore.SqlServer.Design": "1.0.0"
},

还有这一段:

"tools": {
"Microsoft.EntityFrameworkCore.Tools": "1.0.0-preview2-final" 
} 

执行restore命令加载所有依赖包和工具。

dotnet restore

命令完成后创建project.lock.json文件,不要手工更改这个文件,每次引入新的依赖后请再次执行Restore命令。

数据模型和数据库连接

Entity Framework通过DbContext定义对数据库的访问以及对象和数据库的关系映射。我们首先创建一个新C#文件,命名为Model.cs。

在Model.cs中创建一个类BloggingContext继承自DbContext。

public class BloggingContext : DbContext
{
    public DbSet<Blog> Blogs { get; set; }
    public DbSet<Post> Posts { get; set; }

    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        var serverAddress = Environment.GetEnvironmentVariable("SQLSERVER_ADDRESS");
        var serverPort = Environment.GetEnvironmentVariable("SQLSERVER_PORT");
        var userName = Environment.GetEnvironmentVariable("SQLSERVER_USERNAME");
        var password = Environment.GetEnvironmentVariable("SQLSERVER_PASSWORD");

        var connection = string.Format("Server={0},{1};Database=blog;User Id={2};Password={3};",
        serverAddress,serverPort,userName,password);
        optionsBuilder.UseSqlServer(connection);
    }
}

OnConfiguring方法里定义如何访问数据库。从环境变量中读取值构建connection字符串,然后调用optionsBuilder的UseSqlServer方法建立和数据库的连接。如何想要访问其他类型的数据库,例如sqlite,调用optionsBuilder的相应方法即可。

var connection = string.Format("Server={0},{1};Database=blog;User Id={2};Password={3};",
    serverAddress,serverPort,userName,password);
optionsBuilder.UseSqlServer(connection);

我们的示例中定义两个类,分别是博客Blog和帖子Post,在数据库中是两个不同的数据库表。每个类都只定义了属性和get/set方法。随后我们会利用Entity Framework初始化数据库。

public class Blog
{
    public int BlogId { get; set; }
    public string Url { get; set; }
    public string Name { get; set; }

    public List<Post> Posts { get; set; }
}

public class Post
{
    public int PostId { get; set; }
    public string Title { get; set; }
    public string Content { get; set; }

    public int BlogId { get; set; }
    public Blog Blog { get; set; }
}

访问数据库的代码

更改Startup.cs,加入对数据库的访问。把Startup.cs中的这一段替换:

return context.Response.WriteAsync("Hello from ASP.NET Core!");

替换的内容为:

using (var db = new BloggingContext())
{
    var result = "";
    db.Blogs.Add(new Blog { Url = "https://yq.aliyun.com/teams/11" });
    var count = db.SaveChanges();
    result += string.Format("{0} records saved to database\n", count);

    result += string.Format("All blogs in database:\n");
    foreach (var blog in db.Blogs)
    {
        result += string.Format(" - {0}\n", blog.Url);
    }                
    return context.Response.WriteAsync(result);
}

这段代码的作用是在通过创建一个Blog对象在数据库中插入一行,然后从数据库中读取并显示。

利用Entity Framework初始化数据库

运行Entity Framework工具创建一个数据库迁移脚本,并初始化数据库。

dotnet ef migrations add MyFirstMigration
dotnet ef database update

登陆到数据库中可以看到新创建的两个表BlogPost

运行

所有代码就绪后即可运行应用观察效果:

$ dotnet run
$ curl http://localhost:5000/
1 records saved to database
All blogs in database:
 - https://yq.aliyun.com/teams/11

从输出可以看到,我们的程序成功地写入数据库一条数据,然后读取数据库中的所有内容。

容器化

Dockerfile内容和helloword的Dockerfile内容一样,抄录在此。

FROM microsoft/dotnet:latest
COPY bin/release/netcoreapp1.0/publish/ /app/
EXPOSE 5000/tcp
ENTRYPOINT dotnet /app/aspnet-sqlserver.dll

创建docker-compose.yml,用于在本地Docker环境中运行:

version: "2"
services:
  aspnet-helloworld:
    image: registry.cn-hangzhou.aliyuncs.com/jingshanlb/aspnet-sqlserver
    environment:
      - SQLSERVER_ADDRESS=
      - SQLSERVER_PORT=
      - SQLSERVER_USERNAME=
      - SQLSERVER_PASSWORD=
    ports:
      - 5000:5000

填入相应的环境变量值,分别是数据库地址、端口号、用户名和密码,运行docker compose命令启动容器。

$ docker-compose up -d

用同样的方式curl访问本机5000端口,可以看到在容器中也运行正常。

部署到阿里云容器服务上

部署到阿里云上的模版内容和在本机的文件基本一致,但是有几个小的变化:

  • 利用变量名输入数据库的地址、端口、用户和密码
  • 不用将容器映射到主机500端口,利用容器服务的路由服务能力
  • 指定该服务启动两个容器

这是docker-compose-acs.yml内容:

version: "2"
services:
  aspnet-helloworld:
    image: registry.cn-hangzhou.aliyuncs.com/jingshanlb/aspnet-sqlserver
    environment:
      - SQLSERVER_ADDRESS=${SQLSERVER_ADDRESS}
      - SQLSERVER_PORT=${SQLSERVER_PORT}
      - SQLSERVER_USERNAME=${SQLSERVER_USERNAME}
      - SQLSERVER_PASSWORD=${SQLSERVER_PASSWORD}
    labels:
      aliyun.scale: '2'
      aliyun.routing.port_5000: http://aspnet-sqlserver

利用模版部署后,访问服务端点URL,可以看到如下输出:

access

讨论和总结

本文介绍了如何在Docker中运行.NET程序并访问SQL Server云数据库,利用ORM框架Entity Framework Core,我们可以很容易地对数据库进行初始化和Migration。

.NET Core应用容器化上云后可以利用阿里云容器服务的丰富功能。容器服务不但支持docker-compose模板提供的容器功能,使得本地开发的Docker镜像和编排模板可以轻松上云;更提供了灵活的部署约束描述,使得对分布式应用的部署和控制变得非常方便。

想了解更多容器服务内容,请访问 https://www.aliyun.com/product/containerservice

相关实践学习
使用SQL语句管理索引
本次实验主要介绍如何在RDS-SQLServer数据库中,使用SQL语句管理索引。
SQL Server on Linux入门教程
SQL Server数据库一直只提供Windows下的版本。2016年微软宣布推出可运行在Linux系统下的SQL Server数据库,该版本目前还是早期预览版本。本课程主要介绍SQLServer On Linux的基本知识。 相关的阿里云产品:云数据库RDS&nbsp;SQL Server版 RDS SQL Server不仅拥有高可用架构和任意时间点的数据恢复功能,强力支撑各种企业应用,同时也包含了微软的License费用,减少额外支出。 了解产品详情:&nbsp;https://www.aliyun.com/product/rds/sqlserver
相关文章
|
24天前
|
安全 Docker 容器
|
7天前
|
开发框架 监控 .NET
【Azure App Service】部署在App Service上的.NET应用内存消耗不能超过2GB的情况分析
x64 dotnet runtime is not installed on the app service by default. Since we had the app service running in x64, it was proxying the request to a 32 bit dotnet process which was throwing an OutOfMemoryException with requests >100MB. It worked on the IaaS servers because we had the x64 runtime install
|
18天前
|
安全 Linux Shell
docker运行centos提示Operation not permitted
通过上述步骤,可以有效排查和解决在Docker中运行CentOS容器时遇到的"Operation not permitted"错误。这些措施涵盖了从权限配置、安全策略到容器运行参数的各个方面,确保在不同环境和使用场景下都能顺利运行容器。如果你需要进一步优化和管理你的Docker环境
29 3
|
1月前
|
Shell Docker 容器
LangChain-10(2) 加餐 编写Agent获取本地Docker运行情况 无技术含量只是思路
LangChain-10(2) 加餐 编写Agent获取本地Docker运行情况 无技术含量只是思路
17 4
LangChain-10(2) 加餐 编写Agent获取本地Docker运行情况 无技术含量只是思路
|
20天前
|
JSON 算法 安全
JWT Bearer 认证在 .NET Core 中的应用
【10月更文挑战第30天】JWT(JSON Web Token)是一种开放标准,用于在各方之间安全传输信息。它由头部、载荷和签名三部分组成,用于在用户和服务器之间传递声明。JWT Bearer 认证是一种基于令牌的认证方式,客户端在请求头中包含 JWT 令牌,服务器验证令牌的有效性后授权用户访问资源。在 .NET Core 中,通过安装 `Microsoft.AspNetCore.Authentication.JwtBearer` 包并配置认证服务,可以实现 JWT Bearer 认证。具体步骤包括安装 NuGet 包、配置认证服务、启用认证中间件、生成 JWT 令牌以及在控制器中使用认证信息
|
1月前
|
NoSQL Linux Redis
Docker学习二(Centos):Docker安装并运行redis(成功运行)
这篇文章介绍了在CentOS系统上使用Docker安装并运行Redis数据库的详细步骤,包括拉取Redis镜像、创建挂载目录、下载配置文件、修改配置以及使用Docker命令运行Redis容器,并检查运行状态和使用Navicat连接Redis。
226 3
|
1月前
|
安全 Docker 容器
Docker中运行容器时Operation not permitted报错问题解决
【10月更文挑战第2天】Docker中运行容器时Operation not permitted报错问题解决
289 3
|
1月前
|
前端开发 应用服务中间件 nginx
docker运行nginx镜像
这篇文章详细说明了如何在Docker中部署并运行Nginx服务,包括拉取镜像、配置文件的挂载以及容器的启动配置。
219 0
docker运行nginx镜像
|
1月前
|
缓存 NoSQL Redis
docker运行redis镜像
这篇文章介绍了如何使用Docker运行Redis镜像,并提供了启动和配置Redis容器的具体命令和步骤。
115 0
|
1月前
|
NoSQL Redis Docker
Docker获取镜像和运行镜像
这篇文章介绍了如何使用Docker获取镜像以及运行镜像的具体步骤和命令。
212 0