Chore: docker quickstart getting started (#28)

Author: CircArgs

Dockerfile

@@ -0,0 +1,33 @@
+FROM nvidia/cuda:11.4.2-cudnn8-devel-ubuntu18.04
+
+# Update default packages
+RUN apt-get update
+
+# Get Ubuntu packages
+RUN apt-get install -y \
+    build-essential \
+    curl xz-utils pkg-config libssl-dev zlib1g-dev libtinfo-dev libxml2-dev
+
+# Update new packages
+RUN apt-get update
+
+# Get Rust
+RUN curl https://sh.rustup.rs -sSf | bash -s -- -y
+
+
+# get prebuilt llvm
+# COPY clang+llvm-7.0.1-x86_64-linux-gnu-ubuntu-18.04.tar.xz .
+RUN curl -O https://releases.llvm.org/7.0.1/clang+llvm-7.0.1-x86_64-linux-gnu-ubuntu-18.04.tar.xz &&\
+    xz -d /clang+llvm-7.0.1-x86_64-linux-gnu-ubuntu-18.04.tar.xz &&\
+    tar xf /clang+llvm-7.0.1-x86_64-linux-gnu-ubuntu-18.04.tar &&\
+    rm /clang+llvm-7.0.1-x86_64-linux-gnu-ubuntu-18.04.tar &&\
+    mv /clang+llvm-7.0.1-x86_64-linux-gnu-ubuntu-18.04 /root/llvm
+
+# set env
+ENV LLVM_CONFIG="/root/llvm/bin/llvm-config"
+ENV CUDA_ROOT="/usr/local/cuda"
+ENV CUDA_PATH=$CUDA_ROOT
+ENV LLVM_LINK_STATIC=1
+ENV RUST_LOG=info
+ENV PATH="$CUDA_ROOT/nvvm/lib64:/root/.cargo/bin:$PATH"
+ENV LD_LIBRARY_PATH=$PATH

guide/src/guide/getting_started.md

@@ -188,3 +188,18 @@ static PTX: &str = include_str!("some/path.ptx");
 ```
 
 Then execute it using cust.
+
+## Docker
+
+There is also a [Dockerfile](Dockerfile) prepared as a quickstart with all the necessary libraries for base cuda development.
+
+You can use it as follows (assuming your clone of Rust-CUDA is at the absolute path `RUST_CUDA`):
+
+ - Build `docker build -t rust-cuda $RUST_CUDA`
+ - Run `docker run -it -v $RUST_CUDA:/root/rust-cuda --entrypoint /bin/b
+ash rust-cuda`
+
+Running will drop you into the container
+s shell and you will find the project at `~/rust-cuda`
+
+Note: refer to [rust-toolchain][#rust-toolchain] to ensure you are using the correct toolchain in your project.