Table of Contents generated with DocToc
This repository built with probot that enforces the Developer Certificate of Origin (DCO) on Pull Requests. It requires all commit messages to contain the Signed-off-by
line with an email address that matches the commit author.
- Submit an issue describing your proposed change to the repo in question.
- The repo owners will respond to your issue promptly.
- Fork the desired repo, develop and test your code changes.
- Commit your changes with DCO
- Submit a pull request.
Anyone may comment on issues and submit reviews for pull requests. However, in order to be assigned an issue or pull request, you must be a member of the IBM GitHub organization.
Repo maintainers can assign you an issue or pull request by leaving a
/assign <your Github ID>
comment on the issue or pull request.
- operator-sdk CLI v1.23.0 or above
-
Edit the
PREV_VERSION
andVERSION
values in the Makefile. -
Edit the image tags in manager.yaml.
-
Edit the image tags in base csv.
-
Re-generate the bundle.
make bundle
-
Verify CSV has all the edits that were made in previous steps.
- operator-sdk CLI v1.23.0 or above
A bundle is a packaging format for the operator, which mainly consists of the CSV and CRDs. Bundles are understood by OLM. The operator-sdk CLI has the capability to create everything necessary to run this bundle on the cluster.
Running the bundle involves ephemerally creating all the necessary OLM objects to ultimately have the operator's deployment running, such as temporary CatalogSource, OperatorGroup, Subscription, etc.
This type of testing is as close as possible to how IBM Foundational services installs ibm-cert-manager-operator
without creating a complete IBM Foundational services' CatalogSource and using ODLM.
-
Verify you can build and push the operator's image to a registry. Check the
REGISTRY
variable in Makefile to see what is the default. Recommended to use your own personal registry that your Open Shift cluster has access to.make push-image-amd64
-
Temporarily edit the
image
field in manager.yaml file to be the operator image you pushed in step 1. -
Verify you can generate the CSV in
bundle/
. Theimage
field in the CSV should be the image you pushed in step 1.make bundle
-
Verify you can build the image for the operator bundle.
make bundle-build
-
Push the bundle up to a registry. Check the
REGISTRY
variable in Makefile to see what is the default. Recommended to use your own personal registry that your Open Shift cluster has access to.make bundle-push
-
Use the built-in operator-sdk feature to run the bundle
make bundle-run
-
Verify operator is running, and you can create the operands by creating a new CertManagerConfig object
-
Revert the
image
change in manager.yaml file, and re-generate the bundle before opening PRmake bundle