Skip to content

README.md

Latest commit

 

History

History
74 lines (49 loc) · 4.23 KB

README.md

File metadata and controls

74 lines (49 loc) · 4.23 KB
Raw

Eclipse GLSP CI

Quick reference

Supported tags and respective Dockerfile links

Note that these tags are fluent and not bound to a fixed image version. If you want to use a fixed version you can use the base tag with a version suffix e.g. alpine-v9.0. An increment of the major version number (e.g. v8.0-> v9.0) indicates an update of a major component e.g a new OS, Node, Java or package manager version. Minor version increments indicate bug fixes or changes in the minor dev dependencies. (See also: Image Version History)

What is Eclipse GLSP CI

An Alpine-based image that is used in Continuous Integration jobs of Eclipse GLSP and related projects (e.g. EMF.cloud). The image ships with the necessary libraries to enable both node-based client builds and Java/Maven-based server builds. It is mainly used for CI jobs that require the possibility to build client and server components in one shared container.

The image has the following components installed:

  • Git >=2.17.1
  • Node 22 and pnpm 11
  • OpenJDK 21 and Maven >=3.6.0
  • Python and GCC libraries to enable Theia builds

How to use this image

You can run any shell command by using the docker image directly, passing a shell command to docker run:

docker run eclipseglsp/ci:alpine echo "Hello World"

Alternatively, you can run the image in interactive mode and gain full access to the shell:

docker run -it eclipseglsp/ci:alpine

Image Details

ci:alpine<-suffix>

This image is based on the popular Alpine Linux project, available in the alpine official image. Alpine Linux is much smaller than most distribution base images (~5MB), and thus leads to much slimmer images in general.

It only provides the essential libraries needed for building client and server components and is the recommended image for classical CI jobs like building branches or PRs on change, or deploying build artifacts.

Image Version History

  • v1.0: Node version: 12. Only supports Theia >1.15.0
  • v2.0: Update preinstalled dependencies to support Theia >=1.15.0
  • v3.0: Update to node 14
  • v3.1: Pre-install latest lerna version
  • v4.0: Update to node 16
  • v5.0: Update to node 18, Java 17 and Alpine 3.17/Ubuntu 22.04
  • v6.0: Update to node 20
  • v7.0: Update to Java 21
  • v7.1: Additionally install Java 11
  • v8.0: Update to Node 22. Ubuntu and uitest variants have been removed.
  • v9.0: Replace Yarn and Lerna with pnpm 11.

License

Eclipse Eclipse is released under the EPL-2.0/GPL-2.0-with-classpath-exception,

As with all Docker images, these likely also contain other software which may be under other licenses (such as Bash, etc from the base distribution, along with any direct or indirect dependencies of the primary software being contained).