From b0e4d4a73ba7d9ed52a6ea5906013f4980eb8306 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=A1=BE=E9=87=91=E7=87=95?= Date: Tue, 4 Apr 2023 06:25:05 +0000 Subject: [PATCH] =?UTF-8?q?=E8=A7=84=E8=8C=83=E5=92=8C=E4=BD=8E=E9=94=99?= =?UTF-8?q?=E7=B1=BB:=20=E9=94=99=E5=88=AB=E5=AD=97=E6=88=96=E6=8B=BC?= =?UTF-8?q?=E5=86=99=E9=94=99=E8=AF=AF=EF=BC=9B=E6=A0=87=E7=82=B9=E7=AC=A6?= =?UTF-8?q?=E5=8F=B7=E4=BD=BF=E7=94=A8=E9=94=99=E8=AF=AF=EF=BC=9B?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: 顾金燕 --- ...04\345\273\272\345\267\245\345\205\267.md" | 66 +++++++++---------- 1 file changed, 33 insertions(+), 33 deletions(-) diff --git "a/docs/zh/docs/Container/isula-build\346\236\204\345\273\272\345\267\245\345\205\267.md" "b/docs/zh/docs/Container/isula-build\346\236\204\345\273\272\345\267\245\345\205\267.md" index bff4358b7..5a91b9504 100644 --- "a/docs/zh/docs/Container/isula-build\346\236\204\345\273\272\345\267\245\345\205\267.md" +++ "b/docs/zh/docs/Container/isula-build\346\236\204\345\273\272\345\267\245\345\205\267.md" @@ -12,25 +12,25 @@ * [使用指南](#使用指南) * [前提条件](#前提条件) * [总体说明](#总体说明) - * [ctr-img: 容器镜像管理](#ctr-img-容器镜像管理) - * [build: 容器镜像构建](#build-容器镜像构建) - * [image: 查看本地持久化构建镜像](#image-查看本地持久化构建镜像) - * [import: 导入容器基础镜像](#import-导入容器基础镜像) - * [load: 导入层叠镜像](#load-导入层叠镜像) - * [rm: 删除本地持久化镜像](#rm-删除本地持久化镜像) - * [save: 导出层叠镜像](#save-导出层叠镜像) - * [tag: 给本地持久化镜像打标签](#tag-给本地持久化镜像打标签) - * [pull: 拉取镜像到本地](#pull-拉取镜像到本地) - * [push: 将本地镜像推送到远程仓库](#push-将本地镜像推送到远程仓库) - * [info: 查看运行环境与系统信息](#info-查看运行环境与系统信息) - * [login: 登录远端镜像仓库](#login-登录远端镜像仓库) - * [logout: 退出远端镜像仓库](#logout-退出远端镜像仓库) - * [version: 版本查询](#version-版本查询) - * [manifest: manifest列表管理（实验特性）](#manifest-manifest列表管理) - * [create: manifest列表创建](#create-manifest列表创建) - * [annotate: manifest列表更新](#annotate-manifest列表更新) - * [inspect: manifest列表查询](#inspect-manifest列表查询) - * [push: 将manifest列表推送到远程仓库](#push-将manifest列表推送到远程仓库) + * [ctr-img：容器镜像管理](#ctr-img-容器镜像管理) + * [build：容器镜像构建](#build-容器镜像构建) + * [image：查看本地持久化构建镜像](#image-查看本地持久化构建镜像) + * [import：导入容器基础镜像](#import-导入容器基础镜像) + * [load：导入层叠镜像](#load-导入层叠镜像) + * [rm：删除本地持久化镜像](#rm-删除本地持久化镜像) + * [save：导出层叠镜像](#save-导出层叠镜像) + * [tag：给本地持久化镜像打标签](#tag-给本地持久化镜像打标签) + * [pull：拉取镜像到本地](#pull-拉取镜像到本地) + * [push：将本地镜像推送到远程仓库](#push-将本地镜像推送到远程仓库) + * [info：查看运行环境与系统信息](#info-查看运行环境与系统信息) + * [login：登录远端镜像仓库](#login-登录远端镜像仓库) + * [logout：退出远端镜像仓库](#logout-退出远端镜像仓库) + * [version：版本查询](#version-版本查询) + * [manifest：manifest列表管理（实验特性）](#manifest-manifest列表管理) + * [create：manifest列表创建](#create-manifest列表创建) + * [annotate：manifest列表更新](#annotate-manifest列表更新) + * [inspect：manifest列表查询](#inspect-manifest列表查询) + * [push：将manifest列表推送到远程仓库](#push-将manifest列表推送到远程仓库) * [直接集成容器引擎](#直接集成容器引擎) * [与iSulad集成](#与isulad集成) * [与Docker集成](#与docker集成) @@ -52,7 +52,7 @@ isula-build采用服务端/客户端模式，其中，isula-build为客户端， > ![](./public_sys-resources/icon-note.gif) **说明：** > -> - isula-build当前支持OCI镜像格式（[OCI Image Format Specification](https://github.com/opencontainers/image-spec/blob/main/spec.md/)）以及Docker镜像格式（[Image Manifest Version 2, Schema 2](https://docs.docker.com/registry/spec/manifest-v2-2/)）。通过命令`export ISULABUILD_CLI_EXPERIMENTAL=enabled开启实验特性以支持OCI镜像格式。不开启实验特性时，isula-build默认采用Docker镜像格式；当开启实验特性后，将默认采用OCI镜像格式。 +> - isula-build当前支持OCI镜像格式（[OCI Image Format Specification](https://github.com/opencontainers/image-spec/blob/main/spec.md/)）以及Docker镜像格式（[Image Manifest Version 2, Schema 2](https://docs.docker.com/registry/spec/manifest-v2-2/)）。通过命令`export ISULABUILD_CLI_EXPERIMENTAL=enabled`开启实验特性以支持OCI镜像格式。不开启实验特性时，isula-build默认采用Docker镜像格式；当开启实验特性后，将默认采用OCI镜像格式。 ## 安装 @@ -92,7 +92,7 @@ isula-build采用服务端/客户端模式，其中，isula-build为客户端， > ![](./public_sys-resources/icon-note.gif) **说明：** > -> - 安装完成后，需要手工启动isula-build服务。启动请参见"管理服务"。 +> - 安装完成后，需要手工启动isula-build服务。启动请参见“管理服务”。 ## 配置与管理服务 @@ -115,7 +115,7 @@ isula-build采用服务端/客户端模式，其中，isula-build为客户端， | experimental | 可选 | 设置是否开启实验特性 | true：开启实验特性；false：关闭实验特性 | -- /etc/isula-build/storage.toml: 本地持久化存储的配置文件，包含所使用的存储驱动的配置。 +- /etc/isula-build/storage.toml：本地持久化存储的配置文件，包含所使用的存储驱动的配置。 | 配置项 | 是否可选 | 配置项含义 | | ------ | -------- | ------------------------------ | @@ -124,7 +124,7 @@ isula-build采用服务端/客户端模式，其中，isula-build为客户端， 更多设置可参考 [containers-storage.conf.5.md](https://github.com/containers/storage/blob/main/docs/containers-storage.conf.5.md)。 -- /etc/isula-build/registries.toml : 针对各个镜像仓库的配置文件。 +- /etc/isula-build/registries.toml：针对各个镜像仓库的配置文件。 | 配置项 | 是否可选 | 配置项含义 | | ------------------- | -------- | ------------------------------------------------------------ | @@ -172,7 +172,7 @@ isula-build采用服务端/客户端模式，其中，isula-build为客户端， sudo systemctl restart isula-build.service ``` -isula-build 软件包安装的 systemd 服务文件保存在 `/usr/lib/systemd/system/isula-build.service`。如果用户需要修改 isula-build 服务的 systemd 配置，可以修改该文件，执行如下命令使配置生效，之后再根据上面提到的 systemd 管理指令重启 isula-build 服务 +isula-build 软件包安装的 systemd 服务文件保存在 `/usr/lib/systemd/system/isula-build.service`。如果用户需要修改 isula-build 服务的 systemd 配置，可以修改该文件，执行如下命令使配置生效，之后再根据上面提到的 systemd 管理指令重启 isula-build 服务。 ```sh sudo systemctl daemon-reload @@ -182,14 +182,14 @@ sudo systemctl daemon-reload 您也可以通过执行 isula-build 服务端命令（ isula-builder）的方式启动服务。其中，服务端启动配置，可通过isula-builder命令支持的 flags 设置。isula-build 服务端目前支持的 flags 如下： -- -D, --debug: 是否开启调测模式。 -- --log-level: 日志级别，支持 “debug”, “info”, “warn” or “error”，默认为 “info”。 -- --dataroot: 本地持久化路径，默认为”/var/lib/isula-build/“。 -- --runroot: 运行时路径，默认为”/var/run/isula-build/“。 +- -D, --debug：是否开启调测模式。 +- --log-level：日志级别，支持 “debug”, “info”, “warn” or “error”，默认为 “info”。 +- --dataroot：本地持久化路径，默认为“/var/lib/isula-build/”。 +- --runroot：运行时路径，默认为“/var/run/isula-build/”。 - --storage-driver：底层存储驱动类型。 -- --storage-opt: 底层存储驱动配置。 -- --group: 设置本地套接字isula_build.sock文件属组使得加入该组的非特权用户可以操作isula-build，默认为“isula”。 -- --experimental: 是否开启实验特性，默认为false。 +- --storage-opt：底层存储驱动配置。 +- --group：设置本地套接字isula_build.sock文件属组使得加入该组的非特权用户可以操作isula-build，默认为“isula”。 +- --experimental：是否开启实验特性，默认为false。 >![](./public_sys-resources/icon-note.gif) **说明：** > @@ -1037,13 +1037,13 @@ busybox 2.0 2d414a5c | **命令** | **参数** | **说明** | | -------- | -------------------- | ------------------------------------------------------- | | login | -p, --password-stdin | 布尔值，是否通过stdin读入密码；或采用交互式界面输入密码 | -| | -u, --username | string，登陆镜像仓库所使用的用户名 | +| | -u, --username | string，登录镜像仓库所使用的用户名 | **表7** logout 命令参数列表 | **命令** | **参数** | **说明** | | -------- | --------- | ------------------------------------ | -| logout | -a, --all | 布尔值，是否登出所有已登陆的镜像仓库 | +| logout | -a, --all | 布尔值，是否登出所有已登录的镜像仓库 | **表8** manifest annotate命令参数列表 -- Gitee