diff --git a/README.md b/README.md
index fccb87f..9bb7460 100644
--- a/README.md
+++ b/README.md
@@ -53,15 +53,7 @@ simulation UIs, custom dashboards, and many other.
[`Ubuntu-workspace`](./workspaces/ubuntu-workspace/README.md) - docker as a light-weight Virtual Machine. It
provides isolation of environments, but uses less resources than VMs. Ubuntu-workspace allows to start multiple processes inside the
same docker container, has docker-in-docker, Python and Node.js, and a collection of common applications such as text editors,
-git, supervisord, z-shell etc.
-
-*Versions:*
-
-- *18.04-0.2 - minimalistic, work via terminal (size )*
-- *18.04-0.5 - includes docker-in-docker (size )*
-- *18.04-0.7 - adds browser-based terminal (size )*
-
-Ubuntu-workspace with browser-based terminal can be used on both local and remote server with the same experience.
+git, supervisord, z-shell etc. Ubuntu-workspace with browser-based terminal can be used on both local and remote server with the same experience.
When it runs on the remote server, the access can be restricted with a password, and secured with TLS encryption.
[`Python-Workspace`]
@@ -159,7 +151,7 @@ as a new workspace whenever you want.
and use together.
**You need to deliver results.** If you are a freelancer or contractor, you might want to send your client the whole workspace
-you worked in. This will help your client to reproduce results without bothering you with questions after the contract is closed.
+you worked in. This will help your client to reproduce results without bothering you with questions after the contract is closed.
**You want to improve team's productivity.** The workspace for a serious project includes a lot of tooling, standards and conventions,
secrets and configurations, ssh keys, environmental variables, VPN, and much more. Your team probably would like to do it once.
diff --git a/utils/remote.py b/utils/remote.py
index 3e640b7..bddd78b 100644
--- a/utils/remote.py
+++ b/utils/remote.py
@@ -26,6 +26,10 @@ port_increments = {
}
workspace_meta = {
+ "ubuntu-workspace": {
+ "port-range": 10,
+ "entrypoints": []
+ },
"base-workspace": {
"port-range": 10,
"entrypoints": ["DOCS_URL", "FILEBROWSER_URL", "STATICFS_URL", "CRONICLE_URL", "UNGIT_URL", "TERMINAL_URL", "MC_URL", "HTOP_URL"]
diff --git a/workspaces/ansible-terraform-workspace/README.md b/workspaces/ansible-terraform-workspace/README.md
index 3f26256..4fe1378 100644
--- a/workspaces/ansible-terraform-workspace/README.md
+++ b/workspaces/ansible-terraform-workspace/README.md
@@ -149,17 +149,29 @@ cloud server, and used by multiple users.
+*(you need to implement lock file in Ansible yourself, it is not a standard feature of Ansible.)*
+
+#### Why using workspace
In addition to what's already mentioned, Ansible-Terraform Workspace has the benefits of any other dockerized workspace:
-2) Shareability. You can share your workspace as a whole, with all the dependencies and installed applications. Prepare workspace for the team,
-or deliver as a result to your client. You can even push it to docker hub and make a public contribution.
+- Avoid the tedious process of setting dev environment on your laptop
+- Work conveniently with multiple IT projects on the same laptop
+- Move all your work to another machine instantly
+- Start working right away in the workspace prepared for the task
+- Run dev environment in cloud and work from any device, be independent on any cloud service or cloud provider
+- Back-up entire workspaces with important work, save versions of the workspaces before changes
+- Collaborate by sharing the entire workspace or run it in the cloud
+- Move from dev to POC/MVP in a minute
+- Make experiments (try new packages, versions, frameworks) without risking affecting existing environment
+- With a single command start, stop and resume job schedules, related to the same project
+- Create a custom dev environment for your team, and help new-comers to save time on setting up their environments
+- Move dev environment back and forth between powerful Windows PC and macOS laptop in minutes
-3) Environment in cloud. Start workspace inn cloud rather than on your local machine, and use it from any device.
+Read in detail about the [advantages of the dockerized workspace](https://github.com/bluxmit/alnoda-workspaces/blob/main/README.md#why-workspace-in-docker)
+and the [situations when workspace is a good choice](https://github.com/bluxmit/alnoda-workspaces/blob/main/README.md#use-cases)
-***NOTE:*** you need to implement lock file in Ansible yourself, it is not a standard feature of Ansible.
-
## Launch Workspace
### Start local workspace
diff --git a/workspaces/base-workspace/README.md b/workspaces/base-workspace/README.md
index 1f34190..039a166 100644
--- a/workspaces/base-workspace/README.md
+++ b/workspaces/base-workspace/README.md
@@ -211,7 +211,7 @@ You can also run applications that should run permanently, and run jobs on sched
The simplest deployment of the workkspace requires only 3 steps:
- get virtual server on your favourite cloud (Digital Ocean, Linode, AWS, GC, Azure ...)
-- [install docker](https://docs.docker.com/engine/install/) on this server
+- [install docker](https://docs.docker.com/engine/install/) on this server (often you can get server with docker already installed)
- ssh to the remote server and start workspace
```
diff --git a/workspaces/python-workspace/Dockerfile b/workspaces/python-workspace/Dockerfile
index 34faa48..b6d3414 100644
--- a/workspaces/python-workspace/Dockerfile
+++ b/workspaces/python-workspace/Dockerfile
@@ -14,6 +14,12 @@ RUN pip install -r /home/abc/installed-python-packages/python-requirements.txt \
&& apt-get update \
&& apt-get install -y graphviz \
&& apt-get install -y python-pydot python-pydot-ng \
+ && echo "------------------------------------------------------ utils" \
+ && rm -rf /home/abc/utils || true \
+ && git clone https://github.com/bluxmit/alnoda-workspaces /tmp/alnoda-workspaces \
+ && mv /tmp/alnoda-workspaces/utils /home/abc/ \
+ && echo "alias python-report='/home/abc/utils/python-report.sh'" >> /home/abc/.zshrc \
+ && chmod +x /home/abc/utils/python-report.sh && chown abc /home/abc/utils/python-report.sh \
&& echo "------------------------------------------------------ user" \
&& chown -R abc /home/abc/installed-python-packages \
&& find /home -type d | xargs -I{} chown -R abc {} \
diff --git a/workspaces/ubuntu-workspace/Dockerfile b/workspaces/ubuntu-workspace/Dockerfile
index cf93b63..0492b5f 100644
--- a/workspaces/ubuntu-workspace/Dockerfile
+++ b/workspaces/ubuntu-workspace/Dockerfile
@@ -123,12 +123,13 @@ RUN DEBIAN_FRONTEND=noninteractive apt-get update \
&& curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose \
&& chmod +x /usr/local/bin/docker-compose \
&& echo "------------------------------------------------------ Web-based terminal" \
- && apt-get install -y build-essential cmake libjson-c-dev libwebsockets-dev \
- && cd /tmp && git clone https://github.com/tsl0922/ttyd.git \
- && cd /tmp/ttyd && mkdir build \
- && cd /tmp/ttyd/build && cmake .. \
- && cd /tmp/ttyd/build && make && make install \
- && rm -rf /tmp/ttyd \
+ && cd /tmp && wget https://github.com/tsl0922/ttyd/releases/download/1.6.3/ttyd.aarch64 \
+ && mv ttyd.aarch64 /usr/bin/ttyd \
+ && chmod +x /usr/bin/ttyd \
+ && echo "------------------------------------------------------ utils" \
+ && git clone https://github.com/bluxmit/alnoda-workspaces /tmp/alnoda-workspaces \
+ && mv /tmp/alnoda-workspaces/utils /home/abc/ \
+ && rm -rf /tmp/alnoda-workspaces \
&& echo "------------------------------------------------------ User" \
&& chown abc /home/project \
&& chmod 777 /etc/supervisord/ \
diff --git a/workspaces/ubuntu-workspace/Dockerfile-basic b/workspaces/ubuntu-workspace/Dockerfile-minimal
similarity index 99%
rename from workspaces/ubuntu-workspace/Dockerfile-basic
rename to workspaces/ubuntu-workspace/Dockerfile-minimal
index a7494b7..db9c95c 100644
--- a/workspaces/ubuntu-workspace/Dockerfile-basic
+++ b/workspaces/ubuntu-workspace/Dockerfile-minimal
@@ -12,7 +12,6 @@ RUN DEBIAN_FRONTEND=noninteractive apt-get update \
&& wget https://raw.githubusercontent.com/gdraheim/docker-systemctl-replacement/master/files/docker/systemctl.py -O /usr/local/bin/systemctl \
&& chmod 0777 /usr/local/bin/systemctl \
&& apt-get install -y software-properties-common \
- && apt-get install -y apache2-utils \
&& apt-get install -y zip gzip tar \
&& echo "------------------------------------------------------ User" \
&& useradd -u 8877 abc \
diff --git a/workspaces/ubuntu-workspace/README.md b/workspaces/ubuntu-workspace/README.md
index df48205..54a4d8a 100644
--- a/workspaces/ubuntu-workspace/README.md
+++ b/workspaces/ubuntu-workspace/README.md
@@ -1,20 +1,21 @@
# Ubuntu-workspace
-```Ubuntu-workspace``` - is an attempt to use docker as a lightweight Virtual Machine. It
-provides isolation of environments, but uses fewer resources than VMs.
+Use docker as a lightweight Virtual Machine. Ubuntu-workspace provides isolation of environments,
+but required fewer resources than VMs. USe locally or in cloud.
-Ubuntu-workspace allows to start multiple processes inside the same docker container, has docker-in-docker, Python, and Node.js, and a collection of common applications such as text editors,
-git, supervisord, z-shell, etc. Ubuntu-workspace exposes browser-based terminal and can be used on both local and remote servers providing the same experience.
-When it runs on the remote server, access can be restricted with a password.
+Try it out:
-
-
-
+```
+docker run --name space-1 -d -p 8026:8026 alnoda/ubuntu-workspace
+```
+
+and open localhost:8026 in browser.
## Contents
- * [Use-cases](#use-cases)
- * [Getting started](#getting-started)
+* [About](#about)
+* [Why this workspace](#why-this-workspace)
+* [Getting started](#getting-started)
* [Ports](#ports)
* [Run as root](#run-as-root)
* [Docker in docker](#docker-in-docker)
@@ -35,17 +36,60 @@ When it runs on the remote server, access can be restricted with a password.
* [Java](#java)
* [Run applications permanently](#run-applications-permanently)
-## Use-cases
+
+## About
+
+Ubuntu-workspace comes in 2 versions: minimal an standard. The default version is standard.
+
+### Minimal
+
+Minimal Ubuntu-workspace allows to start multiple processes inside the same docker container, has Python, Node.js (nodeenv),
+and a collection of common applications such as text editors, git, supervisord, z-shell, etc.
Primarily intended as an advanced Ubuntu terminal that runs anywhere, this workspace works best
when you need interactive Linux, python, or node shell for ad-hock tasks.
-Ubuntu workspace is also a basis for building more sophisticated workspaces with UI interfaces.
+
+ Demo: Minimal Ubuntu-workspace
+
-Ubuntu-workspace even can be used as a development environment for those who prefer developing directly in the terminal.
-For those who like more convenient IDE there are more suitable workspaces (for example, workspace-in-docker or codeserver-workspace).
+
+
+
-## Getting started
+### Standard
+
+In addition to the features of the Minimal Ubuntu-workspace, this workspace also has docker-in-docker and a browser-based
+terminal. The latter allows to launch workspace on any cloud server and work with it from any device. When the workspace
+runs on the remote server, access can be restricted with a password, and communication with the server is encrypted.
+
+
+ Demo: Standard Ubuntu-workspace
+
+
+
+
+
+
+
+## Why this workspace
+
+This workspace provides a terminal to the completely isolated Linux environment. This can be quite useful when you need to:
+
+- make experiments (try new packages, versions, stacks, etc.) without risk of affecting the primary environment.
+- collaborate with colleagues easily by sharing the entire workspaces.
+- run background jobs on schedule, and be able to start/stop the whole group of jobs with one action.
+- move the entire local workspace to any powerful cloud server in minutes.
+- back up entire workspaces with important work, and have versions of the workspaces.
+
+More information:
+- [Advantages of the dockerized workspace](https://github.com/bluxmit/alnoda-workspaces/blob/main/README.md#why-workspace-in-docker)
+- [Situations when workspace is a good choice](https://github.com/bluxmit/alnoda-workspaces/blob/main/README.md#use-cases)
+- [The way I use Docker as interactive environment for tries and experiments](https://medium.com/@bluxmit/the-way-i-use-docker-as-interactive-environment-for-tries-and-experiments-52ac06c0ec69)
+- [Docker as a lightweight VM - docker image that you can use as VM substitute](https://medium.com/@bluxmit/docker-as-a-lightweight-vm-docker-image-that-you-can-use-as-vm-substitute-164032e4ed0b)
+
+
+## Launch Workspace
In order to avoid confusion, the following convention is adopted:
@@ -53,14 +97,25 @@ In order to avoid confusion, the following convention is adopted:
command to execute outside of the workspace
```
-> `command to execute inside the workspace (after entering running docker container)`
+> `command to execute inside the workspace (after entering running docker container, or in the browser-based workspace terminal)`
+
+### Start local workspace
+
+In order to **start standard Ubuntu-workspace** open terminal, and execute:
```sh
docker run --name space-1 -d -p 8026:8026 alnoda/ubuntu-workspace
```
-and open your browser on [http://localhost:8026](http://localhost:8026)
+and navigate in browser to [http://localhost:8026](http://localhost:8026)
-You can also ssh into the running workspace container from your console
+Minimal Ubuntu-workspace does not expose any applications, and does not require a port.
+You can **start minimal Ubuntu-workspace** by executin in terminal
+
+```
+docker run --name space-1 -d alnoda/ubuntu-workspace:minimal
+```
+
+Now you can ssh into the running workspace container (both minimal and standard workspaces)
```sh
docker exec -it space-1 /bin/zsh
```
@@ -70,52 +125,78 @@ If you don't want to use z-shell
docker exec -it space-1 /bin/bash
```
-***You can work in Ubuntu via terminal now.***
-
### Ports
-In the example above, the workspace container was started with a port mapping "-p 8026:8026" in order to expose WEB-based terminal.
-This might be useful if you are planning to move your workspace to cloud server or prefer web-based terminal.
-If you are planning to work only locally and prefer your console, you might not need it, and you can start workspace without any port mappings
+In the example above, the standard Ubuntu-workspace container was started with a port mapping "-p 8026:8026" to expose a browser-based terminal.
+Browser-based is especially useful if you are planning to move your workspace to cloud server or prefer web-based terminal over your system terminal.
+Browser-based terminal is true color, and might work better with some of the terminnal-based applications.
+
+Workspace - is an interactive environment, and you often don't know how many applications you will launch when working inside the workspace.
+That's why it is reasonable to allocate a small port range for the workspace. Then you will always have extra ports that you
+can use
```sh
-docker run --name space-1 -d alnoda/ubuntu-workspace
+docker run --name space-1 -d -p 8020-8030:8020-8030 alnoda/ubuntu-workspace
```
-It might be the case that some applications will be installed and launched inside the workspace. In order to use those applications outside the workspace,
-it is necessary to add more port mappings. For example, assume we are planning to install application inside the workspace with web-ui on port 19011
+Sometimes you cannot chose the port applications runs on, and might want to provide it separately when starting the workspace
-```sh
-docker run --name space-1 -d -p 8026:8026 -p 19011:19011 alnoda/ubuntu-workspace
+```
+docker run --name space-1 -d -p 8020-8030:8020-8030 -p 19011:19011 alnoda/ubuntu-workspace
```
-> It is not a problem if you don't expose any ports, but later on realise you need them -
-> you will just create new image, and run it exposing the required port (look in the section [Create new image](#create-new-image))
+**NOTE:** It is not a problem if you don't expose any ports from the start. If later on you realise that other ports are needed,
+you will simply [commit workspace to a new image, and start the workspace again with more ports](#create-new-image).
+
### Run as root
-The default user is **abc** with passwordless sudo to install packages. If you'd rather work as root, then you should ssh into running container as
+
+The default workspace user is **abc**, it has passwordless sudo to install packages. If you'd rather work as root, then you should ssh into running container as
+
```sh
docker exec -it --user=root space-1 /bin/zsh
```
-You can of course open several terminals to the same running containner as both abc and root users at the same time.
+
+You can of course open several terminals to the same running containner as both abc and root users at the same time.
+
+If you plan to work as root user all the time, start workspace as a root in the first place:
+
+```
+docker run --name space-1 -d -p 8020-8030:8020-8030 --user=root alnoda/ubuntu-workspace
+```
+
+**NOTE:** start workspace as a root user if you run workspace for personal use only! If you provide workspace for freelancer, partner,
+collaborator, client or for internal development platform - use default user `abc`.
### Docker in docker
-It is possible to work with docker directly from the workspace.
+Standard Ubuntu-workspace has docker in docker. This means that you can build docker images, start and stop docker
+containers directly from the workspace. In order to enable docker-in-docker start workspace with:
```
docker run --name space-1 -d -p 8026:8026 -v /var/run/docker.sock:/var/run/docker.sock alnoda/ubuntu-workspace
```
-NOTE: in order to use docker in docker you need to or enter into the workspace container as root
+**NOTE:** Default `abc` user will not be able to use docker inside the workspace.
+To use docker in docker you need to or enter into the workspace container as a root user
+
```sh
docker exec -it --user=root space-1 /bin/zsh
```
+*(or launch workspace as root in the first place)*
+
+
+**NOTE:** docker-in-docker is realised by mapping `docker.sock` to the container. This essentially means that
+root user of the workspace has control over all docker containers in the entire system. Allow docker-in-docker
+only for personal use.
+
### Run in cloud
-Running workspaces on the remote server is great for collaboration, heavy workloads or periodic tasks.
-Workspace has WEB-based terminal, and you will be able to use workspace from browser on any device.
+Running workspaces on the remote server is convenient for collaboration (share workspace); running heavy or long-running workloads
+(i.e. simulations); scheduling periodic tasks, and other. Ubuntu-workspace has WEB-based terminal,
+and you will be able to use workspace from any device.
+
It is very easy to run your workspace in cloud on any server. You are completely independent on the
cloud provider, can easily start, stop and move workspaces between servers.
diff --git a/workspaces/ubuntu-workspace/img/ubuntu-workspace-remote.gif b/workspaces/ubuntu-workspace/img/ubuntu-workspace-remote.gif
new file mode 100644
index 0000000..479682c
Binary files /dev/null and b/workspaces/ubuntu-workspace/img/ubuntu-workspace-remote.gif differ