diff --git a/.devcontainer/README.md b/.devcontainer/README.md index 349330dbe0e..10b39d738d2 100644 --- a/.devcontainer/README.md +++ b/.devcontainer/README.md @@ -5,9 +5,14 @@ # CCCL Dev Containers -CCCL uses [Development Containers](https://containers.dev/) to provide consistent and convenient development environments for both local development and for CI. This guide covers setup in [Visual Studio Code](#quickstart-vscode-recommended) and [Docker](#quickstart-docker-manual-approach). +CCCL uses [Development Containers](https://containers.dev/) to provide consistent and convenient development environments for both local development and for CI. This guide covers setup in [Visual Studio Code](#quickstart-vscode-recommended) and [Docker](#quickstart-docker-manual-approach). The guide also provides additional instructions in case the user wants to use WSL. -## Quickstart: VSCode (Recommended) +## Table of Contents +1. [Quickstart: VSCode (Recommended)](#vscode) +2. [Quickstart: Docker (Manual Approach)](#docker) +3. [Quickstart: Using WSL](#wsl) + +## Quickstart: VSCode (Recommended) ### Prerequisites - [Visual Studio Code](https://code.visualstudio.com/) @@ -55,7 +60,7 @@ To manually trigger this authentication, execute the `devcontainer-utils-vault-s For more information about the sccache configuration and authentication, see the documentation at [`rapidsai/devcontainers`](https://github.com/rapidsai/devcontainers/blob/branch-23.10/USAGE.md#build-caching-with-sccache). -## Quickstart: Docker (Manual Approach) +## Quickstart: Docker (Manual Approach) ### Prerequisites - [Docker](https://docs.docker.com/desktop/install/linux-install/) @@ -117,7 +122,7 @@ For more information, see the `.devcontainer/make_devcontainers.sh --help` messa **Note**: When adding or updating supported environments, modify `matrix.yaml` and then rerun this script to synchronize the `devcontainer` configurations. -## Dev Containers on WSL +## Quickstart: Using WSL > [!NOTE] > _Make sure you have the Nvidia driver installed on your Windows host before moving further_. Type in `nvidia-smi` for verification. @@ -141,7 +146,6 @@ This should probably install Ubuntu distro as a default. 4. Launch your WSL/Ubuntu terminal by running `wsl` in Powershell. - 5. Install the [WSL extension](ms-vscode-remote.remote-wsl) on VS Code. - `Ctrl + Shift + P` and select `WSL: Connect to WSL` (it will prompt you to install the WSL extension). @@ -154,7 +158,7 @@ This should probably install Ubuntu distro as a default. 7. Install the [NVIDIA Container Toolkit](https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/latest/install-guide.html). **Make sure you install the WSL 2 version and not the native Linux one**. This builds on top of Docker so make sure you have Docker properly installed (run `docker --version`). -8. Open `/etc/docker/daemon.json` (if the file does not exist, create it) and add the following: +8. Open `/etc/docker/daemon.json` from within your WSL system (if the file does not exist, create it) and add the following: ```json { @@ -192,4 +196,3 @@ From that point on, the guide aligns with our [existing Dev Containers native Li Please try entering the URL in your browser manually In that case type in the address manually in your web browser https://github.com/login/device and fill in the one-time code. - diff --git a/.devcontainer/cuda11.8-gcc11/devcontainer.json b/.devcontainer/cuda11.8-gcc11/devcontainer.json index 94d3c0e9d79..b58f0c6ea7b 100644 --- a/.devcontainer/cuda11.8-gcc11/devcontainer.json +++ b/.devcontainer/cuda11.8-gcc11/devcontainer.json @@ -2,7 +2,7 @@ "shutdownAction": "stopContainer", "image": "rapidsai/devcontainers:24.04-cpp-gcc11-cuda11.8-ubuntu22.04", "hostRequirements": { - "gpu": true + "gpu": "optional" }, "initializeCommand": [ "/bin/bash",