# fk-drdb-hwameistor **Repository Path**: g-k8s/fk-drdb-hwameistor ## Basic Information - **Project Name**: fk-drdb-hwameistor - **Description**: https://github.com/hwameistor/hwameistor - **Primary Language**: Go - **License**: Apache-2.0 - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2024-11-29 - **Last Updated**: 2024-11-29 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # HwameiStor [English](./README.md) | 简体中文 HwameiStor 是一款 Kubernetes 原生的容器附加存储 (CAS) 解决方案，将 HDD、SSD 和 NVMe 磁盘形成本地存储资源池进行统一管理，使用 CSI 架构提供分布式的本地数据卷服务，为有状态的云原生应用或组件提供数据持久化能力。 ![System architecture](./docs/i18n/cn/docusaurus-plugin-content-docs/current/img/architecture.png) ## 目前状态 ![CNCF logo](./docs/docs/img/cncf-cloud-gophers-transparent.png) **HwameiStor 是一个[云原生计算基金会 (CNCF)](https://cncf.io/) 沙箱孵化项目。** HwameiStor 的最新版本为 [![hwameistor-releases](https://img.shields.io/github/v/release/hwameistor/hwameistor.svg?include_prereleases)](https://github.com/hwameistor/hwameistor/releases) ## 构建状态 ![period-check](https://github.com/hwameistor/hwameistor/actions/workflows/period-check.yml/badge.svg) [![codecov](https://codecov.io/gh/hwameistor/hwameistor/branch/main/graph/badge.svg?token=AWRUI46FEX)](https://codecov.io/gh/hwameistor/hwameistor) [![OpenSSF Best Practices](https://bestpractices.coreinfrastructure.org/projects/5685/badge)](https://bestpractices.coreinfrastructure.org/projects/5685) ## 发版状态 参阅[当前发行版](https://github.com/hwameistor/hwameistor/releases)。 ## 运行环境 ### Kubernetes 兼容性 | Kubernetes | v0.4.3 | >=v0.5.0 | >= 0.13.0 | | -------------- | ------ | -------- | --------- | | >=1.18&&<=1.20 | 是 | 否 | 否 | | 1.21 | 是 | 是 | 否 | | 1.22 | 是 | 是 | 否 | | 1.23 | 是 | 是 | 否 | | 1.24 | 是 | 是 | 是 | | 1.25 | 否 | 是 | 是 | | 1.26 | 否 | 是 | 是 | | 1.27 | 否 | 否 | 是 | | 1.28 | 否 | 否 | 是 | | 1.29 | 否 | 否 | 是 | | 1.30 | 否 | 否 | 是 | ## 模块和代码 HwameiStor 包含若干模块： * [本地磁盘管理器](#local-disk-manager) * [本地存储](#local-storage) * [调度器](#scheduler) * [准入控制器](#admission-controller) * [驱逐器](#evictor) * [指标采集器](#exporter) * [高可用模块安装器 DRDB](#高可用模块安装器) * [数据卷快照](#数据卷快照) * [数据卷自动扩容](#数据卷自动扩容) * [数据卷 IO 访问控制](#数据卷-io-访问控制) * [故障转移](#应用故障转移) * [审计日志](#审计日志) * [图形界面](#图形化用户界面) ### local-disk-manager local-disk-manager（LDM）旨在管理节点上的磁盘。 像 local-storage 等其他模块可以利用 LDM 提供的磁盘管理功能。 [了解更多](docs/docs/modules/ldm.md) ### local-storage local-storage（LS）提供了一个云原生的本地存储系统。 它旨在为应用程序提供具有本地访问权限的高性能持久 LVM 卷。 [了解更多](docs/docs/modules/ls.md) ### Scheduler Scheduler 可以自动将 Pod 调度到具有相关 HwameiStor 卷的正确节点。 [了解更多](docs/docs/modules/scheduler.md) ### admission-controller admission-controller 是一种 Webhook，可以自动确定哪个 Pod 使用 HwameiStor 卷， 并帮助修改 schedulerName 为 hwameistor-scheduler。 [了解更多](docs/docs/modules/admission_controller.md) ### Evictor 驱逐器（Evictor）用于在节点或 Pod 驱逐的情况下自动迁移 HwameiStor 卷。 当按计划或未按计划驱逐节点或 Pod 时，将自动检测并从节点迁移具有副本的关联 HwameiStor 卷。 [了解更多](docs/docs/modules/evictor.md) ### 高可用模块安装器 DRBD（Distributed Replicated Block Device）是 HwameiStor 将利用的第三方高可用模块之一，用于提供高可用卷。 它由 Linux 内核模块和相关脚本组成，用于构建高可用集群。通过在网络上镜像整个设备来实现，可以看作是一种网络 RAID。 这个安装器可以直接将 DRBD 安装到容器集群中。 ### Exporter Exporter 将收集系统指标，包括节点、存储池、卷、磁盘等。支持 Prometheus。 [了解更多](docs/docs/modules/evictor.md) ### 数据卷快照 HwameiStor 目前可以为非高可用的 LVM 数据卷提供快照及还原功能。使用 CSI 的快照标准接口。 [了解更多](docs/docs/volumes/volume_snapshot.md) ### 数据卷自动扩容 系统可以根据用户配置的规则，为 LVM 数据卷自动扩容。一旦配置后，无需用户干预。 [了解更多](docs/docs/volumes/pvc_autoresizing.md) ### 数据卷 IO 访问控制 用户可以为某个数据卷设置最大访问速率（例如：带宽、IOPS），目的是为了在资源共享的情况下，避免过度地影响其他应用的数据访问。 [了解更多](docs/docs/volumes/volume_provisioned_io.md) ### 应用故障转移 该功能主要是在应用发生故障时，快速主动地将应用迁移至另外的健康节点上，同时保证新节点上有需要访问的数据卷副本。 因此，该功能主要针对使用高可用数据卷的应用。[了解更多](docs/docs/fast_failover.md) ### 审计日志 系统为各个资源提供了历史操作信息。 [了解更多](docs/docs/system_audit.md) ### 图形化用户界面 HwameiStor 提供了友好的用户界面. [了解更多](docs/docs/modules/gui.md) ## 文档 有关完整文档，请参阅文档站 [hwameistor.io](https://hwameistor.io/docs/intro)。 有关已在生产环境或用户验收测试环境中部署了 HwameiStor 的详细用户清单，请查阅 [HwameiStor 用户列表](./adopters.md)。 ### 本地构建和预览 推荐在提交 PR 之前在本地构建和预览，这样可以避免将问题带到线上。 您可以运行以下命令进行本地预览： ```bash cd docs npm run start # 英文 npm run start -- --locale cn # i18n/cn ``` ### 更改导航 要更改导航（左边栏目录）的顺序，您可以更改每个文件夹中的 `_category_.json`。 ```json { "label": "Installation", // 导航中显示的章节标题 "position": 4, // 顺序或权重，1 排在第一个 "link": { "type": "generated-index", "description": "In this section, we will introduce the installation procedure:" } } ``` 对于 i18n/cn，您可以通过 `current.json` 修改目录： ```json { "sidebar.tutorialSidebar.category.Modules": { "message": "Modules", // 导航中显示的章节标题 "description": "The label for category Modules in sidebar tutorialSidebar" }, "sidebar.tutorialSidebar.category.Modules.link.generated-index.description": { "message": "This chapter introduces the following modules included in HwameiStor:", "description": "The generated-index page description for category Modules in sidebar tutorialSidebar" } } ``` ## Roadmap | 特性 | 状态 | 版本 | 说明 | | -------------------- | -------- | ------- | ---------------------------------- | | LVM 卷 CSI | 完成 | v0.3.2 | 用 lvm 制备卷 | | 磁盘卷 CSI | 完成 | v0.3.2 | 用磁盘制备卷 | | HA LVM 卷 | 完成 | v0.3.2 | 高可用卷 | | LVM 卷扩容 | 完成 | v0.3.2 | 在线扩展 LVM 容量 | | LVM 卷转换 | 完成 | v0.3.2 | 将 LVM 卷转换为高可用卷 | | LVM 卷迁移 | 完成 | v0.4.0 | 将 LVM 卷副本迁移到不同的节点 | | 卷组 (VG) | 完成 | v0.3.2 | 支持卷组分配 | | 磁盘健康检查 | 完成 | v0.7.0 | 磁盘故障预测、状态报告 | | LVM 高可用卷恢复 | 计划中 | | 恢复有故障的 LVM HA 卷 | | HwameiStor Operator | 完成 | v0.9.0 | HwameiStor Operator 用于安装和维护等 | | 可观测性 | 完成 | v0.9.2 | 支持指标、日志等可观测性 | | 故障转移 | 完成 | v0.12.0 | HwameiStor 卷对 Pod 进行故障转移 | | IO 访问控制 | 完成 | v0.11.0 | 限制访问 HwameiStor 卷的 IO 带宽 | | 换盘 | 计划中 | | 更换故障或即将故障的磁盘 | | LVM 卷自动扩容 | 完成 | v0.12.0 | 自动扩展 LVM 卷 | | LVM 卷快照 | 完成 | v0.12.0 | LVM 卷快照 | | LVM 卷克隆 | 完成 | v0.13.1 | 克隆 LVM 卷 | | LVM 卷薄制备 | 还未计划 | | LVM 卷薄制备 | | LVM 卷条带模式 | 还未计划 | | LVM 卷条带读写 | | 数据加密 | 完成 | v0.16.0 | 数据加密 | | 系统一致性 | 计划中 | | 一致性检查和灾难恢复 | | 卷备份 | 计划中 | | 将卷数据备份到远程服务器并恢复 | | HwameiStor 命令行界面 | 完成 | v0.12.4 | 提供命令行方式管理 HwameiStor 集群 | | HwameiStor 用户界面 | 完成 | v0.11.0 | 提供可视化界面管理 HwameiStor 集群 | | 缓存数据卷 | 完成 | v0.14.5 | 加速节点上的数据集加载 | ## 社区 我们欢迎任何形式的贡献。如果您有任何有关贡献方面的疑问，请参阅[贡献指南](./CONTRIBUTING.md)。 ### 博客 请关注我们的[每周博客](https://hwameistor.io/blog)。 ### Slack 如果你想加入我们在 CNCF Slack 的 hwameistor 频道，**请先[接受 CNCF Slack 邀请](https://slack.cncf.io/)**，然后加入 [#hwameistor](https://cloud-native.slack.com/messages/hwameistor)。 ### 微信 HwameiStor 技术沟通群： ![扫描二维码入群](./docs/docs/img/wechat.png) ## 讨论 欢迎在 [Discussion](https://github.com/hwameistor/hwameistor/discussions) 查阅 Roadmap 相关的讨论。 ## PR 和 Issue 欢迎与开发团队聊天沟通，也非常欢迎一切形式的 PR 和 Issue。 我们将尽力回应在社区报告的每个问题，但我们会首先解决在[此 repo 中报告的](https://github.com/hwameistor/hwameistor/discussions)问题。 ## 许可证 版权所有 (c) 2014-2023 HwameiStor 开发团队 Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

  

HwameiStor 位列 CNCF 云原生全景图。