Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/batiati/mssql-testing
Microsoft SQL Server Docker image with some convenience tools for software testing
https://github.com/batiati/mssql-testing
datetime docker libfaketime mssql mssqlserver test-automation testing
Last synced: 3 days ago
JSON representation
Microsoft SQL Server Docker image with some convenience tools for software testing
- Host: GitHub
- URL: https://github.com/batiati/mssql-testing
- Owner: batiati
- License: unlicense
- Created: 2021-07-08T01:01:29.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2021-10-04T12:41:32.000Z (about 3 years ago)
- Last Synced: 2024-10-12T07:21:06.964Z (about 1 month ago)
- Topics: datetime, docker, libfaketime, mssql, mssqlserver, test-automation, testing
- Language: PowerShell
- Homepage:
- Size: 14.6 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# mssql-testing
### Microsoft SQL Server Docker image with some convenience tools for software testing
## 1. Motivation
Microsoft SQL Server Docker's image is such a great way to deploy databases for development and testing purposes, however, the official image is strongly focused on production deployment, making testing and local deployments harder than it should be.
This project adds some helpful features on top of the official image, making life easier for those whom just need the to start an existing database.
## 2. Features
- Attach databases from a JSON file
**ATTACH_PATH** env variable, must be a path for a file or directory containing one or more `.json` files, each consisting of an array of databases, which can have zero to N databases.
*dbName*: The name of the database
*dbFiles*: An array of one or many absolute paths to the .MDF and .LDF files.
Example:
```JSON
[
{
"dbName": "MaxDb",
"dbFiles": ["/volume/maxtest/maxtest.mdf",
"/volume/maxtest/maxtest_log.ldf"]
},
{
"dbName": "PerryDb",
"dbFiles": ["/volume/perrytest/perrytest.mdf",
"/volume/perrytest/perrytest_log.ldf"]
}
]
```
- Enable CLR Y|N
**ENABLE_CLR** env variable, must be "Y" to enable the common language runtime (CLR), enabling .Net assemblies to run as stored procedures.
- No-Policy weak passwords
**SA_NO_POLICY_PASSWORD** env variable, allowing to define a weak password, such as "1234".
Note that **SA_PASSWORD** is still required and must be set with a strong password, which will be reset by the weak one if defined
- Configurable AUTO_CLOSE ON|OFF
**AUTO_CLOSE** env variable, can be set to "ON" to enabled database auto close when no connections were active. Default is "OFF"
- Configurable MAX_MEMORY
**MAX_MEMORY** env variable, can be set to an integer representing the max amount of megabytes used by SQL cache.
- Execute your SQL Server in a fake datetime
**RUN_AS_DATE** env variable, can be set to a date in the `yyyy-MM-dd` format, regardless of the system clock.
Very useful to test business logic that are time-dependant.
Please refer to [Lib dateoffset](https://github.com/batiati/dateoffset) for more details.
## 3. Usage:
Docker hub:
https://hub.docker.com/r/batiati/mssql-testing
Docker pull command:
```bash
docker pull batiati/mssql-testing
```
Running a container:
```bash
docker run -d \
-p 1433:1433 \
-v /volume:/volume \
-e ACCEPT_EULA=Y \
-e SA_PASSWORD="St5rOng%Pass@rD_" \
-e ATTACH_PATH="/volume/attach.json" \
-e ENABLE_CLR=Y \
-e SA_NO_POLICY_PASSWORD="1234" \
-e AUTO_CLOSE=ON \
-e MAX_MEMORY=1024
-e RUN_AS_DATE="2019-11-25"
-e TZ=America/Sao_Paulo
batiati/mssql-testing
```
## 4. Building
```bash
git clone https://github.com/batiati/mssql-testing ./mssql-testing
cd ./mssql-testing
docker build . --tag mssql-testing
```
## 5. License
* This project is a free and unencumbered software released into the public domain. Plese visit [unlicense.org](https://unlicense.org/) for more details.