Skip to content

add docs for web IDEs (code-server, JetBrains Projector, VNC) #2448

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 6 commits into from
Jun 19, 2022
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
change location of web IDE page
  • Loading branch information
bpmct committed Jun 19, 2022
commit c763c9d88fe59a7ea7d0a74be5b2c362482b5df6
93 changes: 3 additions & 90 deletions docs/ides.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,9 +16,8 @@ support should work:
- Rider
- RubyMine
- WebStorm

> See [Congifuring IDEs](./templates/configuring-ides.md) to learn how to
> add any web IDE (e.g. code-server, JetBrains projector) to your templates.
- Web IDEs (code-server, JupyterLab, Jetbrains Projector)
- Note: These are [configured in the template](./ides/configuring-web-ides.md)

## SSH configuration

Expand Down Expand Up @@ -60,92 +59,6 @@ Code, connected to your Coder workspace for compute, etc.
1. In VS Code's left-hand nav bar, click **Remote Explorer** and right-click on
a workspace to connect.

## VS Code in the browser

> You must have Docker Desktop running for this template to work.

Coder offers a [sample template that includes
code-server](../examples/templates/docker-code-server/README.md).

To use:

1. Start Coder:

```console
coder server --dev
```

1. Open a new terminal and run:

```console
coder templates init
```

1. Select the **Develop code-server in Docker** option when prompted.

1. Navigate into your new folder and create your sample template:

```console
cd code-server-docker && coder templates create
```

Follow the prompts that appear in the terminal.

1. Create your workspace:

```console
coder create --template="docker-code-server" [workspace name]
```

1. Log into Coder's Web UI, and open your workspace. Then,
click **code-server** to launch VS Code in a new browser window.

## JetBrains Gateway with SSH

If your image
[includes a JetBrains IDE](../admin/workspace-management/installing-jetbrains.md)
and you've [set up SSH access to Coder](./ssh.md), you can use JetBrains Gateway
to run a local JetBrains IDE connected to your Coder workspace.

> See the [Docker sample template](../examples/templates/docker/main.tf) for an
> example of how to refer to images in your template.

Please note that:

- Your Coder workspace must be running, and Gateway needs compute resources, so
monitor your resource usage on the Coder dashboard and adjust accordingly.
- If you use a premium JetBrains IDE (e.g., GoLand, IntelliJ IDEA Ultimate), you
will still need a license to use it remotely with Coder.

1. [Download and install JetBrains Toolbox](https://www.jetbrains.com/toolbox-app/).
Locate JetBrains Gateway in the Toolbox list and click **Install**.

1. Open JetBrains Gateway and click **Connect via SSH** within the **Run the IDE
Remotely** section.

1. Click the small **gear icon** to the right of the **Connection** field, then
the **+** button on the next screen to create a new configuration.

1. Enter your Coder workspace alias target in **Host** (e.g.,
`coder.<yourWorkspaceName>`), `22` in **Port**, `coder` in **User name**, and change
**Authentication Type** to **OpenSSH config and authentication agent**. Leave
the local port field blank. Click **Test Connection**. If the test is
successful, click **Ok** at the bottom to proceed.

1. With your created configuration in the **Connection** chosen in the drop-down
field, click **Check Connection and Continue**.

1. Select a JetBrains IDE from the **IDE version** drop-down (make sure that you
choose the IDE included in your image), then click the folder icon and select the
`/home/coder` directory in your Coder workspace. Click **Download and Start
IDE** to proceed.

1. During this installation step, Gateway downloads the IDE and a JetBrains
client. This may take a couple of minutes.

1. When your IDE download is complete, JetBrains will prompt you for your
license. When done, you'll be able to use your IDE.

## Web IDEs
## Web IDEs (Jupyter, code-server, Jetbrains Projector)

Web IDEs (code-server, JetBrains Projector, VNC, etc.) are defined in the template. See [configuring IDEs](./templates/configuring-ides.md).
14 changes: 8 additions & 6 deletions docs/manifest.json
Original file line number Diff line number Diff line change
Expand Up @@ -34,11 +34,6 @@
"path": "./templates.md",
"icon": "<svg viewBox=\"0 0 16 16\" xmlns=\"http://www.w3.org/2000/svg\"> <path d=\"M15.0017 4.0017H1.0017C0.868289 3.99368 0.734692 4.01405 0.609732 4.06147C0.484772 4.10889 0.371292 4.18228 0.276784 4.27678C0.182276 4.37129 0.108891 4.48477 0.0614728 4.60973C0.0140548 4.73469 -0.00631686 4.86829 0.00170278 5.0017V15.0017C-0.00631686 15.1351 0.0140548 15.2687 0.0614728 15.3937C0.108891 15.5186 0.182276 15.6321 0.276784 15.7266C0.371292 15.8211 0.484772 15.8945 0.609732 15.9419C0.734692 15.9894 0.868289 16.0097 1.0017 16.0017H15.0017C15.1351 16.0097 15.2687 15.9894 15.3937 15.9419C15.5186 15.8945 15.6321 15.8211 15.7266 15.7266C15.8211 15.6321 15.8945 15.5186 15.9419 15.3937C15.9894 15.2687 16.0097 15.1351 16.0017 15.0017V5.0017C16.0097 4.86829 15.9894 4.73469 15.9419 4.60973C15.8945 4.48477 15.8211 4.37129 15.7266 4.27678C15.6321 4.18228 15.5186 4.10889 15.3937 4.06147C15.2687 4.01405 15.1351 3.99368 15.0017 4.0017ZM14.0017 14.0017H2.0017V6.0017H14.0017V14.0017Z\" /> <path d=\"M14 0H2V2H14V0Z\" fill=\"#333333\"/> <path d=\"M5 13L10 8L13 13H5Z\" /> <path d=\"M5 10C5.55228 10 6 9.55228 6 9C6 8.44772 5.55228 8 5 8C4.44772 8 4 8.44772 4 9C4 9.55228 4.44772 10 5 10Z\" /> </svg>",
"children": [
{
"title": "Configuring Web IDEs",
"description": "Learn how to configure web IDEs in your templates",
"path": "./templates/configuring-web-ides.md"
},
{
"title": "Authentication & Secrets",
"description": "Learn how to authenticate the provisioner",
Expand All @@ -55,8 +50,15 @@
{
"title": "IDEs",
"description": "Learn how to use your IDE of choice with Coder.",
"path": "./ides.md",
"icon": "<svg viewBox=\"0 0 512 466\" xmlns=\"http://www.w3.org/2000/svg\">\n<path d=\"M46.5 0.837754C20.5 0.837754 0 22.3052 0 49.5321V122.94V196.348V221.062V245.776V270.489V343.898V417.306C0 444.533 20.5 466 46.5 466H256H465.5C491.5 466 512 444.533 512 417.306V343.898V244.205V195.511V122.102V48.6944C512 21.4674 491.5 0 465.5 0H256H46.5V0.837754Z\" />\n<path d=\"M70.1 73.1V99.1L140.2 140.1L70.1 181.1V207.1L186.7 140.1L70.1 73.1ZM185.9 186.5V210.1H302.5V186.5H185.9Z\" fill=\"white\" />\n</svg>",
"path": "./ides.md"
"children": [
{
"title": "Configuring Web IDEs",
"description": "Learn how to configure web IDEs in your templates",
"path": "./ides/configuring-web-ides.md"
}
]
},
{
"title": "Dotfiles",
Expand Down