如何使用AWS CDK幂等创建Kubernetes namespace 避免已存在报错

问题原因 #

AWS CDK默认使用客户端kubectl apply创建Kubernetes资源，如果目标命名空间已经存在且未携带CDK生成的kubectl.kubernetes.io/last-applied-configuration注解，就会触发资源已存在的报错。

解决方案 #

方案1：启用服务端Apply实现幂等创建（推荐） #

服务端Apply不需要依赖本地存储的配置注解，直接在Kubernetes APIServer端完成配置合并，天然支持幂等，即使命名空间已存在也不会报错，同时还会同步你在CDK中定义的标签等配置。
修改代码如下：

from aws_cdk import aws_eks as eks

def create_namespace(self) -> eks.KubernetesManifest:
    m = self.cluster.add_manifest(
        f"ns_{self.tenant.name}",
        {
            "apiVersion": "v1",
            "kind": "Namespace",
            "metadata": {
                "name": f"{self.tenant.name}",
                "labels": {
                    "name": f"{self.tenant.name}"
                }
            }
        },
        # 新增服务端Apply配置
        apply_strategy=eks.KubernetesApplyStrategy.server_side_apply(
            force_conflicts=True
        ),
        # 可选：防止CDK误删不在当前栈管理的命名空间资源
        prune=False
    )
    return m

方案2：仅跳过已存在报错，不更新现有命名空间 #

如果你不需要CDK管理已有命名空间的配置，只需要在存在时跳过创建，可以直接指定用create命令加忽略已存在参数：

from aws_cdk import aws_eks as eks

def create_namespace(self) -> eks.KubernetesManifest:
    m = self.cluster.add_manifest(
        f"ns_{self.tenant.name}",
        {
            "apiVersion": "v1",
            "kind": "Namespace",
            "metadata": {
                "name": f"{self.tenant.name}",
                "labels": {
                    "name": f"{self.tenant.name}"
                }
            }
        },
        # 用create命令，忽略已存在报错
        kubectl_command="create",
        kubectl_extra_args=["--ignore-already-exists"]
    )
    return m

方案3：直接导入已有的命名空间 #

如果可以确定命名空间已经提前创建完成，不需要CDK执行创建/更新逻辑，直接导入现有资源即可，完全避免创建请求：

from aws_cdk import aws_eks as eks

# 直接按名称导入已有命名空间
existing_namespace = eks.Namespace.from_namespace_name(
    self, 
    f"imported-ns-{self.tenant.name}", 
    self.tenant.name
)

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