Using Visual Studio Code in Domino Workspaces

Overview


Some Domino Standard Environments support launching Visual Studio Code (VSCode) in interactive Workspaces. VSCode is an open-source multi-language editor maintained by Microsoft. Domino can serve the VSCode application to your browser with the power of code-server from Coder.com.

Prerequisites

VSCode support is available in the latest versions of the following Domino Standard Environments:

  • Domino Analytics Distribution for Python 2.7
    • quay.io/domino/base:Ubuntu18_DAD_Py2.7_R3.5-20190501
  • Domino Analytics Distribution for Python 3.6
    • quay.io/domino/base:Ubuntu18_DAD_Py3.6_R3.5-20190501
  • Domino Analytics Distribution for Python 3.7
    • quay.io/domino/base:Ubuntu18_DAD_Py3.7_R3.5-20190501

See below for instruction to add VSCode to older environments (Link)

 

Contents


 

 

Launching a VSCode Workspace


When using a VSCode-equipped Domino environment, there are two ways to launch the VSCode application.

 

Option 1: Launch VSCode directly


You can launch VSCode directly from the Workspaces dashboard or Quick Action menu, the same way you would launch RStudio or Jupyter.

 

Screen_Shot_2019-05-16_at_9.42.26_AM.png

 

If launched this way, your Workspace will open with the Domino controls around a VSCode editor. You can work with your project files in VSCode, and commit and sync with the Domino Workspace UI as normal.

 

Screen_Shot_2019-05-16_at_9.49.29_AM.png

 

 

Option 2: Launch VSCode from JupyterLab


In VSCode-equipped environments, you will also find VS Code IDE as a notebook option in JupyterLab.

 

Screen_Shot_2019-05-16_at_9.43.16_AM.png

 

If launched this way, JupyterLab will open a new tab that will serve the VSCode application. This editor is running in the same Domino Run container as your JupyterLab application. However, the VSCode tab will not show the Domino Workspace controls. If you want to sync, commit, or stop your Workspace after working in VSCode, you must do so from the JupyterLab tab.

 

 

Installing VSCode extensions


You can use the extensions manager in VSCode to install extensions from the marketplace as you would usually. However, note that these extensions are installed only in the current Workspace session, and will not persist once the session is shut down.

 

Screen_Shot_2019-05-16_at_10.01.25_AM.png

 

To install persistent extensions that will be available in every new VSCode Workspace, you must build them into your environment. Use the following steps to set up such an environment.

  1. Find the extension you want to install in the Visual Studio Marketplace. In this example, we'll install the scala-lang extension.
  2. Microsoft obscures the download URL for the extension by default, so you will need to first open your browser's development tools, then click the Download extension link.

    Screen_Shot_2019-05-16_at_10.11.24_AM.png
  3. You can retrieve the download URL for the extension by looking at the request details in your browser's development tools. It should end with /vspackage. Copy this URL for use in your custom environment.

    Screen_Shot_2019-05-16_at_10.14.00_AM.png
  4. In Domino, create a new environment. As the base image, you must use one of the VSCode-equipped Domino Standard Environments, listed in the prerequisites at the beginning of this article.

    Screen_Shot_2019-05-16_at_10.17.42_AM.png
  5. Add the following instructions to your new environment's Dockerfile, replacing the folder names and example /vspackage URL with the extension URL you retrieved earlier. These commands download the extension, extract the required files, and adds them to the appropriate folder.
    apt-get update -y
    apt-get install -y bsdtar
    mkdir -p /home/ubuntu/.local/share/code-server/extensions/ms-python.python-2019.3.6558 && \
    cd /home/ubuntu/.local/share/code-server/extensions/ms-python.python-2019.3.6558
    curl -JL https://marketplace.visualstudio.com/_apis/public/gallery/publishers/ms-python/vsextensions/python/2019.3.6558/vspackage | bsdtar -xvf - extension
     
    cd /home/ubuntu/.local/share/code-server/extensions/ms-python.python-2019.3.6558/extension/ && mv * ../
    chown ubuntu:ubuntu /home/ubuntu/.local/share/code-server/
    
  6. When finished, click Build. Following a successful build you can use this new environment to launch VSCode Workspace sessions with your desired extensions already installed.

 

 

Installing VSCode to older environments

VSCode can be added to some older environments by adding the following to your compute environment. The base environment must be 2018-05-23 or newer and you must have the Pluggable Tools feature enabled.

You can add the following to your compute environment docker file instructions: 

#note: Make sure you are using the latest release if you'd like the latest version of the workspaces
#https://github.com/dominodatalab/workspace-configs/releases
 
RUN cd /tmp && wget https://github.com/dominodatalab/workspace-configs/archive/2019q2-v1.3.zip && \ 
unzip 2019q2-v1.3.zip && cp -Rf workspace-configs-2019q2-v1.3/vscode /var/opt/workspaces/vscode && \ rm -rf /var/opt/workspaces/workspace-logos && \
rm -rf /tmp/workspace-configs-2019q2-v1.3 RUN \ chmod +x /var/opt/workspaces/vscode/install && sleep 2 && \ /var/opt/workspaces/vscode/install

 and add the following to your compute environment's "Pluggable Workspace Tools":

 
vscode:
 title: "vscode"
 iconUrl: "https://raw.github.com/dominodatalab/workspace-configs/develop/workspace-logos/vscode.svg?sanitize=true"
 start: [ "/var/opt/workspaces/vscode/start" ]
 httpProxy:
    port: 8888

 

 

Was this article helpful?
0 out of 0 found this helpful