From 547aeb9f561b444d740b5c3c5a2f0c3be2e3c188 Mon Sep 17 00:00:00 2001 From: Power-One-2025 Date: Tue, 16 Jun 2026 21:19:55 +0800 Subject: [PATCH 1/3] add Resources section for accelerator selection --- docs/manual/olares/market/market.md | 50 +++++++++++++++++++------- docs/zh/manual/olares/market/market.md | 49 +++++++++++++++++++------ 2 files changed, 76 insertions(+), 23 deletions(-) diff --git a/docs/manual/olares/market/market.md b/docs/manual/olares/market/market.md index 34761f6aa4..46bd1f72d3 100644 --- a/docs/manual/olares/market/market.md +++ b/docs/manual/olares/market/market.md @@ -25,7 +25,6 @@ The Olares Market offers various ways to discover and browse applications. ![Market](/images/manual/olares/market-discover1.png#bordered) - ### Browse by categories Upon launching the Market app, the **Discover** page serves as your central hub for exploration, organizing content into intuitive sections to guide your journey: @@ -37,10 +36,10 @@ Upon launching the Market app, the **Discover** page serves as your central hub You can also browse applications based on their functionality: * **Creativity**: Apps for creating and publishing digital content, from AI-generated art and 3D models to blogs and design projects. * **Productivity**: Apps for team collaboration, project management, data organization, and building custom AI-powered agents. -* **Developer Tools**: Toolchain for the software development lifecycle, including code hosting, CI/CD, observability, and database management. -* **Fun**: Self-hosted applications for entertainment and fun such as gaming, video streaming, and connecting with people. +* **Fun**: Self-hosted applications for entertainment and fun such as gaming, video streaming, and connecting with people. * **Lifestyle**: Self-hosted applications for managing your smart home, personal photo libraries, and AI identity. -* **Utilities**: Tools for system management, file sharing, data backup, and running local AI models. +* **Utilities**: Tools for system management, file sharing, data backup, and running local AI models. +* **Developer Tools**: Toolchain for the software development lifecycle, including code hosting, CI/CD, observability, and database management. * **AI**: Latest open-source LLMs and generative tools for text, audio, and 3D assets. ### Search using keywords @@ -51,17 +50,17 @@ To search an app in the market: 2. In the **Manage** submenu on the left, click **Search**. 3. Enter the keywords. The relevant results will appear as you type. -![Search app](/images/manual/olares/search-app.png#bordered) + ![Search app](/images/manual/olares/search-app.png#bordered) ### Switch market source -You can switch market sources to speed up browsing, searching, and downloading, or to install apps exclusive to a particular source. To switch market sources: +You can switch market sources to speed up browsing, searching, and downloading, or to install apps exclusive to a particular source. -1. Open **Market**, and navigate to **My Olares** > **Settings** from the left sidebar. +1. Open **Market**, and navigate to **My Olares** > **Settings**. 2. Under **Market sources**, click **Add source** to add a new app source. The current official sources include: * Global: `https://api.olares.com/market` * China: `https://api.olares.cn/market` -3. Fill in the source name, URL, and description as required, then click **Confirm** to finish adding. +3. Fill in the source name, URL, and description as required, then click **Confirm**. 4. In the source list, select the target source to activate it. Wait for about 10 minutes for the store page to switch. :::info @@ -72,11 +71,20 @@ Applications from different installation sources will generate corresponding tab To install an application from Market: -1. Open Market from Dock or Launchpad. -2. Navigate to the app you want, and click **Get**. -3. When the operation button changes to **Install**, click it to start the installation. -4. (Optional) To cancel the installation, click close_small on the right of the button. -5. Once finished, the button will change to **Open**. +1. Open Market from the Dock or Launchpad. +2. Find your target application, and double-click it to view its details. +3. (Optional) If the application supports multiple hardware accelerators, configure your deployment in the **RESOURCES** section: + + a. Select your preferred computing resource from the drop-down list. For example, **NVIDIA GPU**, **NVIDIA GB10**, or **CPU**. + + + + b. Review the updated **CPU**, **Memory**, **Required disk**, and **VRAM** requirements, and make sure your hardware meets these requirements. + +4. Click **Get**. +5. When the operation button changes to **Install**, click it to start the installation. +6. (Optional) To cancel the installation, click close_small on the right of the button. +7. When the installation finishes, the button changes to **Open**. ### Install shared applications @@ -188,6 +196,22 @@ You can also click the download button ## FAQs +### Errors in the RESOURCES section + +Before you install an application, the system evaluates your current hardware and cluster capacity. If your environment does not meet the selected configuration, an inline error message will appear directly inside the **RESOURCES** panel: + +- "Unable to install. The Olares cluster does not have any required accelerator specified." + + The application requires specific computing hardware that is not installed or detected on your device or cluster. When this happens, the resource drop-down will display **N/A**, and the unsupported hardware options will be greyed out and unselectable. + +- "Unable to install on this accelerator type. Not enough required {Resource} on Olares cluster." + + Your system possesses the correct hardware type (e.g., an NVIDIA GPU), but its currently available capacity (such as GPU memory) is insufficient to run the app. You must stop other running applications to free up the required resources for this specific accelerator. + +- "Unable to install. Not enough required {Resource} available on your quota." + + Your personal account's assigned resource limit (e.g., CPU or Memory) has been reached. Try freeing up your allocated resources by stopping your unused apps, or contact your administrator to request a quota increase. + ### Why can't I install an application? If you can't install an application, it might be due to: * **Insufficient system resources**: Try freeing up system resources, or increasing your resource quota. diff --git a/docs/zh/manual/olares/market/market.md b/docs/zh/manual/olares/market/market.md index a4149b1c5a..8b846e1231 100644 --- a/docs/zh/manual/olares/market/market.md +++ b/docs/zh/manual/olares/market/market.md @@ -35,23 +35,23 @@ Olares **应用市场**提供多种方式发现和浏览应用。 你还可以根据功能浏览应用： * **设计创作**：用于创建和发布数字内容的应用程序，包括 AI 生成的艺术、3D 模型、博客和设计项目。 * **工作效率**：用于团队协作、项目管理、数据组织和构建自定义 AI 代理的应用。 -* **开发工具**：软件开发生命周期的工具链，包括代码托管、CI/CD、可观察性和数据库管理。 * **休闲娱乐**：用于娱乐和休闲的自托管应用程序，如游戏、视频流媒体和社交。 * **生活方式**：用于管理智能家居、个人照片库和 AI 身份的自托管应用。 * **实用工具**：用于系统管理、文件共享、数据备份和运行本地 AI 模型的工具。 +* **开发工具**：软件开发生命周期的工具链，包括代码托管、CI/CD、可观察性和数据库管理。 * **AI**：最新的开源大语言模型（LLMs），以及涵盖文本、音频和 3D 资产生成的 AI 创作工具。 ### 使用关键词搜索 要在市场中搜索应用： -![搜索 app](/images/manual/olares/search-app.png#bordered) - 1. 在左侧的**管理**子菜单中，点击**搜索**。 2. 输入关键词。相关结果将随你在输入时显示。 + ![搜索应用](/images/manual/olares/search-app.png#bordered) + ### 切换应用源 -您可以选择不同的应用商店源，以加快浏览、搜索和下载应用的速度，或者安装某些源特有的应用。要切换应用源： +你可以选择不同的应用商店源，以加快浏览、搜索和下载应用的速度，或者安装某些源特有的应用。要切换应用源： 1. 打开**应用市场**，从左侧导航栏进入**我的 Olares** > **设置**。 2. 在**市场来源**下，点击**添加源**以添加新的应用源。当前 Olares 官方源包括： - 国际源：https://api.olares.com/market @@ -65,10 +65,22 @@ Olares **应用市场**提供多种方式发现和浏览应用。 ## 安装应用 -1. 打开**应用市场**，找到所需应用，点击**获取**。 -2. 当操作按钮变为**安装**时，点击以开始安装。 -3. 若要取消安装，点击按钮右侧的 close_small。 -4. 安装完成后，按钮将变为**打开**。 +要从应用市场安装应用： + +1. 从应用坞或启动台，打开**应用市场**。 +2. 找到目标应用，双击查看其详情。 +3. （可选）如果该应用支持多种硬件加速器，在**资源**区域配置部署信息： + + a. 从下拉列表中选择所需的计算资源。例如 **NVIDIA GPU**、**NVIDIA GB10** 或 **CPU**。 + + + + b. 查看动态更新后的 **CPU**、**Memory**、**Required disk** 和 **VRAM** 要求，确保你的硬件满足这些条件。 + +4. 点击**获取**。 +5. 当操作按钮变为**安装**时，点击开始安装。 +6. （可选）若要取消安装，点击按钮右侧的 close_small。 +7. 安装完成后，按钮将变为**打开**。 ### 安装共享应用 @@ -96,7 +108,7 @@ Olares **应用市场**提供多种方式发现和浏览应用。 ### 安装自定义应用 1. 准备 Olares 应用 Chart 文件（格式为 `.zip`、`.tgz`、`.tar` 或 `.gz`）。 -2. 打开应用市场，从左侧菜单进入**我的 Olares**。 +2. 打开**应用市场**，从左侧菜单进入**我的 Olares**。 3. 点击右上角**上传自定义 Chart**并选择 Chart 文件以安装。 你可以在**上传**页签查看并管理所有本地自定义应用。 @@ -112,6 +124,7 @@ Olares **应用市场**提供多种方式发现和浏览应用。 完成设置后可点击继续安装。 ## 更新应用 + 从应用市场下载的应用可按以下步骤获取更新： 1. 打开**应用市场**。 @@ -140,7 +153,7 @@ Olares **应用市场**提供多种方式发现和浏览应用。