--- title: "镜像和仓库命令组 - 安装部署工具 OBD V4.0.0 | OceanBase 文档中心" description: 镜像和仓库命令组 obd 有多级命令，您可以在每个层级中使用 -h/--help 选项查看子命令的帮助信息。同样的，当各层级的子命令执行报错时，您亦可使用 -v/--verbose 查看命令的详细执行过程。 obd mirror clone 使用此命令可将一个 RPM 包复制到本地镜像库，之后您可以使用 obd 集群… --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*Qq8pT6yBPTcAAAAAAAAAAAAADiGDAQ/original) 安装部署工具 OBDV 4.0.0 # 镜像和仓库命令组 更新时间：2025-11-18 17:53:47 [编辑](https://github.com/oceanbase/obd-doc/edit/V4.0.0/zh-CN/300.obd-command/200.command-group-for-mirroring-and-warehousing.md) obd 有多级命令，您可以在每个层级中使用 `-h/--help` 选项查看子命令的帮助信息。同样的，当各层级的子命令执行报错时，您亦可使用 `-v/--verbose` 查看命令的详细执行过程。 ## obd mirror clone 使用此命令可将一个 RPM 包复制到本地镜像库，之后您可以使用 obd 集群中相关的命令启动镜像。 ```shell obd mirror clone [-f] ``` 参数 `path` 为 RPM 包的路径。 选项 `-f` 为 `--force`。`-f` 为可选选项，默认不开启。开启时，若镜像已经存在，则强制覆盖已有镜像。 ## obd mirror list 使用该命令可显示镜像仓库或镜像列表。 ```shell obd mirror list [mirror repo name] ``` 参数 `mirror repo name` 为镜像仓库名。该参数为可选参数。为空时将显示镜像仓库列表，不为空时则显示对应仓库的镜像列表。 ## obd mirror update 使用该命令可同步全部远程镜像仓库的信息。 ```shell obd mirror update ``` ## obd mirror disable 使用该命令可禁用远程镜像仓库。如若需要禁用所有远程镜像仓库，可执行命令 `obd mirror disable remote`。 ```shell obd mirror disable ``` 参数 `mirror repo name` 为需禁用的镜像仓库名。如果指定为 `remote`，则会禁用所有远程镜像仓库。 ## obd mirror enable 使用该命令可启用远程镜像仓库。 ```shell obd mirror enable ``` 参数 `mirror repo name` 为需启动的镜像仓库名。如果指定为 `remote`，则会启用所有远程镜像仓库。 ## obd mirror add-repo 使用该命令可以为本地添加远程镜像仓库文件。 ```bash obd mirror add-repo ``` 参数 `url` 为要添加的镜像文件下载地址。 ## obd mirror create 使用该命令可以以本地目录为基础创建一个镜像。此命令主要用于使用 obd 启动自行编译的 OceanBase 开源软件，您可以通过此命令将编译产物加入本地仓库，之后就可以使用 `obd cluster` 相关的命令启动这个镜像。 ```shell obd mirror create -n -p -V [-t ] [-f] ``` 例如，如果您根据文档 [使用源码构建 OceanBase 数据库](https://www.oceanbase.com/docs/community-observer-cn-0000000000160092) 编译 OceanBase 数据库，在编译成功后，可以使用 `make DESTDIR=./ install && obd mirror create -n oceanbase-ce -V -p ./usr/local` 命令将编译产物添加至 obd 本地仓库。 选项说明见下表： | 选项名 | 是否必选 | 数据类型 | 说明 | | --- | --- | --- | --- | | -n/--name | 是 | string | 组件名。如果您编译的是 OceanBase 数据库，则填写 `oceanbase-ce`。如果您编译的是 ODP，则填写 `obproxy-ce`。 | | -p/--path | 是 | string | 执行编译命令时的目录。obd 会根据组件自动从该目录下获取所需的文件，默认为当前目录。 | | -V/--version | 是 | string | 版本号。 | | -t/--tag | 否 | string | 镜像标签。您可以为您的创建的镜像定义多个标签，以英文逗号 `,` 间隔。 | | -f/--force | 否 | bool | 当镜像已存在，或者标签已存在时强制覆盖。默认不开启。 | ## obd mirror clean 使用该命令可清理已下载到机器（`~/.obd/mirror`）和已通过 obd 安装（`~/.obd/repository`）的指定文件。 ```bash obd mirror clean [options] ``` #### 说明 - 未指定选项的情况下，obd 会清理所有当前未被使用的组件文件，并确保每个组件会保留一个最新版本的 RPM 包，是否为最新 RPM 包由版本号的大小排序判定。 - 除 `--hash` 选项外，每个选项配置后都将清理除最新版本和当前使用版本外所有符合选项条件的文件。 选项说明见下表： | 选项名 | 是否必选 | 数据类型 | 说明 | | --- | --- | --- | --- | | -c/--components | 否 | string | 指定组件名，将清理 `~/.obd/mirror` 和 `~/.obd/repository` 目录下该组件除最新版本和当前使用版本外的所有包，是否为最新 RPM 包由版本号的大小确定。配置为多个值时使用英文逗号（`,`）分隔。 | | -t/--type | 否 | string | 可选值为 `rpm` 和 `repository`，指定为 `rpm` 时仅清理 `~/.obd/mirror` 目录下的文件；指定为 `repository` 时仅清理 `~/.obd/repository` 目录下的文件。 | | --hash | 否 | string | 指定安装包的 hash 值，将清理 `~/.obd/mirror` 和 `~/.obd/repository` 目录下对应 hash 值的文件，配置为多个值时使用英文逗号（`,`）分隔。 #### 说明 可通过配置 `--hash` 选项指定删除组件的最新版本文件。 | | -y/--confirm | 否 | bool | 用于控制是否进行二次确认。 | ## obd repo list 使用该命令可展示 obd 本地存储列表。 ```shell obd repo list ``` 执行命令后会输出通过 obd 安装过哪些包，输出示例如下： ```shell +-------------------------------------------------------------------------------------------------------------------------------------------+ | Local Repository List | +---------------------------+---------+------------------------+--------+------------------------------------------+--------------+---------+ | name | version | release | arch | md5 | tags | size | +---------------------------+---------+------------------------+--------+------------------------------------------+--------------+---------+ | oceanbase-ce | 4.3.5.2 | 102030022025073116.el8 | x86_64 | 1148a1174464e514a61892eaf2317f86e4acd0a7 | oceanbase-ce | 916.81M | | oceanbase-diagnostic-tool | 3.5.0 | 12025062011.el7 | x86_64 | 4e0f91ad1b57072139161cdc89e8cbd42e01e984 | | 68.39M | | oceanbase-diagnostic-tool | 3.6.0 | 22025080417.el7 | x86_64 | ce431826e5571a6e00d81b9849e32eb53991169f | | 68.52M | +---------------------------+---------+------------------------+--------+------------------------------------------+--------------+---------+ ``` 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线