Gitpod Single Instance

Archived

This now superseded by the officially-support Gitpod Preview Install. Please use that instead

An experimental repository for getting Gitpod installed on a single-instance

This may well be renamed, refactored, made into an official Gitpod guide or canned in future dependent upon what can be achieved.

Intention

The intention for this repo is to find a way of achieving:

• installing Gitpod on a single-instance machine
• use the Gitpod Installer

Stacks

• Support Linux/Mac
• Windows should be supported, even if necessary to use WSL
• Preferrably use k3s

k3d is the preferred stack as it can be automated and supports all the required stacks. If this cannot be made to support Gitpod, this must be done using a technology that supports full automation.

Goal(s)

Ultimately, This will be automated as a "cURL to Bash" type script, eg:

curl https://raw.githubusercontent.com/MrSimonEmms/gitpod-single-instance/develop/run.sh | bash

Contributions Are Welcome!

Whilst this is in the develop branch, this repo should be considered volatile as experiments pass or fail. If/when this moves to a main branch, this will then be considered production-ready.

Please check the NOTES.md file for where this project currently stands. If making contributions, please add something to this file.

Linux - Getting Started

1. Spin up a system with Ubuntu 20.04.
2. Install Docker, kubectl, k3d, and Helm on the system.
3. Clone this repository to your system. Go into the cloned respository - cd gitpod-single-instance
4. Build the k3s Docker image by running - docker build -t k3s .
5. Edit the certificate.yaml file, specifically the domains in the dnsNames section.
6. Update the domain: in config.yaml.
7. Open out.yaml and replace all instances of simonemms.com with your domain.
8. Run ./run.sh. It'll take a few moments to deploy the new Kubernetes cluster.