artifacthub/hub

Kubernetes包管理工具镜像

镜像概述和主要用途

本镜像是一款轻量级Kubernetes包管理工具的容器化实现，旨在简化Kubernetes生态中各类资源包（如Helm Chart、Kustomize配置、Operator等）的全生命周期管理。其核心功能包括查找远程仓库中的Kubernetes包、将指定包安装到目标Kubernetes集群，以及将自定义或修改后的包发布至私有/公共仓库，适用于简化Kubernetes资源的分发、部署与版本控制流程。

核心功能和特性

• 包查找：支持搜索指定仓库（公共/私有）中的Kubernetes包，可按名称、版本、标签等条件筛选，返回包元数据（描述、版本列表、依赖关系等）。
• 包安装：自动解析包依赖，将选定版本的包部署至目标Kubernetes集群，并支持指定命名空间、资源覆盖配置及安装后健康检查。
• 包发布：提供标准化流程将自定义Kubernetes包（如Helm Chart、Kustomize目录）打包并发布至指定仓库，支持版本号自动递增与元数据校验。
• 版本控制：支持多版本包管理，可查看历史版本、回滚至指定版本，并维护版本变更记录。
• 多仓库支持：兼容主流Kubernetes包仓库（如Artifact Hub、ChartMuseum、Git仓库等），支持同时配置多个仓库源。

使用场景和适用范围

• 开发环境快速部署：开发者可通过本工具快速查找并安装常用Kubernetes组件（如Ingress控制器、监控组件），加速本地开发环境搭建。
• 生产环境标准化部署：在生产集群中通过固定版本的包进行部署，确保环境一致性，降低配置漂移风险。
• 团队内部包共享：团队可将自定义业务组件打包后通过私有仓库共享，统一资源交付标准。
• CI/CD流程集成：作为CI/CD流水线的中间件，实现自动化包查找、版本验证及发布，支持GitOps工作流。

使用方法和配置说明

前置条件

• 目标环境需安装Docker Engine（20.10+）。
• 如需与Kubernetes集群交互，需挂载本地KUBECONFIG文件或配置集群访问凭证。

基础使用（docker run）

1. 查找仓库中的Kubernetes包

bash
docker run --rm \
  -e REPO_URL=https://artifacthub.io/api/v1 \  # 仓库地址  
  kube-package-manager search nginx  # 搜索名称包含"nginx"的包  

2. 安装指定包到Kubernetes集群

bash
docker run --rm \
  -v $HOME/.kube/config:/root/.kube/config \  # 挂载Kubernetes配置文件  
  -e REPO_URL=https://charts.bitnami.com/bitnami \  
  -e NAMESPACE=default \  # 目标命名空间  
  kube-package-manager install nginx --version 15.3.0  # 安装指定版本的nginx包  

3. 发布自定义包至私有仓库

bash
docker run --rm \
  -v $PWD/custom-chart:/app/chart \  # 挂载本地自定义包目录  
  -e REPO_URL=https://private-repo.example.com \  
  -e REPO_USER=admin \  # 仓库认证用户名  
  -e REPO_PASS=secret \  # 仓库认证密码  
  kube-package-manager publish /app/chart --version 1.0.0  # 发布版本1.0.0  

Docker Compose配置示例

yaml
version: '3.8'
services:
  kube-package:
    image: kube-package-manager
    volumes:
      - $HOME/.kube/config:/root/.kube/config  # 挂载Kubernetes配置
      - ./custom-packages:/app/packages        # 挂载本地包目录
    environment:
      - REPO_URL=https://private-repo.example.com  # 默认仓库地址
      - NAMESPACE=production                       # 默认部署命名空间
      - TIMEOUT=30s                                # 操作超时时间
    command: install monitoring-stack --version 2.1.0  # 启动时执行安装命令

配置参数与环境变量

注意事项

1. 集群权限：执行安装/发布操作时，需确保挂载的KUBECONFIG具有目标集群的对应权限（如cluster-admin或命名空间级管理员权限）。
2. 仓库认证：私有仓库需通过REPO_USER和REPO_PASS配置认证信息，或挂载包含认证凭证的配置文件（如~/.netrc）。
3. 包格式兼容性：当前版本支持Helm v3 Chart、Kustomize v4+配置包及OCI格式镜像包，其他格式需通过插件扩展。
4. 资源限制：大规模包操作（如批量安装）建议通过--memory和--cpus参数限制容器资源，避免影响集群稳定性。