educates / educates-training-platform

A platform for hosting interactive workshop environments in Kubernetes, or on top of a local container runtime.
https://educates.dev
Apache License 2.0
74 stars 20 forks source link

Add OrbStack instructions #607

Open jorgemoralespou opened 6 days ago

jorgemoralespou commented 6 days ago

Describe the bug

When creating a cluster in OrbStack, we run into the same issue as with Colima, so instructions need to detail this:

In quick-start-guide.yaml doc we need to update:

In case you are using [Colima](https://github.com/abiosoft/colima) or [OrbStack](https://orbstack.dev/), you need to add the following lines to the educates configuration file:

$ educates local config edit
localKindCluster:
  listenAddress: 0.0.0.0

Additional information

No response

jorgemoralespou commented 5 days ago

It seems that if both Orbstack and Docker are installed, then the Docker context mechanism does not work for docker golang library, so that one will need to set the DOCKER_HOST to the Orbstack socket which can be fetched via docker context inspect orbstack -f json | jq -r ".[0].Endpoints.docker.Host"

jorgemoralespou commented 5 days ago

Because of this moby/moby issue (https://github.com/moby/moby/issues/42650) it seems that in order to use the current selected context, and not the client.NewClientWithOpts(client.FromEnv) but rather create an Opts struct with the values from the current context, one would need to use the Docker cli (or some logic from it), so it seems complicated :-(