Skip to content

feat: Add documentation for workspace proxy creation #7377

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 13 commits into from
May 4, 2023

Conversation

Emyrk
Copy link
Member

@Emyrk Emyrk commented May 2, 2023

Initial documentation for workspace proxies. This will evolve over time.

Disclaimer that is is experimental is at the top. So we can merge these docs if we are happy with the language and modify as we develop.

Screenshot from 2023-05-02 14-25-17

@Emyrk Emyrk marked this pull request as ready for review May 2, 2023 19:26
@Emyrk Emyrk requested a review from bpmct May 3, 2023 15:12

A workspace proxy is a relay connection a developer can choose to use when connecting with their workspace over ssh, a workspace app, port forwarding, etc.

<!-- TODO: Might want to modify this diagram? -->
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I modified next.config.js in my coder.com codebase to allow other origins (e.g. imgur) to preview this temporarily. Not bad! I don't think we need to modify this, but will defer to you and Dean.

Screenshot 2023-05-03 at 1 49 39 PM

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🙏

I figure someone can make a better graphic. I just wanted something since it's way easier to understand when illustrated.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yeah this really helps convey how it works

@bpmct
Copy link
Member

bpmct commented May 3, 2023

Oh - had another thought. It'd be helpful to mention that workspace proxies only need network connectivity to the Coder dashboard URL and only need port 443 exposed. Workspace proxies do not need to connect to the database.

@Emyrk Emyrk merged commit 6d24f7c into main May 4, 2023
@Emyrk Emyrk deleted the stevenmasley/proxydocs branch May 4, 2023 18:30
@github-actions github-actions bot locked and limited conversation to collaborators May 4, 2023
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants