From 65a11fd929d9e743c0320664c9599111c6425392 Mon Sep 17 00:00:00 2001 From: jiaoliao Date: Tue, 3 Feb 2026 10:34:01 +0000 Subject: [PATCH 1/3] add release note 120 --- .../version-1.2.x/Release Notes/v1.2.0.md | 54 ++++++++++++++++++- .../version-1.2.x/Release Notes/v1.2.0.md | 52 ++++++++++++++++++ 2 files changed, 105 insertions(+), 1 deletion(-) diff --git a/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/version-1.2.x/Release Notes/v1.2.0.md b/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/version-1.2.x/Release Notes/v1.2.0.md index 15b9fc92b..8d0cc7710 100644 --- a/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/version-1.2.x/Release Notes/v1.2.0.md +++ b/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/version-1.2.x/Release Notes/v1.2.0.md @@ -51,4 +51,56 @@ - 演示 `rock model-service start --type proxy --proxy-base-url` 用法 -## Admin \ No newline at end of file +## Admin + +### 新功能 + +#### 任务调度器（Task Scheduler） +一个灵活的任务调度系统，用于管理 Ray Worker 节点上的周期性维护任务。 + +**内置任务：** +- **ImageCleanupTask**：使用 [docuum](https://github.com/stepchowfun/docuum) 进行 Docker 镜像清理，支持可配置的磁盘阈值 + +**配置示例：** +```yaml +scheduler: + enabled: true + worker_cache_ttl: 3600 + tasks: + - task_class: "rock.admin.scheduler.tasks.image_cleanup_task.ImageCleanupTask" + enabled: true + interval_seconds: 3600 + params: + threshold: "1T" +``` + +**可扩展性：** +通过继承 `BaseTask` 并实现 `run_action(runtime: RemoteSandboxRuntime)` 方法来创建自定义任务。 + +#### Entrypoints + +- **新增**: 批量查询沙箱状态 API (`POST /sandboxes/batch`) + - 在单个请求中高效检索多个沙箱的状态信息 + - 接受包含 `sandbox_ids` 列表的 `BatchSandboxStatusRequest` 请求 + - 返回包含所有请求沙箱状态详情的 `BatchSandboxStatusResponse` 响应 + - 支持可配置的最大数量限制（默认值来自 `batch_get_status_max_count` 配置） + +- **新增**: 沙箱列表和过滤 API (`GET /sandboxes`) + - 使用灵活的查询参数查询和过滤沙箱 + - 通过 `page` 和 `page_size` 参数支持分页 + - 返回包含条目列表、总数和 `has_more` 标识的 `SandboxListResponse` 响应 + - 支持按沙箱属性过滤（例如：部署类型、状态、自定义元数据等） + - 最大页面大小可通过 `batch_get_status_max_count` 配置 + +#### Sandbox + +- 修改 Sandbox 日志格式：时间戳使用 ISO 8601 格式，默认时区为 Asia/Shanghai（亚洲/上海） +- 丰富 SandboxInfo：添加 create_time、start_time、stop_time +- 添加计费日志：当 sandbox 关闭时记录计费日志 + +--- + +### 增强 + +#### 性能优化 +- 实现 get_status 接口逻辑与 Ray 的解耦：将 API 响应耗时从 1s 以上显著降低至 100ms 级别；支持新旧逻辑的动态在线切换。 diff --git a/docs/versioned_docs/version-1.2.x/Release Notes/v1.2.0.md b/docs/versioned_docs/version-1.2.x/Release Notes/v1.2.0.md index 8c09e2b0c..a403d35bf 100644 --- a/docs/versioned_docs/version-1.2.x/Release Notes/v1.2.0.md +++ b/docs/versioned_docs/version-1.2.x/Release Notes/v1.2.0.md @@ -52,3 +52,55 @@ Practical examples demonstrating ROCK Agent integration with various AI framewor ## Admin + +### New Features + +#### Task Scheduler +A flexible task scheduling system for managing periodic maintenance tasks across Ray workers. + +**Built-in Tasks:** +- **ImageCleanupTask**: Docker image cleanup using [docuum](https://github.com/stepchowfun/docuum) with configurable disk threshold + +**Configuration Example:** +```yaml +scheduler: + enabled: true + worker_cache_ttl: 3600 + tasks: + - task_class: "rock.admin.scheduler.tasks.image_cleanup_task.ImageCleanupTask" + enabled: true + interval_seconds: 3600 + params: + threshold: "1T" +``` + +**Extensibility:** +Create custom tasks by extending `BaseTask` and implementing the `run_action(runtime: RemoteSandboxRuntime)` method. + +#### Entrypoints + +- **NEW**: Batch sandbox status query API (`POST /sandboxes/batch`) + - Efficiently retrieve status information for multiple sandboxes in a single request + - Accepts `BatchSandboxStatusRequest` with `sandbox_ids` list + - Returns `BatchSandboxStatusResponse` containing status details for all requested sandboxes + - Supports up to configurable maximum count (default from `batch_get_status_max_count`) + +- **NEW**: Sandbox listing and filtering API (`GET /sandboxes`) + - Query and filter sandboxes with flexible query parameters + - Supports pagination via `page` and `page_size` parameters + - Returns `SandboxListResponse` with items, total count, and `has_more` indicator + - Enables filtering by sandbox attributes (e.g., deployment type, status, custom metadata) + - Maximum page size configurable via `batch_get_status_max_count` + +#### Sandbox + +- Modify Sandbox log format: use iso 8601 format for timestamp, default time zone is Asia/Shanghai +- Enrich SandboxInfo: add create_time, start_time, stop_time for metrics +- Add Billing log when sandbox is closed + +--- + +### Enhancements + +#### Performance Optimizations +- Decouple the `get_status` API logic from Ray, reducing API latency from 1s+ to 100ms+; support dynamically toggling between the new and legacy logic. From 91575824ac176639d532db8e40dd635ed0a8bb67 Mon Sep 17 00:00:00 2001 From: jiaoliao Date: Tue, 3 Feb 2026 10:55:42 +0000 Subject: [PATCH 2/3] Revert "add release note 120" This reverts commit 65a11fd929d9e743c0320664c9599111c6425392. --- .../version-1.2.x/Release Notes/v1.2.0.md | 54 +------------------ .../version-1.2.x/Release Notes/v1.2.0.md | 52 ------------------ 2 files changed, 1 insertion(+), 105 deletions(-) diff --git a/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/version-1.2.x/Release Notes/v1.2.0.md b/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/version-1.2.x/Release Notes/v1.2.0.md index 8d0cc7710..15b9fc92b 100644 --- a/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/version-1.2.x/Release Notes/v1.2.0.md +++ b/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/version-1.2.x/Release Notes/v1.2.0.md @@ -51,56 +51,4 @@ - 演示 `rock model-service start --type proxy --proxy-base-url` 用法 -## Admin - -### 新功能 - -#### 任务调度器（Task Scheduler） -一个灵活的任务调度系统，用于管理 Ray Worker 节点上的周期性维护任务。 - -**内置任务：** -- **ImageCleanupTask**：使用 [docuum](https://github.com/stepchowfun/docuum) 进行 Docker 镜像清理，支持可配置的磁盘阈值 - -**配置示例：** -```yaml -scheduler: - enabled: true - worker_cache_ttl: 3600 - tasks: - - task_class: "rock.admin.scheduler.tasks.image_cleanup_task.ImageCleanupTask" - enabled: true - interval_seconds: 3600 - params: - threshold: "1T" -``` - -**可扩展性：** -通过继承 `BaseTask` 并实现 `run_action(runtime: RemoteSandboxRuntime)` 方法来创建自定义任务。 - -#### Entrypoints - -- **新增**: 批量查询沙箱状态 API (`POST /sandboxes/batch`) - - 在单个请求中高效检索多个沙箱的状态信息 - - 接受包含 `sandbox_ids` 列表的 `BatchSandboxStatusRequest` 请求 - - 返回包含所有请求沙箱状态详情的 `BatchSandboxStatusResponse` 响应 - - 支持可配置的最大数量限制（默认值来自 `batch_get_status_max_count` 配置） - -- **新增**: 沙箱列表和过滤 API (`GET /sandboxes`) - - 使用灵活的查询参数查询和过滤沙箱 - - 通过 `page` 和 `page_size` 参数支持分页 - - 返回包含条目列表、总数和 `has_more` 标识的 `SandboxListResponse` 响应 - - 支持按沙箱属性过滤（例如：部署类型、状态、自定义元数据等） - - 最大页面大小可通过 `batch_get_status_max_count` 配置 - -#### Sandbox - -- 修改 Sandbox 日志格式：时间戳使用 ISO 8601 格式，默认时区为 Asia/Shanghai（亚洲/上海） -- 丰富 SandboxInfo：添加 create_time、start_time、stop_time -- 添加计费日志：当 sandbox 关闭时记录计费日志 - ---- - -### 增强 - -#### 性能优化 -- 实现 get_status 接口逻辑与 Ray 的解耦：将 API 响应耗时从 1s 以上显著降低至 100ms 级别；支持新旧逻辑的动态在线切换。 +## Admin \ No newline at end of file diff --git a/docs/versioned_docs/version-1.2.x/Release Notes/v1.2.0.md b/docs/versioned_docs/version-1.2.x/Release Notes/v1.2.0.md index a403d35bf..8c09e2b0c 100644 --- a/docs/versioned_docs/version-1.2.x/Release Notes/v1.2.0.md +++ b/docs/versioned_docs/version-1.2.x/Release Notes/v1.2.0.md @@ -52,55 +52,3 @@ Practical examples demonstrating ROCK Agent integration with various AI framewor ## Admin - -### New Features - -#### Task Scheduler -A flexible task scheduling system for managing periodic maintenance tasks across Ray workers. - -**Built-in Tasks:** -- **ImageCleanupTask**: Docker image cleanup using [docuum](https://github.com/stepchowfun/docuum) with configurable disk threshold - -**Configuration Example:** -```yaml -scheduler: - enabled: true - worker_cache_ttl: 3600 - tasks: - - task_class: "rock.admin.scheduler.tasks.image_cleanup_task.ImageCleanupTask" - enabled: true - interval_seconds: 3600 - params: - threshold: "1T" -``` - -**Extensibility:** -Create custom tasks by extending `BaseTask` and implementing the `run_action(runtime: RemoteSandboxRuntime)` method. - -#### Entrypoints - -- **NEW**: Batch sandbox status query API (`POST /sandboxes/batch`) - - Efficiently retrieve status information for multiple sandboxes in a single request - - Accepts `BatchSandboxStatusRequest` with `sandbox_ids` list - - Returns `BatchSandboxStatusResponse` containing status details for all requested sandboxes - - Supports up to configurable maximum count (default from `batch_get_status_max_count`) - -- **NEW**: Sandbox listing and filtering API (`GET /sandboxes`) - - Query and filter sandboxes with flexible query parameters - - Supports pagination via `page` and `page_size` parameters - - Returns `SandboxListResponse` with items, total count, and `has_more` indicator - - Enables filtering by sandbox attributes (e.g., deployment type, status, custom metadata) - - Maximum page size configurable via `batch_get_status_max_count` - -#### Sandbox - -- Modify Sandbox log format: use iso 8601 format for timestamp, default time zone is Asia/Shanghai -- Enrich SandboxInfo: add create_time, start_time, stop_time for metrics -- Add Billing log when sandbox is closed - ---- - -### Enhancements - -#### Performance Optimizations -- Decouple the `get_status` API logic from Ray, reducing API latency from 1s+ to 100ms+; support dynamically toggling between the new and legacy logic. From ec6a6a906913bf0399b2023c0213f6e206d56c95 Mon Sep 17 00:00:00 2001 From: jiaoliao Date: Tue, 10 Mar 2026 11:57:15 +0000 Subject: [PATCH 3/3] add release note --- .../version-1.3.x/Release Notes/index.md | 3 +- .../version-1.3.x/Release Notes/v1.3.1.md | 40 +++++++++++++++++++ .../version-1.3.x/Release Notes/index.md | 1 + .../version-1.3.x/Release Notes/v1.3.1.md | 40 +++++++++++++++++++ 4 files changed, 83 insertions(+), 1 deletion(-) create mode 100644 docs/i18n/zh-Hans/docusaurus-plugin-content-docs/version-1.3.x/Release Notes/v1.3.1.md create mode 100644 docs/versioned_docs/version-1.3.x/Release Notes/v1.3.1.md diff --git a/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/version-1.3.x/Release Notes/index.md b/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/version-1.3.x/Release Notes/index.md index 56dfec168..cb424ec44 100644 --- a/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/version-1.3.x/Release Notes/index.md +++ b/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/version-1.3.x/Release Notes/index.md @@ -2,4 +2,5 @@ sidebar_position: 1 --- # 版本说明 -* [release v1.3.0](v1.3.0.md) \ No newline at end of file +* [release v1.3.0](v1.3.0.md) +* [release v1.3.1](v1.3.1.md) diff --git a/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/version-1.3.x/Release Notes/v1.3.1.md b/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/version-1.3.x/Release Notes/v1.3.1.md new file mode 100644 index 000000000..d4ebffcf9 --- /dev/null +++ b/docs/i18n/zh-Hans/docusaurus-plugin-content-docs/version-1.3.x/Release Notes/v1.3.1.md @@ -0,0 +1,40 @@ +# v1.3.1 + +## 发布日期 +2026 年 3 月 10 日 + +--- + +## SDK + +### 新功能 + +#### Sandbox 客户端 +- **新增**: 支持通过 SDK 创建沙箱时指定 `sandbox_id` ([#607](https://github.com/alibaba/ROCK/pull/607)) +- **新增**: SDK 沙箱客户端中新增 `cpu_preemption` 配置选项，用于控制 CPU 抢占策略 ([#597](https://github.com/alibaba/ROCK/pull/597)) + +--- + +## Admin + +### 新功能 + +#### Sandbox +- **新增**: 沙箱 CPU 抢占支持，允许配置 CPU 资源抢占策略 ([#597](https://github.com/alibaba/ROCK/pull/597)) +- **新增**: 标准规格沙箱创建，通过 `use_standard_spec_only` 配置强制使用标准化资源规格 ([#603](https://github.com/alibaba/ROCK/pull/603)) + +#### 调度器 +- **新增**: 容器清理定时任务，自动移除超过可配置时间阈值的已停止 Docker 容器 ([#604](https://github.com/alibaba/ROCK/pull/604)) +- **新增**: 文件清理定时任务，支持配置目标目录、文件过期时间、文件大小阈值以及目录/文件排除规则 ([#584](https://github.com/alibaba/ROCK/pull/584)) + +--- + +### 增强改进 + +#### 可观测性 +- 沙箱生命周期响应时间（RT）指标，用于监控沙箱生命周期耗时 ([#605](https://github.com/alibaba/ROCK/pull/605)) + +#### 配置 +- 新增 `remove_container_enabled` 配置项，用于控制沙箱销毁后是否移除容器 ([#604](https://github.com/alibaba/ROCK/pull/604)) + +--- diff --git a/docs/versioned_docs/version-1.3.x/Release Notes/index.md b/docs/versioned_docs/version-1.3.x/Release Notes/index.md index 588b3aaaa..a4752f40c 100644 --- a/docs/versioned_docs/version-1.3.x/Release Notes/index.md +++ b/docs/versioned_docs/version-1.3.x/Release Notes/index.md @@ -3,3 +3,4 @@ sidebar_position: 1 --- # Release Notes * [release v1.3.0](v1.3.0.md) +* [release v1.3.1](v1.3.1.md) diff --git a/docs/versioned_docs/version-1.3.x/Release Notes/v1.3.1.md b/docs/versioned_docs/version-1.3.x/Release Notes/v1.3.1.md new file mode 100644 index 000000000..04e3d39ee --- /dev/null +++ b/docs/versioned_docs/version-1.3.x/Release Notes/v1.3.1.md @@ -0,0 +1,40 @@ +# v1.3.1 + +## Release Date +Mar 10, 2026 + +--- + +## SDK + +### New Features + +#### Sandbox Client +- **NEW**: Support specifying `sandbox_id` when creating sandboxes via SDK ([#607](https://github.com/alibaba/ROCK/pull/607)) +- **NEW**: `cpu_preemption` configuration option in SDK sandbox client for CPU preemption control ([#597](https://github.com/alibaba/ROCK/pull/597)) + +--- + +## Admin + +### New Features + +#### Sandbox +- **NEW**: CPU preemption support for sandboxes, allowing configurable CPU resource preemption policies ([#597](https://github.com/alibaba/ROCK/pull/597)) +- **NEW**: Standard spec sandbox creation with `use_standard_spec_only` configuration to enforce standardized resource specifications ([#603](https://github.com/alibaba/ROCK/pull/603)) + +#### Scheduler +- **NEW**: Container cleanup scheduled task to automatically remove stopped Docker containers older than a configurable age threshold ([#604](https://github.com/alibaba/ROCK/pull/604)) +- **NEW**: File cleanup scheduled task with configurable target directories, file age limits, file size thresholds, and directory/file exclusion rules ([#584](https://github.com/alibaba/ROCK/pull/584)) + +--- + +### Enhancements + +#### Observability +- Sandbox lifespan response time (RT) metrics for monitoring sandbox lifecycle duration ([#605](https://github.com/alibaba/ROCK/pull/605)) + +#### Configuration +- Add `remove_container_enabled` configuration option to control whether containers are removed after sandbox destruction ([#604](https://github.com/alibaba/ROCK/pull/604)) + +---