Cekit

Added

* Support for Alpine Linux, https://github.com/cekit/cekit/issues/609

Fixed

* Content sets can now be be properly overridden. CEKit is able to handle both, `content_sets` defined in the descriptor as well as `content_sets_file` pointing to an external file. See documentation: http://docs.cekit.io/en/latest/descriptor/image.html#content-sets, https://github.com/cekit/cekit/issues/628
* A bug was fixed which prevented correct merging of the `osbs`section in case where the `--redhat` switch was specified as well, https://github.com/cekit/cekit/issues/631

Changed

* The Git resource `ref` key can handle commit hashes or tags as well. Previously only branches were supported. https://github.com/cekit/cekit/issues/618
* You will see less warning related to missing module version. It will be shown only when there are multiple modules and a default version is guessed by CEKit, https://github.com/cekit/cekit/issues/617
* In OSBS builder, from now on the `fetch-artifacts-url.yaml` is always removed before sync. Leaving it could cause fetching artifacts from an unexpected location in case it was not generated by a specific CEKit run, https://github.com/cekit/cekit/issues/629
* When cloning git repositories with modules -- these are now stored in predicable directory structure, https://github.com/cekit/cekit/issues/621
* The `--koji-target` OSBS switch was removed. You can still define the target in the image descriptor: http://docs.cekit.io/en/latest/descriptor/image.html#osbs-koji-target, https://github.com/cekit/cekit/issues/601

Heads-up

* Module script execution was changed from `bash` to `sh`. In most cases this change will be invisible for users because the `sh` is a symlink to `bash` in most modern Linux distributions (including Fedora). From now on in the generated `Dockerfile` instead of:

Dockerfile
RUN [ "bash", "-x", "/tmp/scripts/..."]


you will see:

Dockerfile
RUN [ "sh", "-x", "/tmp/scripts/..."]

Added

* Schema for artifacts is now [shown in the documentation](https://docs.cekit.io/en/3.5.0/descriptor/image.html#artifact-types): 607
* It is now possible to specify the Koji target in the descriptor, [docs](https://docs.cekit.io/en/3.5.0/descriptor/image.html#osbs-koji-target): 591
yaml
osbs:
koji_target: rhaos-middleware-rhel-7-containers-candidate
`
* Description and usage of environment variable `BUILDAH_LAYERS` was added to documentation for Podman and Buildah builder engines, [docs](https://docs.cekit.io/en/3.5.0/handbook/building/builder-engines.html#buildah-environment-variables), 598
* Support for squashing was added for Buildah builder engine, it's enabled by default, 597
* Support for squashing was added for Podman builder engine, it's enabled by default, 441
* Added documentation for the multi-stage builds. Support for multi-stage builds was added in version 3.4.0 as tech-preview. With this release it is now fully supported, [docs](https://docs.cekit.io/en/3.5.0/handbook/multi-stage.html) #594

Changed

* Module processing was updated in a way that modules without content won't be copied into the image. This approach will speed up a little bit builds and possbily create less layers, 614
* The `--tech-preview` switch was removed from the OSBS builder parameters, it was deprecated since version 3.4, 600

Summary

This release introduces support for multi-stage builds.

Please see below for all changes that went in.

Added

* Support for multi-stage builds was added, 567
* A new switch was added to OSBS builder to allow for non-interactive build: `--assume-yes`, 589
* Another switch was added to the OSBS builder to make it possible to sync with the dist-git repository without triggering a build, 587

This is a bugfix release release with backports from the 3.4.x codebase in the OSBS builder:

* Support for `--assume-yes` OSBS builder switch, 589
* Support for `--sync-only` OSBS builder switch, 587

Summary

This release focuses on documentation improvements, especially in for modules. Other bigger change is that this we have fixed Dockerfile generation so that the Docker layer cache can be reused.

**NOTE:** Version `3.3.0` was **never released** due to the fact that we encountered issues with PyPi which made it impossible to push version `3.3.0` again. There are no changes in the code between version `3.3.0` and `3.3.1`.

Please see below for all changes that went in.

Fixed

* Template used to generate Dockerfile was updates so that we can now utilize properly Docker layer cache, 544
* ZSH completion was fixed and it should work now, 554

Added

* A new switch to the `build` command was added: `--validate`. It is responsible for checking that the image descriptor (and relevant modules) are correct. It does **not** generate files for the specific builder.
* Documentation around module versioning was added, 194, 196
* Documentation was updated on best practices regarding module naming, 197
* A warning is now printed when artifact does not define a `name` key. This is to remind you that in order to make overrides work nicely, you should define it, 198
* Documentation covering local module development was extended, 527
* All available Docker builder engine environment variables are now documented, 526
* A workaround was added for `microdnf` where it fails with message similar to `error: cannot move /var/cache/yum/metadata`, 560
* A warning was added when CEKit finds that the [`certifi` library](https://pypi.org/project/certifi/) is found -- in most cases it will lead to certificate validation issues related to missing CA certficates, #577

Changed

* [Image help pages](http://docs.cekit.io/en/latest/descriptor/image.html#help) were overhauled. These contain now information about environment variables and labels defined in image modules too. Help page formatting was updated too. These should now provide full information about the image. 528
* The `--tech-preview` switch in the OSBS builder is now deprecated. It will be removed in CEKit 3.5 or later. Overrides should be used instead of this switch.
* Dependency handling was updated to be more flexible, for example we no longer require the `docker-squash` library when you do not want to squash the image after building in Docker, 576
* Small tweaks to getting started guide were applied, 556

Heads-up

* Please note that [although in documentation](http://docs.cekit.io/en/latest/descriptor/module.html#version) we have stated that module's `version` key is required, we did not enforce it until now. This has been fixed and the `version` key requirement is enforced.

This is a bugfix release release with backports from the 3.4.x codebase in the OSBS builder:

* Support for `--assume-yes` OSBS builder switch, 589
* Support for `--sync-only` OSBS builder switch, 587