https://github.com/redhat-cop/devspaces-images
A factory model for managing workspace base images for Red Hat OpenShift Dev Spaces
https://github.com/redhat-cop/devspaces-images
container-cop
Last synced: 9 months ago
JSON representation
A factory model for managing workspace base images for Red Hat OpenShift Dev Spaces
- Host: GitHub
- URL: https://github.com/redhat-cop/devspaces-images
- Owner: redhat-cop
- Created: 2024-02-27T18:26:22.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-09-20T19:57:56.000Z (over 1 year ago)
- Last Synced: 2025-04-09T22:01:18.503Z (9 months ago)
- Topics: container-cop
- Language: Shell
- Homepage:
- Size: 80.1 KB
- Stars: 4
- Watchers: 8
- Forks: 9
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# DevSpace(s)-ify your existing container images
This is a proposed approach for how to take any existing UBI-based language image, and turn it into a Dev Spaces optimized container image. Dev Spaces/Eclipse Che have introduced us to this concept that a container platform can be used, not just to host production applications, but also as a place optimized for developers to write, test and commit code. By running a development workspace with an IDE inside of a container and serving it through the browser, we can extend all of the consistency, immutability, and portability benefits of our application runtime environments to inner-loop development.
However, there is one challenge we have to deal with when working in this mode -- our production container images have been optimized for production. That means that they only contain the minimal tooling & libraries required to run our application and nothing for the developer. In a developer workspace, we need to have a few more tools available to us to make our development experience as smooth and efficient as possible. Thus far we've solved this problem by managing completely separate images for the purpose of development and deployment. However this creates additional overhead in having to manage the build process for these two sets of images.
A better experience could be just taking our existing application runtime images, and layering on top a standard set of developer tools to produce developer-optimized versions of our production images.
## Images
This repo automatically publishes the following images that are available to use in Dev Spaces:
- quay.io/redhat-cop/devspaces-base:latest
- quay.io/redhat-cop/devspaces-openjdk-17:latest
- quay.io/redhat-cop/devspaces-nodejs-18:latest
- quay.io/redhat-cop/devspaces-nodejs-20:latest
- quay.io/redhat-cop/devspaces-java-node-combined:latest
- quay.io/redhat-cop/devspaces-nested-podman:latest
- quay.io/redhat-cop/cekit-builder:latest
## Developer-optimized container images using CEkit
[CEkit](https://cekit.io) is a modular, YAML-based framework for generating Containerfile-driven images that can be built using Docker, Podman or Buildah. To acheive our developer-optimized image builds, we're going to use a 3 layered approach:
1. A base image that already contains the language, framework, or libraries we need to run our app. In this case we're selecting [language images](https://catalog.redhat.com/software/containers/search?gs&q=ubi) built on top of Red Hat's [Universal Base Images](https://catalog.redhat.com/software/base-images)
2. A _developer base_ layer that provides all the basic tools and libraries generally desired for running workspaces. Based on the [Devfile.io Developer Base Image](https://github.com/devfile/developer-images#developer-base-image).
3. A _custom tooling_ layer that contains organization or team specific tools, such as CLIs for interacting with your container platform, public cloud or other hosting environment. For the purpose of this demo, we're just adding `zsh` and the [Oh My ZSH!](https://ohmyz.sh/) project.
With CEkit, each layer that we add can be represented by a [module](https://docs.cekit.io/en/latest/getting-started/modules.html) that defines packages and setup steps for that layer.
## Building Images
To get started [download and install CEkit](https://docs.cekit.io/en/latest/handbook/installation/index.html).
To start off, let's just build our generic developer base image. This image will simply contain our _developer base_ and _custom tooling_ layers on top of a base
Developer Base Image:
```
cekit build podman
```
The developer base image is defined in the `image.yaml` file which is automatically picked up by CEkit. The `image.yaml` defines the name, version (tag), base image and modules that will be used to compose the image.
## Using Overrides to inject language images
CEKit also supports [overrides](https://docs.cekit.io/en/latest/handbook/overrides.html). Overrides allow you to modify certain parts of a build to produce slightly different variations of an image without defining a completely separate build. For our purposes, we're going to use overrides to inject an alternate language image as our FROM image.
To build a Java OpenJDK 17 version of our image, we can run:
```
cekit build --overrides images/devspaces-openjdk-17.yaml podman
```
To build a NodeJS 18 image, run:
```
cekit build --overrides images/devspaces-nodejs-18.yaml podman
```
## Need a Containerfile? You Got it!
If you still have a need or desire to provide a raw Containerfile for people to build, CEkit has you covered there too. In addition to the build image, the `cekit build` command also outputs the full source for the image, including a generated containerfile, which can be built directly usin Docker, Podman or Buildah. For example, after running the NodeJS example above, I can also run:
```
podman build -t nodejs-containerfile target/image
```
This is useful for supporting a mixed mode where you want to have a streamlined CI process for producing images for your project, but would also like to make it easy for consumers of your project to build the images themselves without extra tooling.
## Quick Commands to build images locally
```bash
cekit build --overrides images/cekit-builder.yaml podman
cekit build --overrides images/devspaces-base.yaml podman
cekit build --overrides images/devspaces-openjdk-17.yaml podman
cekit build --overrides images/devspaces-nodejs-18.yaml podman
cekit build --overrides images/devspaces-nodejs-20.yaml podman
cekit build --overrides images/devspaces-java-node-combined.yaml podman
cekit build --overrides images/devspaces-nested-podman.yaml podman
cekit build --overrides images/devspaces-python-311.yaml podman
```