fairfaxmedia/concourse-k8s-namespace-resource

Kubernetes命名空间资源镜像

镜像概述

本镜像为Concourse CI/CD系统提供Kubernetes命名空间资源支持，可在流水线中实现Kubernetes命名空间的查询、更新（标签/注解）和删除操作，帮助自动化管理K8s集群中的命名空间资源。

核心功能

1. 获取指定Kubernetes命名空间的详细信息
2. 为命名空间添加或更新标签与注解
3. 删除指定的Kubernetes命名空间
4. 支持通过文件读取命名空间、标签和注解信息
5. 提供调试模式和 dry-run 功能（仅模拟操作不实际执行）

使用场景

• CI/CD流水线中自动化创建或配置K8s命名空间
• 动态更新命名空间的标签/注解以适配业务需求
• 流水线结束后清理临时命名空间

配置说明

资源类型安装

yaml
resource_types:
- name: kubernetes-namespace
  type: docker-image
  source:
    repository: fairfaxmedia/concourse-k8s-namespace-resource

资源配置

yaml
resources:
- name: kubernetes-namespace
  type: kubernetes-namespace
  source:
    cluster_url: https://hostname:port  # 必选，K8s master API地址
    cluster_ca: _base64编码的CA证书_  # 可选，HTTPS时必选
    admin_key: _base64编码的密钥_  # 可选，HTTPS时必选
    admin_cert: _base64编码的证书_  # 可选，HTTPS时必选
    namespace: _目标命名空间_  # 可选，默认操作的命名空间
    debug: "true"  # 可选，启用调试模式

操作参数

in（获取命名空间详情）

• namespace: 可选，覆盖source中的namespace（若source未设置则必选）

out（更新/删除命名空间）

• namespace: 可选，覆盖source中的namespace（若source未设置则必选）
• namespace_file: 可选，从文件读取命名空间名称（替代namespace参数）
• labels: 可选，键值对格式的标签
• labels_file: 可选，从JSON文件读取标签（替代labels参数）
• annotations: 可选，键值对格式的注解
• annotations_file: 可选，从JSON文件读取注解（替代annotations参数）
• dry_run: 可选，仅模拟操作不实际执行
• remove: 可选，设置为true则删除命名空间（替代更新操作）

示例

资源定义

yaml
resources:
- name: k8s-namespace
  type: kubernetes-namespace
  source:
    cluster_url: https://kube-master.domain.example
    cluster_ca: _base64编码的CA证书_
    admin_key: _base64编码的密钥_
    admin_cert: _base64编码的证书_

获取命名空间详情

yaml
- get: k8s-namespace
  params:
    namespace: my-awesome-namespace

更新命名空间标签与注解

yaml
- put: k8s-namespace
  params:
    namespace: my-awesome-namespace
    labels:
      app: my-awesome-application
    annotations:
      k8s.io/thing: plumbus

删除命名空间

yaml
- put: k8s-namespace
  params:
    namespace: my-awesome-namespace
    remove: true