cilliemalan/sqlserver

SQL Server 镜像文档

镜像概述

本镜像基于微软官方SQL Server镜像（https://hub.docker.com/_/microsoft-mssql-server%EF%BC%89%E6%9E%84%E5%BB%BA%EF%BC%8C%E6%89%A9%E5%B1%95%E4%BA%86%E6%95%B0%E6%8D%AE%E5%BA%93%E5%88%9D%E5%A7%8B%E5%8C%96%E5%8A%9F%E8%83%BD%EF%BC%8C%E5%8F%AF%E8%87%AA%E5%8A%A8%E5%88%9B%E5%BB%BA%E6%8C%87%E5%AE%9A%E5%90%8D%E7%A7%B0%E7%9A%84%E6%95%B0%E6%8D%AE%E5%BA%93%E3%80%81%E7%99%BB%E5%BD%95%E7%94%A8%E6%88%B7%E5%8F%8A%E5%AF%B9%E5%BA%94%E6%9D%83%E9%99%90%EF%BC%8C%E5%90%8C%E6%97%B6%E4%BC%98%E5%8C%96%E4%BA%86%E5%9C%A8Kubernetes%E7%AD%89%E7%8E%AF%E5%A2%83%E4%B8%AD%E5%8D%B7%E6%8C%82%E8%BD%BD%E7%9A%84%E6%9D%83%E9%99%90%E9%97%AE%E9%A2%98%E3%80%82

核心功能与特性

扩展配置选项

在基础镜像功能之上，新增以下环境变量用于初始化配置：

• DB_NAME：指定要创建的数据库名称
• DB_USER：创建指定名称的登录账户，并在上述数据库中创建具有db_owner权限的用户
• DB_PASSWORD：上述登录账户的密码

运行权限优化

容器以root用户运行，但SQL Server服务本身以mssql用户启动。此设计解决了在Kubernetes等环境中，当挂载卷到/var/opt/mssql时mssql用户可能无法创建文件的问题。容器启动时会先以root权限调整目录权限，确保mssql用户对该目录有访问权限，同时限制其他权限范围。

使用场景

• 开发环境快速部署：无需手动执行SQL脚本即可完成数据库和用户初始化
• 测试环境自动化：配合CI/CD流程实现测试环境的一键部署
• 容器化应用集成：与需要SQL Server数据库的应用快速集成，减少初始化步骤

使用方法与配置说明

环境变量配置

Docker Run示例

bash
docker run -d \
  --name sql-server \
  -e ACCEPT_EULA=Y \
  -e SA_PASSWORD=YourStrong!Passw0rd \
  -e DB_NAME=MyDatabase \
  -e DB_USER=MyUser \
  -e DB_PASSWORD=MyUserPassw0rd \
  -p 1433:1433 \
  your-image-name:tag

Docker Compose示例

yaml
version: '3.8'
services:
  sql-server:
    image: your-image-name:tag
    container_name: sql-server
    environment:
      - ACCEPT_EULA=Y
      - SA_PASSWORD=YourStrong!Passw0rd
      - DB_NAME=MyDatabase
      - DB_USER=MyUser
      - DB_PASSWORD=MyUserPassw0rd
    ports:
      - "1433:1433"
    volumes:
      - sql-data:/var/opt/mssql
volumes:
  sql-data:

注意事项

• 警告：创建数据库和登录的SQL脚本使用envsubst进行环境变量替换，未对特殊字符进行转义处理。数据库名称中请勿包含引号或方括号，以免导致初始化失败。
• 确保SA_PASSWORD符合SQL Server密码复杂度要求（至少8个字符，包含大小写字母、数字和特殊符号）。
• 卷挂载时，容器会自动调整/var/opt/mssql目录权限，无需手动设置。