Description

As IDEs start without loading the login shell for quick startup, previous assumptions about race condition between .bashrc.d startup scripts are not ideal anymore. This introduces a new directory alongside .bashrc.d called .runonce. Scripts placed inside $HOME/.runonce will be executed once in the lifecycle of a workspace, and all task terminals will wait for .runonce scripts to complete before proceeding to execute the .gitpod.yml task commands. While scripts placed inside $HOME/.bashrc.d are used for modifying the shell environment (e.g. exporting env vars) each time a terminal is created and not for starting services.

Currently	Proposed

This PR only migrates the VNC startup to .runonce. I plan to create a followup PR to migrate rust, dotnet, mysql, postgres, vnc and yugabyte startup scripts as well (see axonasif@7907f57).

Related Issue(s)

Fixes #1067, gitpod-io/gitpod#18491, slack report, frontapp ticket.

How to test

Open https://gitpod.io/#https://github.com/axonasif/test/tree/vnc_test and check if all task terminals are attempting to start the vnc service.

Or if you want to emulate the race-condition environment from your existing workspace:

# Creates five bash login shells at the same time
docker run -e GITPOD_REPO_ROOT -v /workspace:/workspace -it axonasif/workspace-base-vnc:latest sh -c 'for i in 1 2 3 4 5; do bash -lic "echo Hello from BASH process $i" & done; wait'

Documentation

/hold