portworx/maas-cluster-service-charts

Cluster Service Charts 镜像文档

镜像概述

Cluster Service Charts 是一个集成了集群服务部署配置模板（Charts）的Docker镜像，旨在简化Kubernetes等容器编排集群环境中服务的部署流程。该镜像提供预定义的服务部署Charts、配置最佳实践及版本管理机制，帮助用户快速实现集群服务的标准化部署与运维。

核心功能与特性

• 预定义服务Charts：包含常见集群服务（如数据库、消息队列、监控组件等）的预配置Charts，覆盖主流中间件及基础设施服务。
• 配置标准化：遵循集群部署最佳实践，提供统一的配置模板结构，确保服务部署参数的一致性与可维护性。
• 版本管理：支持Charts版本控制，可通过标签快速切换不同版本的服务配置，适配不同集群环境需求。
• 多环境适配：内置开发、测试、生产等多环境配置模板，支持通过环境变量动态调整配置参数。
• 轻量级设计：基于Alpine基础镜像构建，体积小巧，启动快速，减少集群资源占用。

使用场景与适用范围

• Kubernetes集群部署：用于快速部署标准化服务到Kubernetes集群，简化Helm Charts的管理与分发。
• 微服务架构管理：为微服务集群提供统一的部署配置模板，降低多服务协同部署的复杂度。
• 多环境配置统一：在开发、测试、生产等多环境中保持服务配置的一致性，减少环境差异导致的问题。
• 团队协作标准化：为团队提供统一的服务部署规范，简化协作流程，提高部署效率。

使用方法与配置说明

镜像获取

通过Docker Hub或私有仓库拉取镜像：

bash
docker pull docker.xuanyuan.run/[镜像仓库地址]/cluster-service-charts:[版本标签]
# 示例：docker pull example.com/cluster-service-charts:v1.0.0

基本使用

启动容器

运行容器并挂载本地目录以获取Charts文件：

bash
docker run -d \
  --name cluster-service-charts \
  -v /本地目录/charts:/opt/charts \  # 挂载本地目录用于导出Charts
  -e TARGET_ENV=production \         # 指定目标环境（可选，默认：production）
  -e NAMESPACE=default \             # 指定集群命名空间（可选，默认：default）
  [镜像仓库地址]/cluster-service-charts:[版本标签]

获取Charts文件

容器启动后，预定义的Charts将导出至挂载的本地目录/本地目录/charts，可直接用于Helm部署：

bash
helm install my-service /本地目录/charts/[服务名称] --namespace $NAMESPACE

环境变量配置

容器支持通过环境变量调整配置行为，常用参数如下：

自定义配置

如需添加自定义Charts，可通过挂载自定义配置目录覆盖默认Charts：

bash
docker run -d \
  --name cluster-service-charts \
  -v /本地自定义charts:/opt/charts/custom \  # 挂载自定义Charts目录
  -v /本地目录/charts:/opt/charts/export \   # 导出合并后的Charts
  [镜像仓库地址]/cluster-service-charts:[版本标签]

容器将自动合并默认Charts与自定义Charts，并导出至/opt/charts/export目录。

查看可用Charts

通过容器日志或exec命令查看内置Charts列表：

bash
# 查看日志
docker logs cluster-service-charts

# 或进入容器查看
docker exec -it cluster-service-charts ls /opt/charts

注意事项

• 确保挂载目录具有读写权限，避免容器启动失败。
• 不同版本的镜像可能包含不同的Charts集合，建议通过版本标签明确指定镜像版本。
• 生产环境使用时，建议结合私有镜像仓库管理镜像，避免依赖外部仓库。