feat: Add .devcontainer.json

Includes a `.devcontainer.json` in the project root to allow users to start a development container in supported supported tools. Updated README.md to include how to make customizations. In vscode at least, the presesne of both `.devcontainer.json` and `.devcontainer/devcontainer.json` brings up a selection menu to choose which to use.

Author: jorge-ortega

.devcontainer.json

@@ -0,0 +1,20 @@
+{
+  "image" : "ghcr.io/rust-gpu/rust-cuda-ubuntu24-cuda12:latest",
+  // Uncoment the following lines to use a Dockerfile instead of a prebuilt image.
+  // "build": {
+  //   "dockerfile": "${localWorkspaceFolder}/container/ubuntu24-cuda12/Dockerfile",
+  //   "context": "${localWorkspaceFolder}"
+  // },
+  "containerEnv": {
+    "NVIDIA_DRIVER_CAPABILITIES": "all"
+  },
+  "runArgs": ["--runtime=nvidia", "--gpus", "all"],
+  "customizations": {
+    "vscode": {
+      "extensions": ["rust-lang.rust-analyzer"]
+    }
+  },
+  "features": {
+    "ghcr.io/devcontainers/features/git:1": {}
+  }
+}

.gitignore

@@ -2,3 +2,4 @@ book
 /target
 Cargo.lock
 **/.vscode
+.devcontainer

README.md

@@ -2,7 +2,7 @@
   <h1>The Rust CUDA Project</h1>
 
   <p>
-    <strong>An ecosystem of libraries and tools for writing and executing extremely fast GPU code fully in 
+    <strong>An ecosystem of libraries and tools for writing and executing extremely fast GPU code fully in
     <a href="https://www.rust-lang.org/">Rust</a></strong>
   </p>
 
@@ -13,7 +13,7 @@
     <span> | </span>
     <a href="guide/src/features.md">Features</a>
   </h3>
-<strong>⚠️ The project is still in early development, expect bugs, safety issues, and things that don't work ⚠️</strong> 
+<strong>⚠️ The project is still in early development, expect bugs, safety issues, and things that don't work ⚠️</strong>
 </div>
 
 <br/>
@@ -94,13 +94,15 @@ cargo build
 
 ## Use Rust-CUDA in Container Environments
 
+The distribution related Dockerfile are located in `container` folder.
+Taking ubuntu 24.04 as an example, run the following command in repository root:
 ```bash
-# The distribution related Dockerfile are located in `container` folder.
-# Taking ubuntu 24.04 as an example, run the following command in repository root:
 docker build -f ./container/ubuntu24/Dockerfile -t rust-cuda-ubuntu24 .
 docker run --rm --runtime=nvidia --gpus all -it rust-cuda-ubuntu24
 ```
 
+A sample `.devcontainer.json` file is also included, configured for Ubuntu 24.02. Copy this to `.devcontainer/devcontainer.json` to make additonal customizations.
+
 ## License
 
 Licensed under either of

rust-toolchain.toml

@@ -1,3 +1,3 @@
 [toolchain]
 channel = "nightly-2025-03-02"
-components = ["clippy", "llvm-tools-preview", "rust-src", "rustc-dev", "rustfmt"]
+components = ["clippy", "llvm-tools-preview", "rust-src", "rustc-dev", "rustfmt", "rust-analyzer"]