Skip to content

Commit 65a7faf

Browse files
Wei WengWei Weng
authored andcommitted
applied acrolynx
Signed-off-by: Wei Weng <[email protected]>
1 parent 05c6ad8 commit 65a7faf

1 file changed

Lines changed: 13 additions & 13 deletions

File tree

support/azure/kubernetes-fleet/cluster-resource-placement/crp-clusterresourceplacementapplied-false.md

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -20,19 +20,19 @@ When you use the `ClusterResourcePlacement` or `ResourcePlacement` API object in
2020
2121
## Cause
2222

23-
This issue might occur because of one of the following reasons:
23+
One of the following reasons might cause the issue:
2424

25-
- The resource already exists on the cluster and isn't managed by the fleet controller.
26-
- Another placement (ClusterResourcePlacement or ResourcePlacement) is already managing the resource for the selected cluster by using a different apply strategy.
27-
- The placement doesn't apply the manifest because of syntax errors or invalid resource configurations. This might also occur if a resource is propagated through an envelope object.
25+
- The resource already exists on the cluster and the fleet controller doesn't manage it.
26+
- Another placement (ClusterResourcePlacement or ResourcePlacement) already manages the resource for the selected cluster by using a different apply strategy.
27+
- The placement doesn't apply the manifest because of syntax errors or invalid resource configurations. A resource propagated through an envelope object might also cause the issue.
2828

2929
## Troubleshooting steps
3030

31-
1. **Check `placementStatuses`**: In the placement status section, inspect the `placementStatuses` to identify which clusters have the `ClusterResourcePlacementApplied` (for ClusterResourcePlacement) or `ResourcePlacementApplied` (for ResourcePlacement) condition set to `False` and note down their `clusterName`.
32-
2. **Locate the `Work` object in hub cluster**: Use the identified `clusterName` to locate the `Work` object associated with the member cluster.
31+
1. To identify clusters with the `ClusterResourcePlacementApplied` (for ClusterResourcePlacement) or `ResourcePlacementApplied` (for ResourcePlacement) condition set to `False`, inspect the `placementStatuses` in the placement status section and note down their `clusterName`.
32+
2. To locate the `Work` object associated with the member cluster, use the identified `clusterName`.
3333
- For ClusterResourcePlacement, see [How to find the correct Work resource associated with `ClusterResourcePlacement`](troubleshoot-clusterresourceplacement-api-issues.md#find-work)
3434
- For ResourcePlacement, see [How to find the correct Work resource associated with `ResourcePlacement`](troubleshoot-resourceplacement-api-issues.md#find-work)
35-
3. **Check `Work` object status**: Inspect the status of the `Work` object to understand the specific issues preventing successful resource application.
35+
3. To understand the specific issues preventing successful resource application, inspect the status of the `Work` object.
3636

3737
## Case study: ClusterResourcePlacement
3838

@@ -196,7 +196,7 @@ status:
196196
version: v1
197197
```
198198
199-
In the `failedPlacements` section for `kind-cluster-1`, the `message` fields explain why the resource wasn't applied on the member cluster. In the preceding `conditions` section, the `Applied` condition for `kind-cluster-1` is flagged as `false` and shows the `NotAllWorkHaveBeenApplied` reason. This indicates that the `Work` object that's intended for the member cluster `kind-cluster-1` wasn't applied. For more information, see [How to find the correct Work resource associated with `ClusterResourcePlacement`](troubleshoot-clusterresourceplacement-api-issues.md#find-work).
199+
In the `failedPlacements` section for `kind-cluster-1`, the `message` fields explain why the resource wasn't applied on the member cluster. In the preceding `conditions` section, the `Applied` condition for `kind-cluster-1` is flagged as `false` and shows the `NotAllWorkHaveBeenApplied` reason. The `Work` object intended for the member cluster `kind-cluster-1` wasn't applied. For more information, see [How to find the correct Work resource associated with `ClusterResourcePlacement`](troubleshoot-clusterresourceplacement-api-issues.md#find-work).
200200

201201
### Work status of kind-cluster-1
202202

@@ -263,14 +263,14 @@ Check the `Work` status, particularly the `manifestConditions` section. You can
263263

264264
### Resolution
265265

266-
In this situation, a potential solution is to set the `AllowCoOwnership` to `true` in the ApplyStrategy policy. However, it's important to notice that this decision should be made by the user because the resources might not be shared.
266+
In the situation, set the `AllowCoOwnership` to `true` in the ApplyStrategy policy. However, the user must make the decision because the resources might not be shared.
267267

268268
## General Troubleshooting Notes
269269

270-
The troubleshooting process and Work object inspection are identical for both ClusterResourcePlacement and ResourcePlacement:
271-
- Both use the same underlying Work API to apply resources to member clusters
272-
- The Work object status and manifestConditions have the same structure regardless of whether they were created by a ClusterResourcePlacement or ResourcePlacement
273-
- The main difference is the scope: ClusterResourcePlacement is cluster-scoped and can select both cluster-scoped and namespace-scoped resources, while ResourcePlacement is namespace-scoped and can only select namespace-scoped resources within its own namespace
270+
The troubleshooting process and Work object inspection are identical for both placement types:
271+
- Both use the same underlying Work API to apply resources to member clusters.
272+
- The Work object status and manifestConditions have the same structure regardless of the placement type that created them.
273+
- The main difference is the scope: the cluster-scoped placement can select both cluster-scoped and namespace-scoped resources, while the namespace-scoped placement can only select namespace-scoped resources within its own namespace.
274274

275275
For ResourcePlacement-specific considerations:
276276
- Ensure the target namespace exists on member clusters before the ResourcePlacement tries to apply resources to it

0 commit comments

Comments
 (0)