大网数据广告活动
.NET 与 C# 开发

使用作为容器而运行的数据库服务器

· 52CE 我爱测

适用于容器化 .NET 应用程序的 .NET 微服务体系结构 | 仅出于开发目的使用作为容器运行的数据库服务器! 了解原因。

你可以将自己的数据库(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 映像以及已知数据开始运行集成测试。

其他资源

在 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,规范化链接,移除外部媒体、发布器占位标签和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 10/02/2018
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。