Crossplane资源创建READY:False卡滞，如何排查与追踪错误？

1. 从Claim和复合资源（XR）入手排查 #

• 查看Claim的状态与事件：

  kubectl get claims
  kubectl describe claim <你的Claim名称>
  

  重点关注Status.Conditions里的Reason和Message字段，以及Events栏的报错信息，确认Claim是否成功绑定到对应的XR。
• 查看关联的复合资源（XR）状态：

  kubectl get xrs
  kubectl describe xr <XR名称>
  

  检查XR的Status.Conditions，确认Composition是否正常生成子资源，有没有资源创建的触发记录。

2. 检查生成的托管资源（Managed Resources） #

Crossplane会通过Composition将XR拆分为具体的Azure资源实例，直接查看这些托管资源的状态：

• 列出所有托管资源：

  kubectl get managed
  

• 定位目标StorageAccount和ResourceGroup资源并查看详情：

  # 查看存储账户
  kubectl get storageaccounts.storage.azure.upbound.io
  kubectl describe storageaccounts.storage.azure.upbound.io <存储账户资源名称>
  # 查看资源组
  kubectl get resourcegroups.azure.upbound.io
  kubectl describe resourcegroups.azure.upbound.io <资源组资源名称>
  

  重点关注Status.Conditions中的错误原因，比如：
  • 存储账户名称不符合Azure命名规则（必须3-24位小写字母+数字）
  • 权限不足导致Azure API调用失败
  • SKU或区域参数配置错误

3. 验证Provider和ProviderConfig状态 #

• 确认Provider是否正常就绪：

  kubectl get providers
  

  如果READY状态为False，查看Provider详情和Pod日志：

  kubectl describe provider provider-azure-storage
  kubectl get pods -n crossplane-system
  kubectl logs -n crossplane-system <provider-azure-storage的Pod名称>
  

  日志中会包含Azure API调用的具体错误，比如凭据无效、网络不通等。
• 检查ProviderConfig的有效性：

  kubectl describe providerconfig <你的ProviderConfig名称>
  

  确认凭据对应的Azure服务主体拥有足够权限（比如Contributor或Storage Account Contributor角色），且Secret中的凭据信息格式正确（避免泄露敏感信息，仅需确认Secret存在）。

4. 核对Composition和CRD配置 #

• 检查Composition模板中StorageAccount的参数是否符合Azure要求：
  • 存储账户名称是否合规
  • SKU名称（如Standard_LRS）是否正确
  • 区域是否与ResourceGroup一致
  • 其他配置项（如allowBlobPublicAccess）是否符合Azure API规范
• 确认CompositeResourceDefinition（XRD）的schema定义与Claim、Composition的字段匹配，无字段不兼容情况。

5. 查看Crossplane核心组件日志 #

如果以上步骤未找到问题，查看Crossplane核心Pod的日志，排查资源调度或转换过程中的错误：

kubectl logs -n crossplane-system crossplane-<核心Pod ID>

内容的提问来源于stack exchange，提问作者jonashackt