VSCode various random issues when loading extensions from gitpod.yml

[szab100]

Bug description

I have the following list of extensions to be loaded for a spring-boot project that is using Lombok, so needs pre-processing before Java compilation.

vscode:
  extensions:
    - gabrielbb.vscode-lombok
    - vscjava.vscode-java-pack
    - vscjava.vscode-java-debug
    - vscjava.vscode-java-dependency
    - vscjava.vscode-java-test
    - vscjava.vscode-maven
    - pivotal.vscode-boot-dev-pack
    - rangav.vscode-thunder-client
    - ms-azuretools.vscode-docker

The experience seems quite random, depending on whether the Lombok extension was loaded before / after the vscode-java-pack extension, it sometimes prompts the user twice with the following popups:

• Java Extension Contributions changed, reloading Gitpod Code is required for the changes to take effect. Source: Language Support for Java(TM) by Red Hat (Extension) - User needs to click "Reload"
• Java Language Server configuration changed, please restart Gitpod Code. - User needs to click "Restart Now

However, sometimes these popups do not appear, but the loaded java projects have many errors due to the missing Lombok pre-processing step. Since the popup was not shown (same if the users misses them), the only way to resolve is by refreshing the entire page.

It looks to me that the problem itself may not be with this particular extension (that hooks up to other extensions' events, config etc), but how Gitpod loads and initializes the VSCode extensions in general (I found similar random timing / order / side-effect issues with other extensions too).

If that is the case, I believe there could be further improvements made in order to provide a stable, dependable experience, like allowing users to specify:

• ordering for the listed extensions (if the YAML sequence order is not preserved)
• a certain delay or dependencies on other extension(s) - so that extensions can be loaded in parallel by default, but those having dependencies must be loaded strictly after the deps are fully loaded
• actions to be performed between extensions [like restarting a component OR run a shell cmd]

Please let me know what you think is the best solution for these problems.

Steps to reproduce

described in description

Workspace affected

No response

Expected behavior

No response

Example repository

No response

Anything else?

No response

[jeanp413]

Hi @szab100, extensions activate depending on the events listed in the activationEvents entry in package.json, there's no way to specify the ordering, unless some extension requires some exposed API from another extension and request for it.
In the case of the Lombok extension I took a look at the source code and what it does it only installs the jar file (it also updates java.jdt.ls.vmargs setting but that only affects the java language server spawned by the java extension which is for the language smartness and the reason of the popups you see), I think just adding the lombok library as a dependency if you are using maven or gradle should be enough, if not it would be really helpful if you have a public repo where I can reproduce this

[akosyakov]

@szab100 I think you don't need the lombok extension which is not maintained for one year and has severe issues which can break Java integration like microsoft/vscode-lombok#49

This extension also does only 2 things:

• installs lombok
• and configures java.jdt.ls.vmargs to point to it that Java language server can pick it up

Instead in a Docker image for your project you can install lombok and then configure java.jdt.ls.vmargs VS Code settings on project level to point to it like -javaagent:/gitpod/workspace/deps/lombok.jar.

It will ensure that jar file is already there when you start a workspace and not downloaded in the meantime, so Java lang server won't crash and will pick up lombok immediately without restart/page reload.

[szab100]

@akosyakov yes, thank you, your suggested workaround seems to be working fine (fetching lombok.jar and add the agent to vmargs).

On the other hand, sometimes I see other issues that are seemingly happening because of how VSCode loads extensions. I understand there is no out-of-the-box way with VSCode to specify installation order or making sure an extension only gets installed if a set of extensions are already installed / loaded up.

Such an example is this (among other similar conflicts between extensions):

with the extension list defined in this order:
- vscjava.vscode-java-pack
- vscjava.vscode-java-debug
- vscjava.vscode-java-dependency
- vscjava.vscode-java-test
- vscjava.vscode-maven

What I see in the code is that currently Gitpod is simply iterating over the list of user-specified list of extensions (in order) and builds the vscode server command by adding each with "--install-extension <path_or_url>" that it executes once and lets VSCode to figure the order / dependency graph etc.

The approach I suggested here is that when the user specifies a certain order, or loading group, eg something like:

vscode:
  extensions:
    -
      id: vscjava.vscode-java-pack
      group: 1
      timeout: 3000
    - 
      id: rangav.vscode-thunder-client
      group: 1
    - 
      id: pivotal.vscode-boot-dev-pack
      group: 2
      group-timeout: 5000

And the codehelper component could first run:

• gitpod-code --install-extension vscjava.vscode-java-pack --install-extension rangav.vscode-thunder-client

..then it could keep checking the installed extensions using gitpod-code --list-extensions --show-versions, and only build & run the command with '--install-extension' for subsequent load-groups' extensions (in this example, the Pivotal Spring Boot extension) when all extensions from the previous group(s) are already fully installed or prompt the user with an error message if installing some extension(s) failed within the specified timeout.

Therefore after it verifies the 1st group's extensions are all installed (and the java-pack installed within 3000ms), it will then execute:

• gitpod-code --install-extension pivotal.vscode-boot-dev-pack

So in other words, implement this logic on Gitpod side by calling Code's existing dummy (list-installed + install) API, in case you guys are also experiencing timing issues due to how extension-loading is done today.

[akosyakov]

I don't think it is going to help, errors come from loading/activation which happen on each page reload, not only on first install. Besides it sounds like working around issues with extensions. I think we should rather investigate and reach out to authors about concrete issues. Both java debug and test extensions are well-maintained. @jeanp413 could you check when it happens and file issues for corresponding extensions? 🙏

[jeanp413]

After investigation it's a vscode bug, created an upstream issue microsoft/vscode#149309

[akosyakov]

@jeanp413 Would you be able to have a look into fix for this please? 🙏