/community-operators-prod

community-operators metadata backing OpenShift OperatorHub

Primary LanguageDockerfileApache License 2.0Apache-2.0

Openshift Community Operators

License

About this repository

This repo is the canonical source for Kubernetes Operators that appear on OpenShift Container Platform and OKD.

NOTE The index catalog registry.redhat.io/redhat/redhat-operator-index:v<OCP Version> is built from this repository and it is consumed by Openshift and OKD to create their sources and built their catalog. To know more about how Openshift catalog are built see the documentation.

Documentation

Full documentation is generated via mkdoc and is located at https://redhat-openshift-ecosystem.github.io/community-operators-prod/

IMPORTANT NOTICE

Some APIs versions are deprecated and are OR will no longer be served on the Kubernetes version 1.22/1.25/1.26 and consequently on vendors like Openshift 4.9/4.12/4.13.

What does it mean for you?

Operator bundle versions using the removed APIs can not work successfully from the respective releases. Therefore, it is recommended to check if your solutions are failing in these scenarios to stop using these versions OR by setting the "olm.properties": '[{"type": "olm.maxOpenShiftVersion", "value": "<OCP version>"}]' to block cluster admins upgrades when they have Operator versions installed that can not work well in OCP versions higher than the value informed. Also, by defining a valid OCP range via the annotation com.redhat.openshift.versions into the metadata/annotations.yaml for our solution does not end up shipped on OCP/OKD versions where it cannot be installed.

WARNING: olm.maxOpenShiftVersion should ONLY be used if you are 100% sure that your Operator bundle version cannot work in upper releases. Otherwise, you might provide a bad user experience. Be aware that cluster admins will be unable to upgrade their clusters with your solution installed. Then, suppose you do not provide any upper version and a valid upgrade path for those who have your Operator installed be able to upgrade it and consequently be allowed to upgrade their cluster version (i.e from OCP 4.10 to 4.11). In that case, cluster admins might choose to uninstall your Operator and no longer use it so that they can move forward and upgrade their cluster version without it.

Please, make sure you check the following announcements:

Reporting Bugs

Use the issue tracker in this repository to report bugs.