Skip to content

📖 Update new provider docs to be more current #12085

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 16 commits into
base: main
Choose a base branch
from

Conversation

cprivitere
Copy link
Member

What this PR does / why we need it: This PR attempts to update the Developing providers section of the Cluster API Book. It updates examples to reflect the current scaffolding provided by kubebuilder, be in line with current cluster api conventions, and fix errors and inconsistencies.

/area documentation

@k8s-ci-robot k8s-ci-robot added area/documentation Issues or PRs related to documentation cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. size/L Denotes a PR that changes 100-499 lines, ignoring generated files. labels Apr 10, 2025
@k8s-ci-robot
Copy link
Contributor

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign sbueringer for approval. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found here.

Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

- created by default since kubebuilder 3.0 in 2020

Signed-off-by: cprivitere <[email protected]>
- referencing deleted comments is very confusing to understand

Signed-off-by: cprivitere <[email protected]>
Signed-off-by: cprivitere <[email protected]>
- Consistently refer to cluster as mailgunCluster
- Add that you need to import the cluster-api package to your project before you can use the util function
- Use mailgunCluster.ObjectMeta instead of a pointer in GetOwnerCluster call
- Add explanation that we need to wait for the Cluster API controller to set the ownerref before we can use the cluster object, update code to do that
- Show entire Reconcile function again after adding many lines to it

Signed-off-by: cprivitere <[email protected]>
- Provide directions that work with current kubebuilder output
- Provide simpler example overriding of image name
- Drop old no longer working example of image name patching
- Providing a more current example of how providers actually do this would involve teaching about CI/CD setups which seems out of scope for this document

Signed-off-by: cprivitere <[email protected]>
- Old section didn't work anymore
- replace it with a link to the quick start guide
- Suggest/note that we assume the user will use kind and clusterctl init, which will install cert-manager automatically.
- Update Condition status example to match what a kubectl describe currently shows

Signed-off-by: cprivitere <[email protected]>
- Show how to load the image into kind
- Use a tag that isn't latest so kubernetes won't try to pull it from docker hub
- Update Conditions fields to current kubernetes output

Signed-off-by: cprivitere <[email protected]>
- Tilt example wasn't functional as it was
- Added go_main to point to where kubebuilder puts main.go
- Use make tilt-up instead of trying to build your own kind cluster to proerly set up tilt to use the local registry config showin in the example tilt files

Signed-off-by: cprivitere <[email protected]>
@cprivitere cprivitere force-pushed the new-provider-docs-review branch from 65f07fd to a84e84a Compare April 10, 2025 21:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area/documentation Issues or PRs related to documentation cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. size/L Denotes a PR that changes 100-499 lines, ignoring generated files.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants