Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/dominodatalab/workspace-configs
https://github.com/dominodatalab/workspace-configs
Last synced: 29 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/dominodatalab/workspace-configs
- Owner: dominodatalab
- Created: 2018-03-26T23:29:36.000Z (over 6 years ago)
- Default Branch: develop
- Last Pushed: 2022-08-22T14:37:51.000Z (over 2 years ago)
- Last Synced: 2023-08-07T03:05:39.693Z (over 1 year ago)
- Language: Shell
- Homepage:
- Size: 547 KB
- Stars: 15
- Watchers: 24
- Forks: 26
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# workspace-configs
# Usage
In your docker file, you are going to want to download this repo and then use the install scripts for the notebooks you'd like to use.
Make sure you using the latest tag/release (e.g. 2021q1-v1 in the example). **Do not use the develop branch.**
```bash
# 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/latest
RUN mkdir -p /var/opt/workspaces && cd /tmp && \
wget https://github.com/dominodatalab/workspace-configs/archive/2021q1-v1.zip && \
unzip 2021q1-v1.zip && \
cp -Rf workspace-configs-2021q1-v1/* /var/opt/workspaces && \
rm -rf /var/opt/workspaces/workspace-logos /var/opt/workspaces/README.md && \
rm -rf /tmp/workspace-configs-2021q1-v1 /tmp/2021q1-v1.zip
# Or you can also use the latest un-released changes from this repo
RUN mkdir -p /var/opt/workspaces && cd /tmp && \
wget https://github.com/dominodatalab/workspace-configs/archive/refs/heads/develop.zip && \
unzip develop.zip && \
cp -Rf workspace-configs-develop/* /var/opt/workspaces && \
rm -rf /var/opt/workspaces/workspace-logos /var/opt/workspaces/README.md && \
rm -rf /tmp/workspace-configs-develop /tmp/develop.zip
```
Add the desired workspaces to your Dockerfile instructions:
```bash
# Install Jupyter from workspaces
RUN chmod +x /var/opt/workspaces/jupyter/install && /var/opt/workspaces/jupyter/install
# Install Jupyter Lab from workspaces
RUN chmod +x /var/opt/workspaces/Jupyterlab/install && /var/opt/workspaces/Jupyterlab/install
# Install R Studio from workspaces
RUN chmod +x /var/opt/workspaces/rstudio/install && /var/opt/workspaces/rstudio/install
# Install ttyd Terminal from workspaces
RUN chmod +x /var/opt/workspaces/ttyd/install && /var/opt/workspaces/ttyd/install
# Install VS Code from workspaces
RUN chmod +x /var/opt/workspaces/vscode/install && /var/opt/workspaces/vscode/install
# Install H2O Flow from workspaces
RUN chmod +x /var/opt/workspaces/h2o/install && /var/opt/workspaces/h2o/install
# Install Zeppelin from workspaces
RUN chmod +x /var/opt/workspaces/Zeppelin/install && /var/opt/workspaces/Zeppelin/install
```
Add the `properties.yaml` to Pluggable Workspace Tools.
Workspace Properties:
- [Jupyter](/jupyter/properties.yaml)
- [Jupyter Lab](/Jupyterlab/properties.yaml)
- [R Studio](/rstudio/properties.yaml)
- [ttyd Terminal](/ttyd/properties.yaml)
- [VS Code](/vscode/properties.yaml)
- [H2O Flow](/h2o/properties.yaml)
- [Zeppelin](/Zeppelin/properties.yaml)
# Project Structure
Create a directory for each workspace application -- e.g. jupyter, rstudio.
In that directory, create these files:
1. `install` - A Bash script for installing the application and its required packages, and for adding static configuration files.
_This script will be executed as root when building the Docker image for the environment that will offer this workspace application._
2. `init` - An optional Bash script for configuring the workspace application just before it starts.
For instance, for creating a customized configuration file from a template, using environment variables.
_This script will be executed as root in the post-setup script of a Domino run, when launching an workspace, so it will have access to write to any file._
3. `start` - A Bash script for launching the workspace application.
This script must start the application's web server and block until that process is terminated.
_It will be executed as a regular user as part of the run launch command._
4. `properties.yaml` - This is a text file in YAML format specifying the Domino configuration properties for launching instances of this workspace.
5. `etc/` - An optional directory containing any additional files that are required by the scripts mentioned above.
For instance, configuration files, or templates for generating configuration files.
Make all of bash scripts files executable:
```bash
chmod +x install start start
```