已合并
[doc]:devcontainer机制打样仓合入，增加ubuntu镜像说明 #123
孟广欣创建于 24 天前
[doc]:devcontainer机制打样仓合入，增加ubuntu镜像说明 #123
已合并
共 1 个文件变更+12-10
| @@ -26,25 +26,27 @@ MindStudio 工具支持两种开发环境安装方式，请根据仓库实际情 | |||
| 26 | | **Docker Engine** | 已安装且服务正在运行 | 执行 `docker ps`，无报错即表示服务正常启动 | | 26 | | **Docker Engine** | 已安装且服务正在运行 | 执行 `docker ps`，无报错即表示服务正常启动 | |
| 27 | | **Python 3** | 宿主机已安装（任意 3.x 版本） | 执行 `python3 -V`，有版本信息输出即表示已安装 | | 27 | | **Python 3** | 宿主机已安装（任意 3.x 版本） | 执行 `python3 -V`，有版本信息输出即表示已安装 | |
| 28 | 28 | ||
| 29 | ---- | 29 | +> 若 `docker ps` 出现 permission denied 类错误，请参考 [FAQ 7.1](#71-执行-docker-命令遇到-permission-denied-类错误提示)。 |
| 30 | - | ||
| 31 | -若 `docker ps` 出现 permission denied 类错误，请先参考 [7.1 节](#71-执行-docker-命令遇到-permission-denied-类错误提示) 处理 Docker 权限。 | ||
| 32 | 30 | ||
| 33 | ## 3. 宿主机：拉取编译专用镜像 | 31 | ## 3. 宿主机：拉取编译专用镜像 |
| 34 | 32 | ||
| 35 | -从华为云 SWR 镜像仓库拉取定制好的 MindStudio 编译专用镜像： | 33 | +从华为云镜像仓库拉取 MindStudio 编译专用镜像，推荐使用如下基于 openEuler 基础系统的镜像（与 CI 构建系统保持一致）： |
| 36 | 34 | ||
| 37 | ```bash | 35 | ```bash |
| 38 | docker pull swr.cn-north-4.myhuaweicloud.com/mindstudio-image/mindstudio-build:26.2.0-0801 | 36 | docker pull swr.cn-north-4.myhuaweicloud.com/mindstudio-image/mindstudio-build:26.2.0-0801 |
| 39 | ``` | 37 | ``` |
| 40 | 38 | ||
| 39 | +若对 Ubuntu 系统有特殊需求，也可拉取如下基于 Ubuntu 的镜像（仅用于个人开发调试）： | ||
| 40 | + | ||
| 41 | +```bash | ||
| 42 | +docker pull swr.cn-north-4.myhuaweicloud.com/mindstudio-image/mindstudio-build:26.2.0-0801-ubuntu22.04 | ||
| 43 | +``` | ||
| 44 | + | ||
| 41 | > [!NOTE]说明 | 45 | > [!NOTE]说明 |
| 42 | > | 46 | > |
| 43 | -> **如何自行构建该镜像？** | 47 | +> 如需自行构建镜像（定制内容、排查分层等），请参考《[MindStudio 统一构建镜像制作指南](./docker_image_build_guide.md)》。 |
| 44 | -> | ||
| 45 | -> 普通开发者通常无需关注此步骤。仅当需要定制镜像内容、排查镜像分层或复现构建过程时，请参考《[MindStudio 统一构建镜像制作指南](./docker_image_build_guide.md)》。 | ||
| 46 | 48 | ||
| 47 | -若镜像拉取失败，请参考 [FAQ 2](#72-拉取镜像失败如何处理)。 | 49 | +若拉取失败，请参考 [FAQ 7.2](#72-拉取镜像失败如何处理)。 |
| 48 | 50 | ||
| 49 | ## 4. 宿主机：下载容器启动脚本 | 51 | ## 4. 宿主机：下载容器启动脚本 |
| 50 | 52 | ||
| @@ -60,7 +62,7 @@ cd ~ && curl -fLO --retry 3 https://inst.obs.cn-north-4.myhuaweicloud.com/env/ct | |||
| 60 | 62 | ||
| 61 | ## 5. 宿主机：启动并进入编译容器 | 63 | ## 5. 宿主机：启动并进入编译容器 |
| 62 | 64 | ||
| 63 | -以**普通用户**身份执行脚本，并指定已拉取的编译镜像名称。脚本将自动完成目录挂载、用户映射及环境变量初始化： | 65 | +请以**普通用户**身份执行（root 执行不会自动挂载目录，降低开发效率），脚本将自动完成目录挂载、用户映射及环境初始化，命令示例如下： |
| 64 | 66 | ||
| 65 | ```bash | 67 | ```bash |
| 66 | ~/ctr_in.py swr.cn-north-4.myhuaweicloud.com/mindstudio-image/mindstudio-build:26.2.0-0801 | 68 | ~/ctr_in.py swr.cn-north-4.myhuaweicloud.com/mindstudio-image/mindstudio-build:26.2.0-0801 |
| @@ -146,7 +148,7 @@ sudo usermod -aG docker <当前用户名> | |||
| 146 | 148 | ||
| 147 | ### 7.3 下载 `ctr_in.py` 失败如何处理？ | 149 | ### 7.3 下载 `ctr_in.py` 失败如何处理？ |
| 148 | 150 | ||
| 149 | -优先使用 [第 4 章](#4-宿主机下载容器启动脚本) 中的手动下载方式，将脚本拷贝至宿主机 `~/` 目录后执行： | 151 | +若 `curl` 下载失败，可手动将 `ctr_in.py` 脚本拷贝至宿主机 `~/` 目录，然后赋予执行权限： |
| 150 | 152 | ||
| 151 | ```bash | 153 | ```bash |
| 152 | cd ~ | 154 | cd ~ |