From 3dda7603b5f438ee3344624be93397df4b86ee0b Mon Sep 17 00:00:00 2001 From: gitee-bot Date: Mon, 30 Jun 2025 08:58:05 +0000 Subject: [PATCH] Update README.md --- .../google/gnostic/jsonschema/README.md | 114 +++++++++++++++++- 1 file changed, 111 insertions(+), 3 deletions(-) diff --git a/vendor/github.com/google/gnostic/jsonschema/README.md b/vendor/github.com/google/gnostic/jsonschema/README.md index 6793c517..cbde96df 100644 --- a/vendor/github.com/google/gnostic/jsonschema/README.md +++ b/vendor/github.com/google/gnostic/jsonschema/README.md @@ -1,4 +1,112 @@ -# jsonschema -This directory contains code for reading, writing, and manipulating JSON -schemas. + +# KubeOS + +KubeOS 是一个专为 Kubernetes 节点设计的容器化操作系统镜像管理工具集,支持操作系统镜像的升级、配置和部署。它通过统一的 CLI 和后台服务实现安全、可靠和高效的节点操作系统管理。 + +## 功能特点 + +- **升级管理**:支持远程升级 Kubernetes �ansible ible 节点上的操作系统。 +- **配置管理**:通过配置文件动态配置系统参数,如 sysctl、grub、kubelet �://license.coscl.org.cn/MulanPSL2 + +## 使用方式 + +### 编译和部署 + +要从源码构建 KubeOS,请确保你已安装 Rust 和必要的构建工具。使用以下命令构建和部署: + +```bash +make build +make deploy +``` + +### 镜像制作 + +KubeOS 提供 kbimg 工具,用于制作容器镜像、虚拟机镜像和物理机安装镜像。使用方法如下: + +```bash +cd KubeOS-Rust/kbimg +cargo run -- create --file config.toml repo +``` + +`config.toml` 文件包含制作镜像所需的各种参数,如版本、repo 源路径、rootfs 配置等。 + +### 升级操作 + +使用 `proxy` 和 `manager` 组件,KubeOS 可以通过 Kubernetes CRD 控制升级流程。定义一个 `OS` CR 示例: + +```yaml +apiVersion: upgrade.openeuler.org/v1alpha1 +kind: OS +metadata: + name: kubeos-upgrade +spec: + osversion: "KubeOS v2" + opstype: "upgrade" + ... +``` + +### 配置操作 + +KubeOS 支持通过配置 CRD 来修改系统设置。例如,更新 sysctl 参数或 GRUB 配置。定义 `OS` 对象并设置 `opstype` 为 `config`: + +```yaml +apiVersion: upgrade.openeuler.org/v1alpha1 +kind: OS +metadata: + name: kubeos-config +spec: + osversion: "KubeOS v2" + opstype: "config" + ... +``` + +### 回滚操作 + +如果升级失败,KubeOS 提供回滚支持,将节点恢复到之前的版本。将 `opstype` 设置为 `rollback` 并指定目标版本: + +```yaml +apiVersion: upgrade.openeuler.org/v1alpha1 +kind: OS +metadata: + name: kubeos-rollback +spec: + osversion: "KubeOS v1" + opstype: "rollback" + ... +``` + +### Admin 运维容器 + +KubeOS 支持通过 admin 容器进行运维操作,如配置 SSH 公钥、系统服务等。部署 admin 容器的示例配置如下: + +```yaml +apiVersion: v1 +kind: Pod +metadata: + name: admin-container +spec: + containers: + - name: admin + image: kubeos-admin:latest + ... +``` + +### dm-verity 支持 + +KubeOS 支持 dm-verity 镜像,提供静态完整性保护。在制作镜像时,可以通过指定 `dm-verity` 选项启用。 + +## 开发者指南 + +- **CLI**: 提供与 os-agent 通信的客户端方法 +- **manager**: 核心逻辑处理组件,与 Kubernetes 控制平面交互 +- **proxy**: Kubernetes 控制器,监听 CRD 并触发升级、配置和回滚操作 +- **kbimg**: 镜像制作工具,支持多种镜像类型(repo、docker、vm、pxe) + +## 贡献代码 + +欢迎贡献代码!请参考 [CONTRIBUTING.md](CONTRIBUTING.md) 获取更多信息。 + +## 开源协议 + +本项目遵循 Mulan PSL v2 协议,详情请见 [License](http://license.coscl.org.cn/MulanPSL2)。 \ No newline at end of file -- Gitee