Skip to content

[DOCS-1697] Replace Bitnami images with official project images, avoid using :latest tags for third-party container images#1525

Closed
mdlinville wants to merge 9 commits into
mainfrom
fix/DOCS-1697-replace-bitnami-images
Closed

[DOCS-1697] Replace Bitnami images with official project images, avoid using :latest tags for third-party container images#1525
mdlinville wants to merge 9 commits into
mainfrom
fix/DOCS-1697-replace-bitnami-images

Conversation

@mdlinville

@mdlinville mdlinville commented Aug 15, 2025

Copy link
Copy Markdown
Contributor

DOCS-1697 Replace Bitnami images with official project images, avoid using :latest tags for third-party container images

Summary

This PR addresses DOCS-1697 by replacing Bitnami Redis image with the official Redis image, using a minor version which will get patch updates automatically without unplanned major-version upgrades. This is in response to Bitnami's transition from free to paid model by the end of the month.

Additionally, it updates third-party images to avoid using :latest in favor of stable minor versions.

It does not update official wandb images, which continue to use :latest, but it does add some comments to the manifest to encourage the reader to consider pinning at a major version.

Ready for technical review

Changes Made

Bitnami Redis Replacement (Initial Commit)

  • Replaced: docker.io/bitnami/redis:7.2.4-debian-12-r9redis:7.2
  • Rationale: Using official Redis image with minor version pinning for automatic security patches
  • Files: All airgapped operator documentation (EN/JA/KO)

High Priority: Replace :latest Tags

  1. TensorFlow GPU Images

    • Replaced: tensorflow/tensorflow:latest-gputensorflow/tensorflow:2.16-gpu
    • Rationale: Prevents breaking changes from major version updates
    • Files: All launch documentation referencing TensorFlow GPU
  2. W&B Launch Agent

    • Action: Added comments recommending version pinning for production
    • Rationale: W&B officially maintains this image; kept :latest but added guidance
    • Files: Kubernetes setup documentation (EN/JA/KO)

Medium Priority: Patch → Minor Versions

  1. Prometheus Images

    • quay.io/prometheus/prometheus:v2.47.0v2.47
    • quay.io/prometheus-operator/prometheus-config-reloader:v0.67.0v0.67
  2. OpenTelemetry Collector

    • otel/opentelemetry-collector-contrib:0.97.00.97

Rationale: Minor version pinning enables automatic security and bug fix updates while avoiding breaking changes

Testing

  • Verified all image references are updated
  • Checked documentation builds correctly
  • Confirmed no broken links or references

Notes

  • W&B's own images (controller, console) remain on patch versions as per their release policy
  • All changes applied consistently across English, Japanese, and Korean documentation

Related JIRA: DOCS-1697

📄 View preview links for changed pages

…docs

- Remove CRD example from non-airgapped instructions
- Add back values.yaml and configuration reference in non-airgapped instructions
- Add Basic Example heading to go with Complete Example heading
- Fix step numbering
… docs

- Update Docker Hub reference from bitnami/redis to official redis image
- Change version from specific patch 7.2.4-debian-12-r9 to minor 7.2
- Apply changes to English, Japanese, and Korean documentation
- Addresses DOCS-1697 Bitnami transition to paid model
High priority changes:
- Replace tensorflow/tensorflow:latest-gpu with tensorflow/tensorflow:2.16-gpu
- Add comments for wandb/launch-agent:latest recommending version pinning
- Apply changes to English, Japanese, and Korean documentation
- Addresses DOCS-1697 to improve image version stability
Medium priority changes:
- Update Prometheus images from v2.47.0 to v2.47 and v0.67.0 to v0.67
- Update OpenTelemetry collector from 0.97.0 to 0.97
- Apply to English, Japanese, and Korean documentation
- Enables automatic patch updates for security and bug fixes
- Addresses DOCS-1697 for better version management
@mdlinville mdlinville requested a review from a team as a code owner August 15, 2025 21:41
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Aug 15, 2025

Copy link
Copy Markdown

Deploying docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: 7977356
Status: ✅  Deploy successful!
Preview URL: https://abf4c19a.docodile.pages.dev
Branch Preview URL: https://fix-docs-1697-replace-bitnam.docodile.pages.dev

View logs

@github-actions

github-actions Bot commented Aug 15, 2025

Copy link
Copy Markdown
Contributor

PR Preview: Changed content

Base preview: https://fix-docs-1697-replace-bitnam.docodile.pages.dev

Modified

Title Path
Run W&B Server on Kubernetes content/en/guides/hosting/hosting-options/self-managed/kubernetes-operator/_index.md
Kubernetes operator for air-gapped instances content/en/guides/hosting/hosting-options/self-managed/kubernetes-operator/operator-airgapped.md
How do I make W&B Launch work with Tensorflow on GPU? content/en/launch/launch-faq/launch_tensorflow_gpu.md
Tutorial: Set up W&B Launch with Docker content/en/launch/set-up-launch/setup-launch-docker.md
Tutorial: Set up W&B Launch on Kubernetes content/en/launch/set-up-launch/setup-launch-kubernetes.md
Configure launch queue content/en/launch/set-up-launch/setup-queue-advanced.md
エアギャップインスタンス用の Kubernetes オペレーター content/ja/guides/hosting/hosting-options/self-managed/kubernetes-operator/operator-airgapped.md
W&B Launch を GPU 上での Tensorflow と連携させるにはどうすればよいですか? content/ja/launch/launch-faq/launch_tensorflow_gpu.md
チュートリアル: Docker を使用して W&B ローンンチを設定する content/ja/launch/set-up-launch/setup-launch-docker.md
チュートリアル: Kubernetes上でW&B ローンンチ を設定する content/ja/launch/set-up-launch/setup-launch-kubernetes.md
ローンンチキューを設定する content/ja/launch/set-up-launch/setup-queue-advanced.md
Kubernetes operator for air-gapped instances content/ko/guides/hosting/hosting-options/self-managed/kubernetes-operator/operator-airgapped.md
How do I make W&B Launch work with Tensorflow on GPU? content/ko/launch/launch-faq/launch_tensorflow_gpu.md
Tutorial: Set up W&B Launch with Docker content/ko/launch/set-up-launch/setup-launch-docker.md
Tutorial: Set up W&B Launch on Kubernetes content/ko/launch/set-up-launch/setup-launch-kubernetes.md
Configure launch queue content/ko/launch/set-up-launch/setup-queue-advanced.md

@mdlinville mdlinville changed the title Replace Bitnami and :latest Docker tags with stable versions [DOCS-1697] [DOCS-1697] Replace Bitnami images with official project images, avoid using :latest tags for third-party container images Aug 15, 2025
@mdlinville mdlinville requested a review from flamarion August 15, 2025 21:48
@mdlinville mdlinville requested a review from dmitryduev August 15, 2025 22:18
@mdlinville

Copy link
Copy Markdown
Contributor Author

@dmitryduev Brenda thought you could help review this change too. Thank you. :)

@fdsig fdsig requested a review from boshwandb August 16, 2025 08:38
@mdlinville mdlinville marked this pull request as draft August 22, 2025 17:33
@mdlinville

Copy link
Copy Markdown
Contributor Author

I'll close this one in favor of #1562 but we should revisit reliance on latest tags of container images. It's not a good production practice.

@mdlinville mdlinville closed this Aug 29, 2025
@mdlinville mdlinville deleted the fix/DOCS-1697-replace-bitnami-images branch September 4, 2025 23:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants