knowbr/a2a-mcp-sales-db-bootstrap

镜像概述

knowbr/a2a-mcp-sales-db-bootstrap是基于.NET 8的控制台应用镜像，作为初始化容器（init container/bootstrap），在MCP Sales主应用启动前完成SQL Server数据库的准备工作，确保主应用启动时数据库环境就绪。

核心功能

1. 等待数据库可用：通过轮询重试机制（可配置MaxConnectionAttempts和RetryDelaySeconds）确认SQL Server服务正常。
2. 创建数据库：自动检查并创建默认名为A2A的数据库（不存在时创建）。
3. 管理登录与用户：创建或更新SQL登录mcp_reader（密码通过secret文件读取），在数据库中创建对应用户并授予db_datareader角色。
4. 执行SQL脚本：按字母顺序执行指定目录（ScriptsPath）下的.sql文件，支持两种模式：
   • demo：执行所有脚本（含schema和示例数据）
   • schema-only：仅执行以01_开头的脚本（仅schema），并验证sales schema及表是否创建成功。
5. Secret文件读取：从外部文件读取SA和读者用户的密码，支持Docker卷挂载。

使用场景

适用于Docker Compose环境，作为依赖SQL Server服务的初始化容器，在MCP Sales主应用启动前完成数据库初始化，确保主应用启动时数据库环境已准备完毕。

配置说明

• 核心配置项：MaxConnectionAttempts（最大连接尝试次数）、RetryDelaySeconds（重试间隔秒数）、ScriptsPath（SQL脚本目录）、Mode（运行模式：demo/schema-only）。
• Secret文件：通过挂载卷提供SA密码文件（如/run/secrets/sa_password）和读者密码文件（如/run/secrets/mcp_reader_password）。

Docker部署示例

Docker Compose片段

yaml
version: '3.8'
services:
  sql-server:
    image: mcr.microsoft.com/mssql/server:2022-latest
    environment:
      SA_PASSWORD: "YourStrong@Passw0rd"
      ACCEPT_EULA: "Y"
    ports:
      - "1433:1433"
    volumes:
      - sql-data:/var/opt/mssql

  db-bootstrap:
    image: knowbr/a2a-mcp-sales-db-bootstrap
    depends_on:
      - sql-server
    volumes:
      - ./sql-scripts:/app/scripts  # 挂载SQL脚本目录
      - ./secrets:/run/secrets      # 挂载secret文件目录
    environment:
      - ConnectionStrings__DefaultConnection="Server=sql-server;Database=A2A;User Id=sa;Password=/run/secrets/sa_password"
      - BootstrapOptions__MaxConnectionAttempts=10
      - BootstrapOptions__RetryDelaySeconds=5
      - BootstrapOptions__ScriptsPath=/app/scripts
      - BootstrapOptions__Mode=demo
      - BootstrapOptions__ReaderPasswordPath=/run/secrets/mcp_reader_password

volumes:
  sql-data: