chore: docs: add port-forwarding options (CLI & ssh) (#3394)

sharkymark · Eric Paulsen · web-flow · commit 8d4b6086f619 · 2022-08-07T17:30:15.000-04:00
* chore: docs: add port-forwarding options

* fix: code type

Co-authored-by: Eric Paulsen &lt;eric@Erics-MacBook-Air.local&gt;
diff --git a/docs/ides.md b/docs/ides.md
@@ -78,3 +78,10 @@ Connection and connect to your Coder workspace.](./ides/configuring-gateway.md)
 ## Web IDEs (Jupyter, code-server, JetBrains Projector)
 
 Web IDEs (code-server, JetBrains Projector, VNC, etc.) are defined in the template. See [configuring IDEs](./ides/configuring-web-ides.md).
+
+## Port Forwarding
+
+Port Forwarding lets developers securely access processes on their Coder
+workspace from a local machine. A common use case is testing front-end
+applications in a browser at `http://localhost:<yourforwardedport>` See
+[configuring Port Forwarding](./ides/configuring-port-forwarding.md).
diff --git a/docs/ides/configuring-port-forwarding.md b/docs/ides/configuring-port-forwarding.md
@@ -0,0 +1,34 @@
+# Configuring Port Forwarding
+
+There are two ways to forward ports:
+
+- The Coder CLI port-forward command
+- SSH
+
+## The Coder CLI and port-forward
+
+For example:
+
+```console
+coder port-forward mycoderworkspacename --tcp 8000:8000
+```
+
+For more examples, type `coder port-forward --help`
+
+## SSH
+
+Use the Coder CLI to first [configure SSH](../ides.md#ssh-configuration) on your
+local machine. Then run `ssh`. For example:
+
+```console
+ssh -L 8000:localhost:8000 coder.mycoderworkspacename 
+```
+
+## Accessing the forwarded port
+
+After completing either Port Forwarding method, open a web browser on your local
+machine to access the Coder workspace process.
+
+```console
+http://localhost:<yourforwardedport>
+```
