eclipse/che-plugin-broker repository overview

⁠This repo contains implmentations of several Che plugin brokers

⁠che-plugin-broker

Downloads tar.gz archive and:

• Evaluates Che workspace sidecars config from che-plugin.yaml located in a plugin archive and data from config.json that is placed in workdir or different path if a corresponding broker argument is used. It contains data about Che plugin or editor from meta.yaml
• Copies dependency file/folder specified in dependencies.yaml inside of a plugin archive

⁠theia-plugin-broker

Downloads .theia archive and:

• Unzip it to a temp folder
• Check content of package.json file in it. If it contains {"engines.cheRuntimeContainer"} then this value is taken as container image for sidecar of a remote plugin. If it is missing or empty plugin is considered non-remote
• Copies .theia file to /plugins/ for a non-remote plugin case
• Copies unzipped .theia to /plugins/ for a remote plugin case
• Sends following sidecar config to Che workspace master:
• with projects volume
• with plugin volume
• adds an endpoint with random port between 4000 and 6000 and name port<port>
• adds env var to workspace-wide env vars with name THEIA_PLUGIN_REMOTE_ENDPOINT_<plugin_publisher_and_name from package.json> and value ws://port<port>:<port>
• adds env var to sidecar env vars with name THEIA_PLUGIN_ENDPOINT_PORT and value port
• Evaluates Che workspace sidecar config for running Theia plugin as Che remote plugin in a sidecar

⁠init-plugin-broker

Cleanups content of /plugins/ folder. Should be started before other brokers not to remove files they are adding to plugins folder.

⁠Development

⁠Build

• build all the code:

CGO_ENABLED=0 GOOS=linux go build -a -ldflags '-w -s' -a -installsuffix cgo ./...

• build Che plugin broker binary:

CGO_ENABLED=0 GOOS=linux go build -a -ldflags '-w -s' -a -installsuffix cgo -o che-plugin-broker brokers/che-plugin-broker/main.go

• build Che Theia plugin broker binary:

CGO_ENABLED=0 GOOS=linux go build -a -ldflags '-w -s' -a -installsuffix cgo -o theia-plugin-broker brokers/theia-plugin-broker/main.go

• build Init plugin broker binary:

CGO_ENABLED=0 GOOS=linux go build -a -ldflags '-w -s' -a -installsuffix cgo -o init-plugin-broker brokers/init/main.go

• run tests:

go test -v -race ./...

• run linters:

golangci-lint run -v

• run CI checks locally in Docker (includes build/test/linters):

docker build -f Dockerfile.CI .

⁠Dependencies

Dependencies in the project are managed by Go Dep. After you added a dependency you need to run the following command to download dependencies to vendor repo and lock file and then commit changes:

dep ensure

dep ensure doesn't automatically change Gopkg.toml which contains dependencies constrants. So, when a dependency is introduced or changed it should be reflected in Gopkg.toml.

⁠Build of Docker images

• build Che plugin broker

docker build -t eclipse/che-plugin-broker:latest -f Dockerfile.cpb .

• build Theia plugin broker

docker build -t eclipse/theia-plugin-broker:latest -f Dockerfile.tpb .

• build Init plugin broker

docker build -t eclipse/init-plugin-broker:latest -f Dockerfile.ipb .