-
Notifications
You must be signed in to change notification settings - Fork 1.3k
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
🌱 Test and document controller ownerReferences #9153
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -16,65 +16,67 @@ CAPI uses owner references in an opinionated way. The following guidelines shoul | |
|
||
## Owner reference relationships in Cluster API | ||
|
||
The below tables map out the a reference for ownership relationships for the objects in a Cluster API cluster. | ||
The below tables map out the a reference for ownership relationships for the objects in a Cluster API cluster. The tables are identical for classy and non-classy clusters. | ||
|
||
|
||
Providers may implement their own ownership relationships which may or may not map directly to the below tables. | ||
These owner references are almost all tested in an [end-to-end test](https://github.com/kubernetes-sigs/cluster-api/blob/caaa74482b51fae777334cd7a29595da1c06481e/test/e2e/quick_start_test.go#L31). Lack of testing is noted where this is not the case. CAPI Providers can take advantage of the e2e test framework to ensure their owner references are predictable, documented and stable. | ||
|
||
Kubernetes core types | ||
|
||
killianmuldoon marked this conversation as resolved.
Show resolved
Hide resolved
|
||
| type | Owner | Note | | ||
|-----------|---------------------|------------------------------------------| | ||
| Secret | KubeadmControlPlane | For cluster certificates | | ||
| Secret | KubeadmConfig | For bootstrap secrets | | ||
| Secret | ClusterResourceSet | When created by CRS. Not covered in e2e. | | ||
| ConfigMap | ClusterResourceSet | When created by CRS | | ||
| type | Owner | Controller | Note | | ||
|-----------|---------------------|------------|--------------------------------------------| | ||
| Secret | KubeadmControlPlane | yes | For cluster certificates | | ||
| Secret | KubeadmConfig | yes | For bootstrap secrets | | ||
| Secret | ClusterResourceSet | no | When referenced by CRS. Not tested in e2e. | | ||
| ConfigMap | ClusterResourceSet | no | When referenced by CRS | | ||
|
||
## Core types | ||
|
||
| type | Owner | Note | | ||
|---------------------|---------------------|----------------------------| | ||
| ExtensionConfig | None | | | ||
| ClusterClass | None | | | ||
| Cluster | None | | | ||
| MachineDeployments | Cluster | | | ||
| MachineSet | MachineDeployment | | | ||
| Machine | MachineSet | When created by MachineSet | | ||
| Machine | KubeadmControlPlane | When created by KCP | | ||
| MachineHealthChecks | Cluster | | | ||
| type | Owner | Controller | Note | | ||
|---------------------|---------------------|------------|----------------------------| | ||
| ExtensionConfig | None | | | | ||
| ClusterClass | None | | | | ||
| Cluster | None | | | | ||
| MachineDeployments | Cluster | no | | | ||
| MachineSet | MachineDeployment | yes | | | ||
| Machine | MachineSet | yes | When created by MachineSet | | ||
| Machine | KubeadmControlPlane | yes | When created by KCP | | ||
| MachineHealthChecks | Cluster | no | | | ||
|
||
|
||
|
||
## Experimental types | ||
| type | Owner | Note | | ||
|----------------------------|--------------------|------| | ||
| ClusterResourcesSet | None | | | ||
| ClusterResourcesSetBinding | ClusterResourceSet | | | ||
| MachinePool | Cluster | | | ||
| type | Owner | Controller | Note | | ||
|----------------------------|--------------------|------------|--------------------------| | ||
| ClusterResourcesSet | None | | | | ||
| ClusterResourcesSetBinding | ClusterResourceSet | no | May have many CRS owners | | ||
| MachinePool | Cluster | unknown | Not tested in e2e | | ||
|
||
|
||
## KubeadmControlPlane types | ||
| type | Owner | Note | | ||
|-----------------------------|--------------|------| | ||
| KubeadmControlPlane | Cluster | | | ||
| KubeadmControlPlaneTemplate | ClusterClass | | | ||
| type | Owner | Controller | Note | | ||
|-----------------------------|--------------|------------|------| | ||
| KubeadmControlPlane | Cluster | yes | | | ||
| KubeadmControlPlaneTemplate | ClusterClass | no | | | ||
|
||
|
||
## Kubeadm bootstrap types | ||
| type | Owner | Note | | ||
|-----------------------|--------------|-------------------------------------------| | ||
| KubeadmConfig | Machine | When created for Machine | | ||
| KubeadmConfig | MachinePool | When created for MachinePool | | ||
| KubeadmConfigTemplate | Cluster | When referenced in MachineDeployment spec | | ||
| KubeadmConfigTemplate | ClusterClass | When referenced in ClusterClass | | ||
| type | Owner | Controller | Note | | ||
|-----------------------|--------------|------------|-------------------------------------------------| | ||
| KubeadmConfig | Machine | yes | When created for Machine | | ||
| KubeadmConfig | MachinePool | unknown | When created for MachinePool. Not tested in e2e | | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. We no longer test MachinePools in the quick start so this isn't covered. I can open an issue for this and tag folks that work regularly on MachinePools. |
||
| KubeadmConfigTemplate | Cluster | no | When referenced in MachineDeployment spec | | ||
| KubeadmConfigTemplate | ClusterClass | no | When referenced in ClusterClass | | ||
|
||
## Infrastructure provider types | ||
| type | Owner | Note | | ||
|-------------------------------|--------------|---------------------------------------------| | ||
| InfrastructureMachine | Machine | | | ||
| InfrastructureMachineTemplate | Cluster | When created by cluster topology controller | | ||
| InfrastructureMachineTemplate | ClusterClass | When referenced in a ClusterClass | | ||
| InfrastructureCluster | Cluster | | | ||
| InfrastructureClusterTemplate | ClusterClass | | | ||
| InfrastructureMachinePool | MachinePool | | | ||
| type | Owner | Controller | Note | | ||
|-------------------------------|--------------|------------|---------------------------------------------| | ||
| InfrastructureMachine | Machine | yes | | | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Similar to KubeadmConfig - this is passed over from the MachineSet / KCP controller. |
||
| InfrastructureMachineTemplate | Cluster | no | When created by cluster topology controller | | ||
| InfrastructureMachineTemplate | ClusterClass | no | When referenced in a ClusterClass | | ||
| InfrastructureCluster | Cluster | yes | | | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Not true for classy clusters. Should probably be reverted to no. |
||
| InfrastructureClusterTemplate | ClusterClass | no | | | ||
| InfrastructureMachinePool | MachinePool | unknown | Not tested in e2e | | ||
|
||
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
classy and non-classy are the same as far as testing goes. I'm happy to have this as a principle to reduce complexity, but there's certain points where it may not make sense. e.g. for classy clusters KCP is created by the cluster controller, but for non-classy clusters it may be created by the user.