docs: Pin the image version explicitly

[HofmeisterAn]

What does this PR do?

This PR updates the docs and explicitly sets the container builder image version. FYI: @digital88 It would be great if you could take a look and let me know if I missed anything.

Why is it important?

-

Related issues

• Relates [Enhancement]: Force user provided image name/tag when creating Builder #1540

Summary by CodeRabbit

Release Notes

• Documentation

  • Updated all code examples to reflect the simplified container initialization pattern
  • Standardized Docker image specifications across all module examples
  • Enhanced examples with explicit image version specifications

• Tests

  • Updated base image versions for Alpine and Nginx to latest stable releases

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[netlify]

✅ Deploy Preview for testcontainers-dotnet ready!

Name	Link
🔨 Latest commit	6b06d7e
🔍 Latest deploy log	https://app.netlify.com/projects/testcontainers-dotnet/deploys/695660399a83800008c6c984
😎 Deploy Preview	https://deploy-preview-1605--testcontainers-dotnet.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 project configuration.

[coderabbitai]

Caution

Review failed

The pull request is closed.

Walkthrough

The PR updates documentation examples and test constants to reflect a constructor-based API pattern where container builders now accept image specifications as parameters instead of using parameterless constructors followed by WithImage() method calls. Alpine and Nginx image tags in test constants are also updated to newer versions.

Changes

Cohort / File(s)	Summary
Core Container API Documentation docs/api/connection_string_provider.md, docs/api/create_docker_container.md, docs/api/create_docker_network.md, docs/api/low_level_api_access.md, docs/api/resource_reaper.md, docs/api/resource_reuse.md, docs/api/wait_strategies.md, docs/index.md	Updated ContainerBuilder usage from parameterless constructor with .WithImage() chaining to constructor accepting image string parameter (e.g., ContainerBuilder("alpine:3.20.0"))
Module Documentation docs/modules/cassandra.md, docs/modules/db2.md, docs/modules/grafana.md, docs/modules/index.md, docs/modules/mssql.md, docs/modules/opensearch.md, docs/modules/playwright.md, docs/modules/postgres.md, docs/modules/pulsar.md	Updated module builders (CassandraBuilder, Db2Builder, GrafanaBuilder, MsSqlBuilder, PostgreSqlBuilder, etc.) to use explicit image parameter constructors; PostgreSqlBuilder now supports string and IImage overloads
Aspnet Example Documentation docs/examples/aspnet.md	Updated RedisBuilder, MsSqlBuilder, and ContainerBuilder instantiations to use image-accepting constructors, removing fluent .WithImage() invocations
Test Constants tests/Testcontainers.Commons/CommonImages.cs	Updated image tag versions: Alpine from 3.17 to 3.20.0; Nginx from 1.22 to 1.26.3-alpine3.20

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related PRs

• testcontainers/testcontainers-dotnet#1606: Updates ContainerBuilder and multiple module builders to use explicit image-accepting constructors with updated call sites and tests.
• testcontainers/testcontainers-dotnet#1600: Introduces ContainerBuilder(string image) constructor with delegation to DockerImage/IImage patterns, removing inline WithImage calls.
• testcontainers/testcontainers-dotnet#1612: Implements the broader API pattern shift requiring explicit image specification in builder constructors and updates corresponding documentation and tests.

Poem

🐰 Hop along, dear builder friends, no more shall you roam,
Images now find their home within the constructor's tome,
With Alpine fresh and Nginx spry in tags so new and bright,
Our APIs now dance with images—what a delightful sight! ✨

✨ Finishing touches

• 📝 Generate docstrings

---

📜 Recent review details

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between e98d679 and 6b06d7e.

📒 Files selected for processing (19)

• docs/api/connection_string_provider.md
• docs/api/create_docker_container.md
• docs/api/create_docker_network.md
• docs/api/low_level_api_access.md
• docs/api/resource_reaper.md
• docs/api/resource_reuse.md
• docs/api/wait_strategies.md
• docs/examples/aspnet.md
• docs/index.md
• docs/modules/cassandra.md
• docs/modules/db2.md
• docs/modules/grafana.md
• docs/modules/index.md
• docs/modules/mssql.md
• docs/modules/opensearch.md
• docs/modules/playwright.md
• docs/modules/postgres.md
• docs/modules/pulsar.md
• tests/Testcontainers.Commons/CommonImages.cs

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[digital88]

The .md files are all covered I think, but there are some files in examples folder, are you going to make a separate PR for updating Builders and pinning images in examples?

[HofmeisterAn]

are you going to make a separate PR for updating Builders and pinning images in examples?

Yes, this will be a separate PR. We need a release first, the examples require a NuGet package (they do not use a project reference).