Skip to content

docs(ansible): update nvidia-container-toolkit manual installation steps#6752

Merged
xmfcx merged 1 commit into
mainfrom
docs/ansible/cuda-container-toolkit
Jan 24, 2026
Merged

docs(ansible): update nvidia-container-toolkit manual installation steps#6752
xmfcx merged 1 commit into
mainfrom
docs/ansible/cuda-container-toolkit

Conversation

@xmfcx
Copy link
Copy Markdown
Contributor

@xmfcx xmfcx commented Jan 23, 2026

Summary

This PR updates the manual installation instructions for the NVIDIA Container Toolkit to reflect the current recommended upstream procedure. The documentation now uses modern APT key handling, updated prerequisites, and a newer CUDA test container.

⚠️ These steps are explicitly marked as recommended manual installation and may differ from the current Ansible role implementation. The role will be aligned in a follow-up change.

Key Changes

  • Clarified installation intent

    • Renamed Manual InstallationManual Installation (Recommended).
    • Added a note explaining the temporary divergence from the Ansible role.
  • Modernized repository setup

    • Replaced deprecated apt-key usage with gpg --dearmor and a signed APT source.
    • Added explicit prerequisites (curl, gnupg2).
  • Updated verification example

    • Switched to a newer CUDA base image:

      • From cuda:12.3.1-runtime-ubuntu20.04
      • To cuda:12.8.1-runtime-ubuntu24.04
    • Updated sample nvidia-smi output accordingly.

Motivation

  • Align documentation with NVIDIA’s current best practices.
  • Avoid deprecated APT workflows that may fail on newer systems.
  • Provide a clearer, copy-paste–safe manual setup for users troubleshooting GPU/container issues.

Testing

  • Documentation-only change.
  • Manual steps validated against current NVIDIA Container Toolkit instructions.

Notes for Reviewers

  • The Ansible role still uses older logic; this PR intentionally documents the preferred approach first.
  • A follow-up PR will update the role implementation to match these steps.

Signed-off-by: Mete Fatih Cırıt <mfc@autoware.org>
@xmfcx xmfcx self-assigned this Jan 23, 2026
@github-actions
Copy link
Copy Markdown

Thank you for contributing to the Autoware project!

🚧 If your pull request is in progress, switch it to draft mode.

Please ensure:

@xmfcx xmfcx added the run:health-check Run health-check label Jan 23, 2026
@xmfcx xmfcx requested a review from mitsudome-r January 23, 2026 14:39
@xmfcx xmfcx merged commit 7d05be4 into main Jan 24, 2026
19 of 20 checks passed
@xmfcx xmfcx deleted the docs/ansible/cuda-container-toolkit branch January 24, 2026 14:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

run:health-check Run health-check

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants