Skip to content

Commit fa71199

Browse files
Updates
1 parent 3eb3536 commit fa71199

8 files changed

Lines changed: 28 additions & 20 deletions

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

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,8 @@ ms.custom: sap:Other issue or questions related to Fleet manager
99

1010
# Resource propagation failure: PlacementApplied is False
1111

12+
## Summary
13+
1214
This article discusses how to troubleshoot resource application failures when you propagate resources by using placement APIs in Microsoft Azure Kubernetes Fleet Manager. This issue applies to both `ClusterResourcePlacement` and `ResourcePlacement`, each with their own dedicated custom resource condition types:
1315

1416
- `ClusterResourcePlacementApplied` for ClusterResourcePlacement
@@ -294,14 +296,16 @@ Check the `Work` status, particularly the `manifestConditions` section. You can
294296

295297
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.
296298

297-
## General Troubleshooting Notes
299+
## General troubleshooting notes
298300

299301
The troubleshooting process and Work object inspection are identical for both placement types:
302+
300303
- Both use the same underlying Work API to apply resources to member clusters.
301304
- The Work object status and manifestConditions have the same structure regardless of the placement type that created them.
302305
- 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.
303306

304307
For ResourcePlacement-specific considerations:
308+
305309
- Ensure the target namespace exists on member clusters before the ResourcePlacement tries to apply resources to it
306310
- ResourcePlacement can only select resources within the same namespace where the ResourcePlacement object itself resides
307311

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

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,8 @@ ms.custom: sap:Other issue or questions related to Fleet manager
99

1010
# Resource propagation failure: PlacementAvailable is False
1111

12+
## Summary
13+
1214
This article discusses how to troubleshoot resource availability failures when you propagate resources by using placement APIs in Microsoft Azure Kubernetes Fleet Manager. This issue applies to both `ClusterResourcePlacement` and `ResourcePlacement`, each with their own dedicated custom resource condition types:
1315

1416
- `ClusterResourcePlacementAvailable` for ClusterResourcePlacement
@@ -255,14 +257,12 @@ In the situation, check the deployment in the member cluster because the message
255257
256258
For all other situations, make sure that the propagated resource is configured correctly. Additionally, verify that the selected cluster has sufficient available capacity to accommodate the new resources.
257259
258-
## General Troubleshooting Notes
260+
## General troubleshooting notes
259261
260262
The troubleshooting process and Work object inspection are identical for both placement types:
263+
261264
- Both use the same underlying Work API to apply resources to member clusters.
262265
- The Work object status and manifestConditions have the same structure regardless of the placement type that created them.
263266
- The `Available` condition in the Work status indicates whether the applied resources are now available on the member cluster.
264267
- 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.
265268
266-
267-
[!INCLUDE [Azure Help Support](../../../includes/azure-help-support.md)]
268-

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

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,8 @@ ms.custom: sap:Other issue or questions related to Fleet manager
99

1010
# Resource propagation failure: PlacementOverridden is False
1111

12+
## Summary
13+
1214
This article discusses how to troubleshoot override failures when you propagate resources by using placement APIs in Microsoft Azure Kubernetes Fleet Manager. This issue applies to both `ClusterResourcePlacement` and `ResourcePlacement`, each with their own dedicated custom resource condition types:
1315

1416
- `ClusterResourcePlacementOverridden` for ClusterResourcePlacement
@@ -205,7 +207,7 @@ jsonPatchOverrides:
205207

206208
The code adds the new label `newlabel` that has the value `new-value` to the ClusterRole `secret-reader`.
207209

208-
## General Notes
210+
## General notes
209211

210212
For ResourcePlacement, the override flow is identical except that all the resources reside in the same namespace. Use `ResourceOverride` instead of `ClusterResourceOverride` and expect `ResourcePlacementOverridden` in conditions.
211213

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

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,8 @@ ms.custom: sap:Other issue or questions related to Fleet manager
88
---
99
# Resource propagation failure: PlacementRolloutStarted is false
1010

11+
## Summary
12+
1113
This article describes how to troubleshoot rollout initiation failures when you propagate resources using placement APIs in Azure Kubernetes Fleet Manager. This issue applies to both `ClusterResourcePlacement` and `ResourcePlacement`, each with their own dedicated custom resource condition types:
1214

1315
- `ClusterResourcePlacementRolloutStarted` for ClusterResourcePlacement
@@ -404,9 +406,7 @@ After you create the `test-ns` namespace on the hub cluster, the rollout control
404406

405407
In this situation, to address this issue, consider manually setting `maxUnavailable` to a value greater than `1` to relax the `RollingUpdate` configuration. Alternatively, you can join a third member cluster.
406408

407-
## General Notes
409+
## General notes
408410

409411
The rollout failure investigation flow is identical for ClusterResourcePlacement and ResourcePlacement. Only the snapshot object kind differs. Replace ClusterResourcePlacement (CRP)-specific object kinds with their ResourcePlacement (RP) equivalents when working with namespace-scoped placements.
410412

