codesuki/concourse-kubernetes-resource

concourse-kubernetes-resource

镜像概述

concourse-kubernetes-resource是一个Concourse资源类型镜像，专门用于在Concourse CI/CD管道中与Kubernetes集群进行交互。它允许Concourse管道通过标准化的资源接口管理Kubernetes资源，实现CI/CD流程与Kubernetes集群的无缝集成。

核心功能

• 与Kubernetes API服务器通信，支持标准Kubernetes资源操作
• 提供Concourse资源的标准接口（check、in、out），实现管道与K8s集群的集成
• 支持Kubernetes资源状态检查、获取与部署
• 兼容标准Kubernetes认证方式（如kubeconfig、服务账户等）

使用场景

• 在CI/CD管道中自动部署应用到Kubernetes集群
• 检查Kubernetes资源状态作为管道执行的前置条件
• 从Kubernetes集群获取资源信息用于后续管道步骤
• 管理Kubernetes资源（如Deployment、ConfigMap、Secret等）的生命周期

使用方法

1. 在Concourse管道中定义资源类型

在pipeline.yml中添加资源类型定义，指定该镜像：

yaml
resource_types:
- name: kubernetes
  type: docker-image
  source:
    repository: concourse/kubernetes-resource
    tag: latest  # 建议使用具体版本号

2. 定义Kubernetes资源

配置与Kubernetes集群的连接信息，创建具体资源：

yaml
resources:
- name: my-k8s-resource
  type: kubernetes
  source:
    kubeconfig: |
      apiVersion: v1
      clusters:
      - cluster:
          server: https://your-k8s-api-server:6443
        name: my-cluster
      contexts:
      - context:
          cluster: my-cluster
          user: my-user
        name: my-context
      current-context: my-context
      users:
      - name: my-user
        user:
          token: your-auth-token  # 或使用client-certificate等其他认证方式
    # 可选：指定要操作的Kubernetes资源类型和名称
    resource:
      apiVersion: apps/v1
      kind: Deployment
      name: my-app
      namespace: default

3. 在任务中使用资源

检查资源状态（check）

Concourse会定期执行check操作，获取Kubernetes资源的当前状态：

yaml
jobs:
- name: check-k8s-status
  plan:
  - get: my-k8s-resource
    trigger: true  # 当资源状态变化时触发任务

获取资源信息（in）

在任务中获取Kubernetes资源的详细信息：

yaml
jobs:
- name: get-k8s-info
  plan:
  - get: my-k8s-resource
    params:
      output_file: k8s-resource-info.yaml  # 将资源信息输出到文件
  - task: process-info
    config:
      platform: linux
      image_resource:
        type: docker-image
        source: {repository: alpine, tag: latest}
      inputs:
      - name: my-k8s-resource
      run:
        path: sh
        args:
        - -c
        - cat my-k8s-resource/k8s-resource-info.yaml

部署资源（out）

更新或部署Kubernetes资源：

yaml
jobs:
- name: deploy-to-k8s
  plan:
  - get: source-code  # 假设包含Kubernetes资源配置文件
  - put: my-k8s-resource
    params:
      file: source-code/k8s/deployment.yaml  # 指定要部署的资源配置文件

配置参数说明

资源类型参数（source）

out操作参数

认证方式

支持多种Kubernetes认证方式，通过kubeconfig配置：

• 令牌认证（token）
• 客户端证书认证（client-certificate和client-key）
• 用户名密码认证（username和password）
• 服务账户认证（在Kubernetes集群内运行时自动使用）