你可以将自己的数据库(SQL Server、PostgreSQL、MySQL 等)放在常规独立服务器、本地群集或云中的 PaaS 服务(如 Azure SQL DB)中。 但对于开发和测试环境来说,将数据库作为容器运行很方便,因为没有任何外部依赖项,只需运行 docker-compose up 命令,即可启动整个应用程序。 将这些数据库作为容器也有利于集成测试,因为数据库在容器中启动,并且始终填充相同的样本数据,因此预测测试也就更容易了。
SQL Server 作为包含微服务相关数据库的容器运行
在 eShopOnContainers 中,运行 SQL Server for Linux 的 docker-compose.yml 文件中有一个名为 sql.data 的容器,包含微服务所需的所有 SQL Server 数据库。 (也可以为每个数据库设置一个 SQL Server 容器,但这会占用更多分配给 Docker 的内存。)微服务中重要的一点是每个微服务都有其相关数据,因此在这里是相关 SQL 数据库。 不过,这些数据库可以置于任何位置。
示例应用程序中的 SQL Server 容器在 docker-compose.yml 文件中配置有下列 YAML 代码,这些代码在运行 docker-compose up 时执行。 请注意,YAML 代码整合了来自通用 docker-compose.yml 文件和 docker-compose.override.yml 文件的配置信息。 (你通常会分离环境设置与 SQL Server 映像的相关基本信息或静态信息。)
sql.data:
image: microsoft/mssql-server-linux:2017-latest
environment:
- SA_PASSWORD=Pass@word
- ACCEPT_EULA=Y
ports:
- "5434:1433"
按照类似的方法,不使用 docker-compose,而使用下列 docker run 命令便可运行该容器:
docker run -e 'ACCEPT_EULA=Y' -e 'SA_PASSWORD=Pass@word' -p 5433:1433 -d microsoft/mssql-server-linux:2017-latest
但是,如果要部署多容器应用程序(如 eShopOnContainers),使用 docker-compose up 命令为应用程序部署所有必需的容器会更方便。
首次启动此 SQL Server 容器时,容器使用提供的密码初始化 SQL Server。 SQL Server 作为容器运行后,可以通过连接任何常规 SQL 连接(例如 SQL Server Management Studio、Visual Studio 或 C# 代码)来更新数据库。
eShopOnContainers 应用程序提供在启动时在数据库中设定数据,使用样本数据来初始化每个微服务数据库,如下文所述。
将 SQL Server 作为容器运行不仅可用于无法访问 SQL Server 实例的演示。 如前所述,对开发和测试环境也非常有用,因为可以通过设定新的样本数据轻松地从清晰的 SQL Server 映像以及已知数据开始运行集成测试。
其他资源
-
Run the SQL Server Docker image on Linux, Mac, or Windows \(在 Linux、Mac 或 Windows 上运行 SQL Server Docker 映像) https://docs.microsoft.com/sql/linux/sql-server-linux-setup-docker
-
Connect and query SQL Server on Linux with sqlcmd \(使用 sqlcmd 连接和查询 Linux 上的 SQL Server) https://docs.microsoft.com/sql/linux/sql-server-linux-connect-and-query-sqlcmd
在 Web 应用程序启动时设定测试数据
要在应用程序启动时向数据库添加数据,可以将以下代码添加到 Web API 项目 Startup 类中的 Configure 方法中:
public class Startup
{
// Other Startup code...
public void Configure(IApplicationBuilder app,
IHostingEnvironment env,
ILoggerFactory loggerFactory)
{
// Other Configure code...
// Seed data through our custom class
CatalogContextSeed.SeedAsync(app)
.Wait();
// Other Configure code...
}
}
自定义 CatalogContextSeed 类中的以下代码可填充数据。
public class CatalogContextSeed
{
public static async Task SeedAsync(IApplicationBuilder applicationBuilder)
{
var context = (CatalogContext)applicationBuilder
.ApplicationServices.GetService(typeof(CatalogContext));
using (context)
{
context.Database.Migrate();
if (!context.CatalogBrands.Any())
{
context.CatalogBrands.AddRange(
GetPreconfiguredCatalogBrands());
await context.SaveChangesAsync();
}
if (!context.CatalogTypes.Any())
{
context.CatalogTypes.AddRange(
GetPreconfiguredCatalogTypes());
await context.SaveChangesAsync();
}
}
}
static IEnumerable<CatalogBrand> GetPreconfiguredCatalogBrands()
{
return new List<CatalogBrand>()
{
new CatalogBrand() { Brand = "Azure"},
new CatalogBrand() { Brand = ".NET" },
new CatalogBrand() { Brand = "Visual Studio" },
new CatalogBrand() { Brand = "SQL Server" }
};
}
static IEnumerable<CatalogType> GetPreconfiguredCatalogTypes()
{
return new List<CatalogType>()
{
new CatalogType() { Type = "Mug"},
new CatalogType() { Type = "T-Shirt" },
new CatalogType() { Type = "Backpack" },
new CatalogType() { Type = "USB Memory Stick" }
};
}
}
运行集成测试时,可以生成与集成测试一致的数据很有用。 能够从头开始创建所有内容(包括在容器上运行的 SQL Server 实例)对测试环境非常有用。
EF Core InMemory 数据库与作为容器运行的 SQL Server
运行测试时,另一个不错的选择是使用 Entity Framework InMemory 数据库提供程序。 可以在 Web API 项目 Startup 类的 ConfigureServices 方法中指定该配置:
public class Startup
{
// Other Startup code ...
public void ConfigureServices(IServiceCollection services)
{
services.AddSingleton<IConfiguration>(Configuration);
// DbContext using an InMemory database provider
services.AddDbContext<CatalogContext>(opt => opt.UseInMemoryDatabase());
//(Alternative: DbContext using a SQL Server provider
//services.AddDbContext<CatalogContext>(c =>
//{
// c.UseSqlServer(Configuration["ConnectionString"]);
//
//});
}
// Other Startup code ...
}
不过,存在一个重要的问题。 内存数据库不支持指定于特定数据库的许多约束。 例如,在 EF Core 模型的列中添加唯一索引,以及针对内存数据库编写测试,检查其是否允许添加重复值。 但是,使用内存数据库时,无法处理列上的唯一索引。 因此,内存数据库与真正 SQL Server 数据库的工作方式不完全相同 - 前者不会模拟特定于数据库的约束。
即便如此,内存数据库仍然可用于测试和原型设计。 但如果想要创建考虑特定数据库实现行为的准确集成测试,则需要使用像 SQL Server 这样真正的数据库。 为此,在容器中运行 SQL Server 是一个不错的选择,它比 EF Core InMemory 数据库提供程序更准确。
使用在容器中运行的 Redis 缓存服务
可以在容器上运行 Redis,特别是用于开发和测试以及概念验证方案。 这种方案很方便,因为可以在容器上运行所有依赖项 - 不仅适用于本地开发机器,还适用于 CI/CD 管道中的环境测试。
但是,如果生产环境中运行 Redis,则最好是寻找像 Redis Microsoft Azure 这样的高可用性解决方案,该解决方案作为 PaaS(平台即服务)运行。 你只需在代码中更改连接字符串。
Redis 提供使用 Redis 的 Docker 映像。 该映像可在 Docker 中心获得,请访问此 URL:
https://hub.docker.com/\_/redis/
可在命令提示符中执行以下 Docker CLI 命令来直接运行 Docker Redis 容器:
docker run --name some-redis -d redis
Redis 映像包含公开:6379(Redis 使用的端口),因此链接容器可自动使用标准容器链接。
eShopOnContainers 中,basket.api microservice 使用作为容器运行的 Redis 缓存。 此 basket.data 容器被定义为 multi-container docker-compose.yml 文件的一部分,如以下示例所示:
#docker-compose.yml file
#...
basket.data:
image: redis
expose:
- "6379"
docker-compose.yml 中的这段代码基于 redis 映像定义了一个名为 basket.data 的容器,并在内部发布端口 6379,这意味着其只能从 Docker 主机中运行的其他容器进行访问。
最后,在 docker-compose.override.yml 文件中,eShopOnContainers 示例的 basket.api 微服务定义了用于该 Redis 容器的连接字符串:
basket.api:
environment:
# Other data ...
- ConnectionString=basket.data
- EventBusConnection=rabbitmq
如前文所述,微服务的名称“asket.data”通过 docker 的内部网络 DNS 进行解析。
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体、发布器占位标签和导航标记。
