cert-manager安装异常：ArgoCD部署时Certificate资源无法识别

错误原因 #

部署ArgoCD Helm Chart时出现no matches for kind "Certificate" in version "cert-manager.io/v1"，核心原因是cert-manager的CRD资源未完成注册或未正确安装。即使通过kubectl_manifest应用了CRD YAML，Kubernetes也需要时间完成CRD的确认流程，depends_on仅保证资源执行顺序，无法等待CRD完全就绪。

解决方案 #

1. 等待CRD就绪后再部署ArgoCD #

添加null_resource配合本地命令，强制等待cert-manager核心CRD就绪：

# 等待cert-manager CRD就绪
resource "null_resource" "wait_for_cert_manager_crds" {
  count = var.enable_argocd ? 1 : 0

  provisioner "local-exec" {
    command = <<EOT
      until kubectl get crd certificates.cert-manager.io --ignore-not-found; do
        echo "等待cert-manager CRDs就绪..."
        sleep 5
      done
    EOT
    # 若使用AKS，可通过Terraform获取kubeconfig并设置环境变量
    environment = {
      KUBECONFIG = "${path.module}/kubeconfig"
    }
  }

  depends_on = [kubectl_manifest.cert-manager-crds]
}

# 修改ArgoCD模块的依赖
module "argocd" {
  count  = var.enable_argocd ? 1 : 0
  source = "../argocd"

  azure_resource_group_name = data.terraform_remote_state.shared.outputs.resourcegroup.name[0]
  cluster_name              = data.terraform_remote_state.aks.outputs.aks.cluster_name[0]
  description               = "ArgoCD"
  env_name                  = var.env_name
  name                      = data.terraform_remote_state.aks.outputs.aks.cluster_name[0]
  region                    = var.azure_region
  tags                      = {}
  vpc_tags                  = ""
  
  depends_on = [null_resource.wait_for_cert_manager_crds]
}

2. 改用Helm Chart安装cert-manager（推荐） #

使用cert-manager官方Helm Chart安装，会自动处理CRD的安装与就绪逻辑，无需手动管理YAML：

# 安装cert-manager（自动包含CRDs）
resource "helm_release" "cert_manager" {
  count = var.enable_argocd ? 1 : 0

  name       = "cert-manager"
  repository = "https://charts.jetstack.io"
  chart      = "cert-manager"
  version    = "v1.13.3"
  namespace  = "cert-manager"

  create_namespace = true

  set {
    name  = "installCRDs"
    value = "true"
  }
}

# 修改ArgoCD模块依赖
module "argocd" {
  count  = var.enable_argocd ? 1 : 0
  source = "../argocd"

  # 保持原有参数不变
  azure_resource_group_name = data.terraform_remote_state.shared.outputs.resourcegroup.name[0]
  cluster_name              = data.terraform_remote_state.aks.outputs.aks.cluster_name[0]
  description               = "ArgoCD"
  env_name                  = var.env_name
  name                      = data.terraform_remote_state.aks.outputs.aks.cluster_name[0]
  region                    = var.azure_region
  tags                      = {}
  vpc_tags                  = ""
  
  depends_on = [helm_release.cert_manager]
}

3. 检查ArgoCD Helm Chart配置 #

如果你的ArgoCD部署启用了自动TLS证书生成（如server.tls.auto.enabled=true）：

• 若不需要自动证书，关闭该配置即可避免依赖cert-manager；
• 若需要自动证书，确认cert-manager版本与ArgoCD要求的版本兼容（当前v1.13.3兼容大部分新版ArgoCD）。

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