feat: add module to support Microsoft SQL Server

[agosmou]

What does this PR do?

• Adds the MSSQL module for quick bootstrapping on projects that require MS SQL Server in Docker for testing in. Scoffolding done following these instructions

Preface: MS SQL Server Docker Container

Minimum required environment variables to start a mssql container:

• password
• port
• accept license agreement

MS SQL Server Docker image:

• mcr.microsoft.com/mssql/server:2022-CU10-ubuntu-22.04 - source

---

Critical File Notes

• modules/mssql.go

  • docker image default
    • const defaultImage = "mcr.microsoft.com/mssql/server:2022-CU10-ubuntu-22.04"
  • The Microsoft SQL Server default Systems Administrator account username is "sa." This MUST be used in the connection string, as it is the default user on creation, so it can be 'hard-entered' into the connection string, but I set it as a constant for clarity.
    • defaultUsername = "sa" // default microsoft system administrator
  • Microsoft requires the users accepts an End User Licensing Agreement (EULA) so this is done manually by the user using the method:
    • func WithAcceptEULA( )
  • Microsoft has a password 'minimum strength' policy for their containers. I set the password as a constant for user convenience, but they are able to set their own password if they wish with the method:
    • func WithPassword(password string)
  • The connection string method takes variadic parameters following the convention from Microsoft's mssql module
    • sqlserver://username:password@host:port?param1=value&param2=value

• modules/mssql_test.go

  • Standard Test
    • TestMSSQLServer
  • EULA Option Validation
    • Microsoft requires the user accepta the EULA. source. Failure to accept, by omitting the WithAcceptEula() method, will not allow the container to be created
      • TestMSSQLServerWithMissingEulaOption
  • Connection String Test
    • TestMSSQLServerWithConnectionStringParameters
      • e.g. connectionString, err := container.ConnectionString(ctx, "encrypt=false", "TrustServerCertificate=true")
  • Password Validation Tests: confirms Microsoft's docker image service handles their password validation
    • proper
      • TestMSSQLServerWithCustomStrongPassword
    • improper
      • TestMSSQLServerWithInvalidPassword
  • Substituting Image Test
    • TestMSSQLServerWithAlternativeImage
      • e.g. mcr.microsoft.com/mssql/server:2019-latest

• modules/examples_test.go

  • Typical End-User Example: tests typical container example demonstrating the acceptance of the EULA and adding a custom password.
    • ExampleRunContainer()

• docs/modules/mssql.md

  • EULA warning is highlighted on the documentation page as seen here
  • The connection string method takes variadic parameters and is demonstrated on the bottom of the page

Why is it important?

• To better facilitate testing with Microsoft SQL Server in docker with Go using the testcontainers-go library

Related issues

• Closes [Feature]: Add MSSQLServer module #1789

[netlify]

✅ Deploy Preview for testcontainers-go ready!

Name	Link
🔨 Latest commit	639d26c
🔍 Latest deploy log	https://app.netlify.com/sites/testcontainers-go/deploys/657023a52a615e0008683025
😎 Deploy Preview	https://deploy-preview-1969--testcontainers-go.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify site configuration.

[agosmou]

@mdelapenya

I made some minor changes after I saw the linting failed. It should be all set now - minor cleanup on tests.

db4662d

[agosmou]

@mdelapenya

latest commit e70e482

• adjust docker image to a fixed, stable version in lieu of the 'latest'
• moves docker image constant into the constant block
• adds documentation for WithAcceptEULA and WithPassword

[mdelapenya]

LGTM! I suggested the fix for the double-spaced lines, so I'll commit them and merge this PR.

Thanks for your time working in this cool module! Much appreciated!

PS: because the module catalog project is in a private repo, I'll submit it asap and it will appear there really soon.

[mdelapenya]

BTW, I did not mention before, but excellent job with the PR description 👏 Really glad I can read it and drive the review from there.