remove references to outdated RAPIDS images

[jameslamb]

Description

Since rapidsai/docker#539, the main RAPIDS docker images intended for end-user deployments have been:

• rapidsai/base (DockerHub link)
• rapidsai/notebooks (DockerHub link)

Any references in the deployment docs to older, no-longer-supported images should be replaced.

Benefits of this work

• reduces friction in updating to the latest RAPIDS releases
• reduces the risk of time wasted by RAPIDS users on things that are no longer supported

Acceptance Criteria

• there are 0 remaining references to any of the images listed under "Deprecated docker repositories" in Repository overhaul for RAPIDS v23.08 docker#539
  • including in static pictures
• there are 0 remaining references to outdated images tags (except where keeping an old reference is an intentional choice)

Approach

Start like this:

git grep -E 'rapidsai/'
git grep -E ':2[0-9]+\.'

Replace those references, wherever appropriate, with rapidsai/base and rapidsai/notebooks.

Try to do so with the templating driven by this:

deployment/source/conf.py

Lines 27 to 42 in 8bd5b05

	versions = {
	"stable": {
	"rapids_version": stable_version,
	"rapids_container": f"nvcr.io/nvidia/rapidsai/base:{stable_version}-cuda11.8-py3.10",
	"rapids_notebooks_container": f"nvcr.io/nvidia/rapidsai/notebooks:{stable_version}-cuda11.8-py3.10",
	"rapids_conda_channels": "-c rapidsai -c conda-forge -c nvidia",
	"rapids_conda_packages": f"rapids={stable_version} python=3.10 cuda-version=11.8",
	},
	"nightly": {
	"rapids_version": f"{nightly_version}-nightly",
	"rapids_container": f"rapidsai/base:{nightly_version + 'a'}-cuda11.8-py3.10",
	"rapids_notebooks_container": f"rapidsai/notebooks:{nightly_version + 'a'}-cuda11.8-py3.10",
	"rapids_conda_channels": "-c rapidsai-nightly -c conda-forge -c nvidia",
	"rapids_conda_packages": f"rapids={nightly_version} python=3.10 cuda-version=11.8",
	},
	}

Uses

List of references that need to be updated:

rapidsai/rapidsai-core image

• examples / rapids-autoscaling-multi-tenant-kubernetes / notebook.ipynb (fix outdated RAPIDS versions #501)

rapidsai/rapidsai image

• examples / rapids-azureml-hpo / Dockerfile (Make AzureML examples more self-contained #484)
• examples / rapids-azureml-hpo / notebook.ipynb (Make AzureML examples more self-contained #484)
• examples / xgboost-azure-mnmng-daskcloudprovider / configs / cloud_init.yaml.j2 (fix outdated RAPIDS versions #501)
• examples / xgboost-rf-gpu-cpu-benchmark / notebook.ipynb (simplify and update XGBoost benchmarking example #500)

rapidsai/rapidsai-nightly image

(None)

23.02 release

• examples / rapids-azureml-hpo / Dockerfile (Make AzureML examples more self-contained #484)
• examples / rapids-autoscaling-multi-tenant-kubernetes / notebook.ipynb (fix outdated RAPIDS versions #501)

23.04 release

(None)

23.06 release

• examples / rapids-azureml-hpo / notebook.ipynb (Make AzureML examples more self-contained #484)
• examples / xgboost-rf-gpu-cpu-benchmark / notebook.ipynb (simplify and update XGBoost benchmarking example #500)

23.08 release

• examples / rapids-autoscaling-multi-tenant-kubernetes / image-prepuller.yaml (fix outdated RAPIDS versions #501)
• examples / rapids-autoscaling-multi-tenant-kubernetes / rapids-notebook.yaml (fix outdated RAPIDS versions #501)
• examples / xgboost-azure-mnmg-daskcloudprovider / notebook.ipynb (fix outdated RAPIDS versions #501)

23.10 release

• examples / time-series-forecasting-with-hpo / notebook.ipynb (fix outdated RAPIDS versions #501)
• examples / xgboost-azure-mnmng-daskcloudprovider / notebook.ipynb (fix outdated RAPIDS versions #501)
• examples / xgboost-rf-gpu-cpu-benchmark / Dockerfile (simplify and update XGBoost benchmarking example #500)

23.12 release

• cloud / gcp / dataproc.md (tracked elsewhere ... see remove references to outdated RAPIDS images #382 (comment))

24.02 release

(None)

24.04 release

• examples / rapids-autoscaling-multi-tenant-kubernetes / notebook.ipynb (fix outdated RAPIDS versions #501)

24.06 release

• README.md (fix outdated RAPIDS versions #501)
• examples / rapids-sagemaker-higgs / notebook.ipynb (fix outdated RAPIDS versions #501)
• examples / rapids-sagemaker-hpo / notebook.ipynb (including screenshots) (fix outdated RAPIDS versions #501)

24.08 release

(None)

[jameslamb]

I've updated the description here with a comprehensive list of the remaining references, so we can see how much work remains.

[jameslamb]

cloud / gcp / dataproc.md

This is the only one left that wouldn't be fixed by an open PR.

These are the outdated references:

deployment/source/cloud/gcp/dataproc.md

Lines 30 to 31 in 3a089c5

	$ RAPIDS_VERSION=23.12
	$ CUDA_VERSION=11.8

The way this example is written, it depends on some init scripts provided as part of Dataproc. There are other issues tracking updating those:

• Outdated initialization scripts for GCP Dataproc #269
• Update initialization scripts to install latest RAPIDS 23.12 OR 24.02 GoogleCloudDataproc/initialization-actions#1137

So I think that once #500 is merged, we can close this issue.

[jameslamb]

Based on #382 (comment), I think this can be called complete!

There are still some examples that haven't been touched in a while and probably need other types of updates, but that can flow through the normal process of development and user-submitted feedback here.