文档目录

介绍

欢迎使用雅恩 HelmChart 仓库文档。本文档提供了关于如何使用我们的 Helm Chart 仓库的详细信息。

Helm 是 Kubernetes 的包管理器，它允许您轻松地定义、安装和升级复杂的 Kubernetes 应用程序。Helm Chart 是预配置的 Kubernetes 资源包，可以帮助您快速部署应用程序。

我们的 HelmChart 仓库提供了一系列精心维护的 Chart，涵盖了数据库、监控、网络、存储等多个领域，帮助您快速在 Kubernetes 集群中部署各种应用和服务。

快速开始

要开始使用我们的 HelmChart 仓库，请按照以下步骤操作：

1. 添加仓库

helm repo add yaencn https://helm.yaencn.com/charts

2. 更新仓库

helm repo update

3. 搜索可用的 Chart

helm search repo yaencn

4. 安装 Chart

helm install my-release yaencn/chart-name

安装指南

本节提供了更详细的安装说明，包括各种常见场景和配置选项。

基本安装

使用默认配置安装 Chart：

helm install my-release yaencn/chart-name

使用自定义配置

使用自定义 values 文件安装 Chart：

helm install my-release yaencn/chart-name -f my-values.yaml

或者使用 --set 参数设置单个值：

helm install my-release yaencn/chart-name --set key1=value1,key2=value2

安装特定版本

安装特定版本的 Chart：

helm install my-release yaencn/chart-name --version 1.2.3

升级现有安装

升级已安装的 Chart：

helm upgrade my-release yaencn/chart-name

回滚到之前的版本

回滚到之前的版本：

helm rollback my-release 1

配置选项

每个 Chart 都有自己的配置选项。以下是一些常见的配置示例：

MySQL 配置示例

# values.yaml
mysql:
  image:
    repository: mysql
    tag: 8.0.32
  auth:
    rootPassword: "your-root-password"
    database: "my-database"
    username: "my-user"
    password: "my-password"
  primary:
    persistence:
      enabled: true
      size: 8Gi
  replication:
    enabled: true
  metrics:
    enabled: true

Nginx 配置示例

# values.yaml
nginx:
  image:
    repository: nginx
    tag: 1.25.1
  service:
    type: LoadBalancer
    port: 80
  ingress:
    enabled: true
    hosts:
      - host: example.com
        paths:
          - path: /
            pathType: Prefix
  resources:
    limits:
      cpu: 100m
      memory: 128Mi
    requests:
      cpu: 50m
      memory: 64Mi

最佳实践

以下是使用 Helm Chart 的一些最佳实践：

版本控制

始终指定 Chart 的版本，以确保部署的一致性和可重复性：

helm install my-release yaencn/chart-name --version 1.2.3

使用版本控制管理 values 文件

将自定义的 values 文件存储在版本控制系统中，以跟踪配置更改：

git add values-production.yaml
git commit -m "Update production configuration"

使用命名空间隔离应用

使用命名空间来隔离不同的应用或环境：

kubectl create namespace my-namespace
helm install my-release yaencn/chart-name --namespace my-namespace

定期更新 Chart

定期更新 Chart 以获取最新的功能和安全修复：

helm repo update
helm upgrade my-release yaencn/chart-name

故障排除

以下是一些常见问题及其解决方案：

无法添加仓库

如果您无法添加仓库，请检查以下几点：

  • 确保您的网络连接正常
  • 检查仓库 URL 是否正确
  • 检查是否需要身份验证

安装失败

如果 Chart 安装失败，请尝试以下步骤：

  1. 检查错误消息：helm install --debug ...
  2. 验证 values 文件格式是否正确
  3. 检查 Kubernetes 集群状态
  4. 查看 Pod 日志：kubectl logs ...

升级问题

如果升级过程中遇到问题，可以尝试：

  • 使用 --dry-run 选项预览更改
  • 检查是否有不兼容的配置更改
  • 如果需要，使用 helm rollback 回滚到之前的版本

贡献指南

我们欢迎社区贡献新的 Chart 或改进现有的 Chart。以下是贡献的步骤：

提交新的 Chart

  1. Fork 我们的 GitHub 仓库
  2. 创建一个新的分支
  3. 添加您的 Chart
  4. 确保 Chart 通过 helm lint 检查
  5. 提交 Pull Request

报告问题

如果您发现了问题或有改进建议，请在我们的 GitHub 仓库中提交 Issue。

联系我们

如果您有任何问题或需要帮助，可以通过以下方式联系我们：