Containers: Add VS Code tasks and improve overall documentation & flexibility

Dockerfile

@@ -13,15 +13,18 @@ ENV SHELL=/bin/bash
 RUN sudo apt-get update && sudo apt-get install unzip -y
 RUN curl https://rclone.org/install.sh | sudo bash
 
+# Copy rclone tasks to /tmp, to potentially be used
+COPY deploy-container/rclone-tasks.json /tmp/rclone-tasks.json
+
+# Fix permissions for code-server
+RUN sudo chown -R coder:coder /home/coder/.local
+
 # You can add custom software and dependencies for your environment here. Some examples:
 
 # RUN code-server --install-extension esbenp.prettier-vscode
 # RUN sudo apt-get install -y build-essential
 # RUN COPY myTool /home/coder/myTool
 
-# Fix permissions for code-server
-RUN sudo chown -R coder:coder /home/coder/.local
-
 # Port
 ENV PORT=8080
 

deploy-container/README.md

@@ -13,12 +13,13 @@ Docker Hub: `bencdr/code-server-deploy-container`
 
 ## Environment variables:
 
-| Variable Name | Description                                                | Default Value |
-| ------------- | ---------------------------------------------------------- | ------------- |
-| `PASSWORD`    | Password for code-server                                   |
-| `USE_LINK`    | Use code-server --link instead of a password (coming soon) | false         |
-| `GIT_REPO`    | A git repository to clone                                  |               |
-
+| Variable Name     | Description                                                                                      | Default Value       |
+| ----------------- | ------------------------------------------------------------------------------------------------ | ------------------- |
+| `PASSWORD`        | Password for code-server                                                                         |                     |
+| `HASHED_PASSWORD` | Overrrides PASSWORD. [SHA-256 hash](https://xorbin.com/tools/sha256-hash-calculator) of password |
+| `USE_LINK`        | Use code-server --link instead of a password (coming soon)                                       | false               |
+| `GIT_REPO`        | A git repository to clone                                                                        |                     |
+| `START_DIR`       | The directory code-server opens (and clones repos in)                                            | /home/coder/project |
 ---
 
 ## 💾 Persist your filesystem with `rclone`
@@ -44,18 +45,21 @@ Now, you can add the following the environment variables in the code-server clou
 
 | Environment Variable | Description                                                                                                                                           | Default Value                                | Required |
 | -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------- | -------- |
-| RCLONE_DATA          | the encoded rclone config you copied in step 3                                                                                                        | n/a                                          | ✅       |
+| RCLONE_DATA          | the encoded rclone config you copied in step 3                                                                                                        | n/a                                          | ✅        |
 | RCLONE_REMOTE_NAME   | the name of the remote you added in step 2.<br />check with `$ rclone listremotes`                                                                    | code-server-remote                           |          |
 | RCLONE_SOURCE        | source directory to sync files in the code-server container                                                                                           | the project directory: `/home/coder/project` |          |
 | RCLONE_DESTINATION   | the path in the remote that rclone syncs to. change this if you have multiple code-server environments, or if you want to better organize your files. | code-server-files                            |          |
-
+| RCLONE_VSCODE_TASKS  | import push and pull shortcuts into VS Code ![rclone screenshot from VS Code](../img/rclone-vscode-tasks.png)                                     | true                                         |
 ```sh
 
-# How to use:
+# --- How to use ---
 
+# Terminal:
 $ sh /home/coder/push_remote.sh # save your uncomitted files to the remote
-
 $ sh /home/coder/pull_remote.sh # get latest files from the remote
+
+# In VS Code:
+# ctrl + P, run task: push_remote or pull_remote
 ```
 
 ---

deploy-container/entrypoint.sh

@@ -1,20 +1,45 @@
 #!/bin/bash
 
-START_DIR=/home/coder/project
+START_DIR="${START_DIR:-/home/coder/project}"
+
+PREFIX="deploy-code-server"
+
+mkdir -p $START_DIR
+
+# function to clone the git repo or add a user's first file if no repo was specified.
+project_init () {
+    [ -z "${GIT_REPO}" ] && echo "[$PREFIX] No GIT_REPO specified" && echo "Example file. Have questions? Join us at https://community.coder.com" > $START_DIR/coder.txt || git clone $GIT_REPO $START_DIR
+}
 
 # add rclone config and start rclone, if supplied
 if [[ -z "${RCLONE_DATA}" ]]; then
-    echo "RCLONE_DATA is not specified. Files will not persist"
+    echo "[$PREFIX] RCLONE_DATA is not specified. Files will not persist"
 
-    # Clone the git repo, if it exists
-    [ -z "${GIT_REPO}" ] && echo "No GIT_REPO specified"; git clone $GIT_REPO $START_DIR
+    # start the project
+    project_init
 
 else
-    echo "Copying rclone config..."
+    echo "[$PREFIX] Copying rclone config..."
     mkdir -p /home/coder/.config/rclone/
     touch /home/coder/.config/rclone/rclone.conf
     echo $RCLONE_DATA | base64 -d > /home/coder/.config/rclone/rclone.conf
 
+    # defasult to true
+    RCLONE_VSCODE_TASKS="${RCLONE_VSCODE_TASKS:-true}"
+
+    if [ $RCLONE_VSCODE_TASKS = "true" ]; then
+        # copy our tasks config to VS Code
+        echo "[$PREFIX] Applying VS Code tasks for rclone"
+        cp /tmp/rclone-tasks.json /home/coder/.local/share/code-server/User/tasks.json
+        # install the extension to add to menu bar
+        code-server --install-extension actboy168.tasks&
+    else
+        # user specified they don't want to apply the tasks
+        echo "[$PREFIX] Skipping VS Code tasks for rclone"
+    fi
+
+
+
     # Full path to the remote filesystem
     RCLONE_REMOTE_PATH=${RCLONE_REMOTE_NAME:-code-server-remote}:${RCLONE_DESTINATION:-code-server-files}
     RCLONE_SOURCE_PATH=${RCLONE_SOURCE:-$START_DIR}
@@ -23,17 +48,18 @@ else
     chmod +x push_remote.sh pull_remote.sh
 
     if rclone ls $RCLONE_REMOTE_PATH; then
-        # grab the files from the remote instead of re-cloning the git repo
-        echo "Pulling existing files from remote..."
+        # grab the files from the remote instead of running project_init()
+        echo "[$PREFIX] Pulling existing files from remote..."
         /home/coder/pull_remote.sh&
     else
         # we need to clone the git repo and sync
-        echo "Pushing initial files to remote..."
-        [ -z "${GIT_REPO}" ] && echo "No GIT_REPO specified" && mkdir -p $START_DIR && echo "intial file" > $START_DIR/file.txt; git clone $GIT_REPO $START_DIR
+        echo "[$PREFIX] Pushing initial files to remote..."
+        project_init
         /home/coder/push_remote.sh&
     fi
 
 fi
 
+echo "[$PREFIX] Starting code-server..."
 # Now we can run code-server with the default entrypoint
 /usr/bin/entrypoint.sh --bind-addr 0.0.0.0:8080 $START_DIR

deploy-container/rclone-tasks.json

@@ -0,0 +1,33 @@
+{
+  "version": "2.0.0",
+  "tasks": [
+    {
+      "label": "push_remote",
+      "type": "shell",
+      "command": "sh /home/coder/push_remote.sh",
+      "presentation": {
+        "reveal": "always"
+      },
+      "problemMatcher": [],
+      "options": {
+        "statusbar": {
+          "label": "$(repo-push) rclone: push"
+        }
+      }
+    },
+    {
+      "label": "pull_remote",
+      "type": "shell",
+      "command": "sh /home/coder/pull_remote.sh",
+      "presentation": {
+        "reveal": "always"
+      },
+      "problemMatcher": [],
+      "options": {
+        "statusbar": {
+          "label": "$(repo-pull) rclone: pull"
+        }
+      }
+    }
+  ]
+}

guides/heroku.md

@@ -50,3 +50,5 @@ Press the button in the top right of the repo, or or click to [use this template
 1. Head back to Heroku and notice a new deployment has started. After it has completed, you can use these tools in your environment.
 
 1. (Optional): [Configure rclone](https://github.com/cdr/deploy-code-server/tree/main/deploy-container#-persist-your-filesystem-with-rclone) so that you can save your VS Code config and files without commiting
+
+See the [deploy-container README](../deploy-container) for other config vars for your environment. 

guides/railway.md

@@ -42,3 +42,5 @@ You also need to specity a `PASSWORD` and a `GIT_REPO` to clone in your environm
 1. Head back to Railway and notice a new deployment was created. After it has completed, you can use these tools in your environment.
 
 1. (Optional): [Configure rclone](https://github.com/cdr/deploy-code-server/tree/main/deploy-container#-persist-your-filesystem-with-rclone) so that you can save your VS Code config and files without commiting
+
+See the [deploy-container README](../deploy-container) for other config vars for your environment.