Skip to content

Commit 994ffa7

Browse files
Merge pull request #27 from ROCm/dev/bhatturu/docs-updates
Cherrypicking docs updates to release branch
2 parents 24952c9 + 2d7f2a2 commit 994ffa7

4 files changed

Lines changed: 48 additions & 5 deletions

File tree

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
# Overview
2-
ROCm Container Toolkit offers tools to streamline the use of AMD GPUs with containers. The toolkit includes the following packages.
2+
AMD Container Toolkit offers tools to streamline the use of AMD GPUs with containers. The toolkit includes the following packages.
33
- ```amd-container-runtime``` - The AMD Container Runtime
44
- ```amd-ctk``` - The AMD Container Toolkit CLI
55

docs/container-runtime/quick-start-guide.rst

Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,17 @@ Quick Start Guide
33

44
This section provides a step-by-step guide to install the AMD Container Toolkit and configure your system for Docker-based GPU container workloads. The steps below are tailored for ease of use, production-readiness, and ensuring compatibility across AMD Instinct GPU-enabled systems.
55

6+
Prerequisites
7+
-------------
8+
9+
Before installing the AMD Container Toolkit, ensure the following dependencies are installed:
10+
11+
1. **jq** - Required during uninstallation to parse configuration settings cleanly.
12+
13+
.. code-block:: bash
14+
15+
sudo apt-get install jq
16+
617
Step 1: Install System Prerequisites
718
------------------------------------
819
- Update your system:
@@ -109,3 +120,35 @@ Step 5: Configure Docker Runtime for AMD GPUs
109120
sudo systemctl restart docker
110121
111122
This configuration ensures that Docker is aware of the AMD container runtime and is able to support GPU-accelerated workloads using AMD Instinct devices.
123+
124+
Uninstallation Guide
125+
--------------------
126+
127+
To remove the `amd-container-toolkit`, you must have `jq` installed. The uninstallation script relies on it to parse configuration files.
128+
129+
.. code-block:: bash
130+
131+
sudo apt-get install jq
132+
133+
Then proceed with the removal:
134+
135+
.. code-block:: bash
136+
137+
sudo apt-get remove --purge amd-container-toolkit
138+
139+
If you encounter issues, inspect the logs:
140+
141+
.. code-block:: bash
142+
143+
sudo journalctl -u apt
144+
145+
sudo tail -f /var/log/amd-container-runtime.log
146+
147+
148+
If you continue to face errors, you may need to force the removal:
149+
150+
.. code-block:: bash
151+
152+
sudo dpkg --remove --force-all amd-container-toolkit
153+
154+
sudo apt-get autoremove

docs/index.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
---
22
myst:
33
html_meta:
4-
"description": "AMD Container Runtime documentation"
4+
"description": "AMD Container Toolkit documentation"
55
"keywords": "AMD, ROCm, Container Runtime, GPU, HPC, Machine Learning"
66
---
77

8-
# AMD ROCm Container Runtime Documentation
8+
# AMD Container Toolkit Documentation
99

10-
This documentation site provides information about the AMD ROCm Container Runtime, which is a set of tools and libraries for running GPU-accelerated applications in containers. The ROCm platform is designed to enable high-performance computing (HPC) and machine learning workloads on AMD GPUs.
10+
This documentation site provides information about the AMD Container Toolkit, which is a set of tools and libraries for running GPU-accelerated applications in containers. The ROCm platform is designed to enable high-performance computing (HPC) and machine learning workloads on AMD GPUs.

docs/sphinx/_toc.yml.in

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ subtrees:
33
- caption: Tools
44
entries:
55
- file: container-runtime/index.rst
6-
title: Container Runtime
6+
title: AMD Container Toolkit
77
subtrees:
88
- entries:
99
- file: container-runtime/overview.rst

0 commit comments

Comments
 (0)