## 1. SSH Setup
-1. (Windows only) Install git for windows [https://git-scm.com/download/win](https://git-scm.com/download/win)
+1. (Windows only) Install Git for Windows [https://git-scm.com/download/win](https://git-scm.com/download/win)
1. Choose "64-bit Git for Windows Setup". It does not require admin privileges to install.
1. Hit "Next" a bunch of times to accept the defaults
- 1. The most important things is that "install git bash" and "install OpenSSH" are enabled.
+ 1. The most important things is that "install git bash" and "install OpenSSH" are enabled (this is the default).
1. At the end of the installation, you can launch tick a box to git bash directly.
1. Open "Git Bash" (installed in the "Git" folder of the start menu)
-1. From an open bash shell
+1. (All operating systems) Starting from bash shell (on MacOS or Linux you will open "Terminal")
1. Shell: Run `ssh-keygen`
1. Hit enter to save to a default location
1. You can choose to protect the key with a password, or just hit enter for no password.
- 1. Shell: Look for a message like `Your public key has been saved in /c/Users/MyUsername/.ssh/id_rsa.pub`
- 1. Shell: Run `cat /c/Users/MyUsername/.ssh/id_rsa.pub`
+ 1. Shell: Look for a message like `Your public key has been saved
+ in /c/Users/MyUsername/.ssh/id_rsa.pub` (Windows git bash
+ example, on MacOS or Linux this will probably start with `/Users` or `/home`)
+ 1. Shell: Run `cat /c/Users/MyUsername/.ssh/id_rsa.pub`
1. Shell: Use the pointer to highlight and copy the lines starting
with `ssh-rsa …` up to the next blank line. Right click and
select "Copy"
1. Right click the newly added ssh target in the list and select “connect to host in current window`
1. If it asks `Select platform of the remote host` select `Linux`.
1. Vscode: On the left sidebar, go back to `Extensions` 
- 1. Search for "benten" and install `CWL (Rabix/Benten)`
- 1. You should see a message `Extension is enabled on 'SSH: ...' and disabled locally.`
+ 1. Search for "benten", then look for `CWL (Rabix/Benten)` and click `Install`
+ 1. On the information page for `CWL (Rabix/Benten)`
+ 1. If you see a warning `Install the extension on 'SSH: ...' to enable` then click the button `Install in SSH: ...`
+ 1. You should now see a message `Extension is enabled on 'SSH: ...' and disabled locally.`
1. Vscode: On the left sidebar, choose `Explorer` 
1. Select `Clone Repository` and enter [https://github.com/arvados/arvados-vscode-cwl-training](https://github.com/arvados/arvados-vscode-cwl-training), then click `Open`
1. If asked `Would you like to open the cloned repository?` choose `Open`
-1. Go to Arvados Workbench
- 1. Workbench: In the user menu, select `Current token`
- 1. Vscode: Click on the `Terminal` menu
+1. Vscode: Click on the `Terminal` menu
1. Vscode: Click `Run Task…`
1. Vscode: Select `Configure Arvados`
- 1. Workbench: Copy the string following `ARVADOS_API_HOST=`
+ 1. Go to Arvados Workbench
+ 1. Workbench: In the user menu, select `Current token`
+ 1. Workbench: Copy the text following `ARVADOS_API_HOST=` to the end of the line
1. Vscode: Paste the string at the `Value for ARVADOS_API_HOST` prompt
- 1. Workbench: Copy the string following `ARVADOS_API_TOKEN=`
+ 1. Workbench: Copy the text following `ARVADOS_API_TOKEN=` to the end of the line
1. Vscode: Paste the string at the `Value for ARVADOS_API_TOKEN` prompt
+ 1. This will create files called `API_HOST` and `API_TOKEN`
## 3. Register & run a workflow
1. Click on the `Terminal` menu
1. Click `Run Task…`
1. Select `Register or update CWL workflow on Arvados Workbench`
+ 1. This will create a file called `WORKFLOW_UUID`
1. Workbench: Go to `+NEW` and select `New project`
1. Enter a name for the project like "Lesson 1"
1. You should arrive at the panel for the new project
projects / arvados-vscode-cwl-training.git / blobdiff