411-
[!INCLUDE [Azure Help Support](../../../includes/azure-help-support.md)]
412-

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

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,8 @@ ms.custom: sap:Other issue or questions related to Fleet manager
88
---
99
# Resource propagation failure: PlacementScheduled is false
1010

11+
## Summary
12+
1113
This article describes how to troubleshoot scheduling failures when you propagate resources using placement APIs in Azure Kubernetes Fleet Manager. This issue applies to both `ClusterResourcePlacement` and `ResourcePlacement`, each with their own dedicated custom resource condition types:
1214

1315
- `ClusterResourcePlacementScheduled` for ClusterResourcePlacement
@@ -244,8 +246,7 @@ status:
244246

245247
In this scenario, to resolve this issue, add the `env:prod` label to the member cluster resource for `kind-cluster-2` as well, so that the scheduler can select the cluster to propagate resources.
246248

247-
## General Notes
248-
The scheduling failure investigation flow is identical for ClusterResourcePlacement and ResourcePlacement; only the snapshot object kind differs. Replace ClusterResourcePlacement (CRP)-specific object kinds with their ResourcePlacement (RP) equivalents when working with namespace-scoped placements.
249+
## General notes
249250

250-
[!INCLUDE [Azure Help Support](../../../includes/azure-help-support.md)]
251+
The scheduling failure investigation flow is identical for ClusterResourcePlacement and ResourcePlacement; only the snapshot object kind differs. Replace ClusterResourcePlacement (CRP)-specific object kinds with their ResourcePlacement (RP) equivalents when working with namespace-scoped placements.
251252

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

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,8 @@ ms.custom: sap:Other issue or questions related to Fleet manager
88
---
99
# Resource propagation failure: WorkSynchronized is false
1010

11+
## Summary
12+
1113
This article describes how to troubleshoot work synchronization failures when you propagate resources using placement APIs in Azure Kubernetes Fleet Manager. This issue applies to both `ClusterResourcePlacement` and `ResourcePlacement`, each with their own dedicated custom resource condition types:
1214

1315
- `ClusterResourcePlacementWorkSynchronized` for ClusterResourcePlacement
@@ -165,8 +167,7 @@ In this situation, here are several potential solutions:
165167

166168
In other situations, you might opt to wait for the work to finish propagating.
167169

168-
## General Notes
169-
For ResourcePlacement, the investigation is identical—inspect `.status.placementStatuses[*].conditions` for `WorkSynchronized` and check the associated Work in the `fleet-member-{clusterName}` namespace.
170+
## General notes
170171

171-
[!INCLUDE [Azure Help Support](../../../includes/azure-help-support.md)]
172+
For ResourcePlacement, the investigation is identical—inspect `.status.placementStatuses[*].conditions` for `WorkSynchronized` and check the associated Work in the `fleet-member-{clusterName}` namespace.
172173

support/azure/kubernetes-fleet/cluster-resource-placement/troubleshoot-clusterresourceplacement-api-issues.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,8 @@ ms.custom: sap:Other issue or questions related to Fleet manager
99

1010
# Troubleshooting ClusterResourcePlacement API in Azure Kubernetes Fleet Manager
1111

12+
## Summary
13+
1214
This troubleshooting guide helps you resolve `ClusterResourcePlacement` API object-related issues when you use Azure Kubernetes Fleet Manager. Troubleshooting these errors on the hub cluster requires knowledge of the following objects:
1315

1416
- `ClusterResourceSnapshot`
@@ -160,6 +162,4 @@ To find the correct work resource, follow these steps:
160162
```
161163

162164
> [!NOTE]
163-
> In this command, replace `{clusterName}` and `{CRPName}` with the names that you identified in the first step.
164-
165-
165+
> In this command, replace `{clusterName}` and `{CRPName}` with the names that you identified in the first step.

support/azure/kubernetes-fleet/cluster-resource-placement/troubleshoot-resource-placement-issues.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,8 @@ ms.custom: sap:Other issue or questions related to Fleet manager
1010

1111
# Troubleshooting ResourcePlacement API in Azure Kubernetes Fleet Manager (preview)
1212

13+
## Summary
14+
1315
This troubleshooting guide helps you resolve `ResourcePlacement` API object-related issues when you use Azure Kubernetes Fleet Manager. Troubleshooting these errors on the hub cluster requires knowledge of the following objects:
1416

1517
- `ResourceSnapshot`
@@ -230,5 +232,3 @@ To find the correct work resource, follow these steps:
230232

231233
> [!NOTE]
232234
> In this command, replace `{clusterName}` and `{RPName}` with the names that you identified in the first step.
233-
234-
[!INCLUDE [Azure Help Support](../../../includes/azure-help-support.md)]

0 commit comments

Comments
 (0)