Handle port notifications in JetBrains

[andreafalzetti]

Summary

Show a notification in JetBrains IDEs when a port is ready and exposed

Context

At the moment, open-preview and open-browser do not work automatically. The user can run gp url <PORT> and get the URL manually, however there is no information or notification about the port/URL being ready.

This is a feature that we have in VS Code, so we should handle supervisor notifications also via JetBrains Gateway

Value

Users are aware that a port has been exposed and their preview URL can be opened

Acceptance Criteria

A notification appears for each port being exposed

Measurement

Not incoming support request about how to open the preview URL from JetBrains Gateway

Out of scope

• Implementing a ports view, or updates to gp CLI to show port information

[akosyakov]

This is a feature that we have in VS Code, so we should handle supervisor notifications also via JetBrains Gateway

Not sure about implementation, maybe we rather move this logic from VS Code to supervisor and rely on notifications API only. We will need to get open/preview notifications API implemented for that though which is rather a big refactoring.

[andreafalzetti]

I needed some guidance so I started an internal chat to speed up knowledge sharing.

The outcome of this thread is:

Do a refactor of supervisor + VS Code Desktop would be a big change especially to make it backwards compatible. In VS Code Web, we subscribe to supervisor's port status and we listen to status changes. We then emit notifications when a port status has changed.

For now, we will proceed with an approach similar to VS Code Web, also for JetBrains IDEs.

Useful links:

• https://github.com/gitpod-io/openvscode-server/blob/7c912399c70799e4e4452a63cf3c0f7cc8f5832c/extensions/gitpod-web/src/extension.ts#L465-L467
• https://github.com/gitpod-io/openvscode-server/blob/7c912399c70799e4e4452a63cf3c0f7cc8f5832c/extensions/gitpod-web/src/extension.ts#L666-L691
• https://github.com/gitpod-io/openvscode-server/blob/7c912399c70799e4e4452a63cf3c0f7cc8f5832c/extensions/gitpod-web/src/extension.ts#L488-L523