From 689b680349200cf0405c6d96bafd96da144f7b3d Mon Sep 17 00:00:00 2001 From: Yingjiahui Date: Thu, 6 Mar 2025 20:33:53 +0800 Subject: [PATCH 1/5] =?UTF-8?q?update=20epkg=E4=BD=BF=E7=94=A8=E6=8C=87?= =?UTF-8?q?=E5=8D=97.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...77\347\224\250\346\214\207\345\215\227.md" | 392 +++++++++--------- 1 file changed, 202 insertions(+), 190 deletions(-) diff --git "a/docs/zh/docs/epkg/epkg\344\275\277\347\224\250\346\214\207\345\215\227.md" "b/docs/zh/docs/epkg/epkg\344\275\277\347\224\250\346\214\207\345\215\227.md" index 059f8793a..49827e5c9 100644 --- "a/docs/zh/docs/epkg/epkg\344\275\277\347\224\250\346\214\207\345\215\227.md" +++ "b/docs/zh/docs/epkg/epkg\344\275\277\347\224\250\346\214\207\345\215\227.md" @@ -1,47 +1,46 @@ -# epkg 使用指南 - -## 介绍 +# 介绍 本文介绍EPKG包管理器工作环境如何初始化，以及基本功能如何使用。本文涉及操作结果示例均以非root用户为例。 -注意：目前epkg的软件包只适配了aarch64架构，后续会不断扩展其他架构 - -## 快速上手 +# 快速上手 下面的实例介绍了安装不同软件包版本的方式 - ```bash # curl 方式安装epkg # 安装时可选user/global安装模式，user模式仅当前安装用户可用，global模式全局用户可用 # 仅root用户可使用global安装模式 wget https://repo.oepkgs.net/openeuler/epkg/rootfs/epkg-installer.sh -sh epkg-installer.sh +bash epkg-installer.sh # 卸载epkg wget https://repo.oepkgs.net/openeuler/epkg/rootfs/epkg-uninstaller.sh -sh epkg-uninstaller.sh +bash epkg-uninstaller.sh # 初始化epkg +# user模式安装：自动初始化 +# global模式安装：root用户自动初始化，其他用户需要手动初始化 epkg init bash // 重新执行.bashrc, 获得新的PATH -# 创建环境1 +# 创建环境t1 epkg env create t1 epkg install tree tree --version which tree # 查看repo -[root@vm-4p64g ~]# epkg repo list +[root@vbox ~]# epkg repo list +EPKG_ACTIVE_ENV: ------------------------------------------------------------------------------------------------------------------------------------------------------ channel | repo | url ------------------------------------------------------------------------------------------------------------------------------------------------------ -openEuler-22.03-LTS-SP3 | OS | https://repo.oepkgs.net/openeuler/epkg/channel/openEuler-22.03-LTS-SP3/OS/aarch64/ -openEuler-24.09 | everything | https://repo.oepkgs.net/openeuler/epkg/channel/openEuler-24.09/everything/aarch64/ -openEuler-24.09 | OS | https://repo.oepkgs.net/openeuler/epkg/channel/openEuler-24.09/OS/aarch64/ +openEuler-20.03-LTS-SP4 | everything | https://repo.oepkgs.net/openeuler/epkg/channel/openEuler-20.03-LTS-SP4/everything/ +openEuler-22.03-LTS-SP4 | everything | https://repo.oepkgs.net/openeuler/epkg/channel/openEuler-22.03-LTS-SP4/everything/ +openEuler-24.03-LTS | everything | https://repo.oepkgs.net/openeuler/epkg/channel/openEuler-24.03-LTS/everything/ +openEuler-24.09 | everything | https://repo.oepkgs.net/openeuler/epkg/channel/openEuler-24.09/everything/ ------------------------------------------------------------------------------------------------------------------------------------------------------ # 创建环境2, 指定repo epkg env create t2 --repo openEuler-22.03-LTS-SP3 -epkg install tree +epkg install tree tree --version which tree @@ -49,233 +48,246 @@ which tree epkg env activate t1 ``` -## EPKG包管理器使用说明 - +# EPKG包管理器使用说明 ```bash Usage: - epkg install PACKAGE - epkg install [--env ENV] PACKAGE （开发中...） - epkg remove [--env ENV] PACKAGE （开发中...） - epkg upgrade [PACKAGE] （开发中...） - - epkg search PACKAGE （开发中...） - epkg list （开发中...） - - epkg env list - epkg env create|remove ENV - epkg env activate ENV - epkg env deactivate ENV - epkg env register|unregister ENV - epkg env history ENV （开发中...） - epkg env rollback ENV （开发中...） +    epkg install +    epkg remove [-y] +    epkg upgrade （开发中...） +    +    epkg list + +    epkg env list +    epkg env create [--repo ] +    epkg env remove +    epkg env activate [--pure] +    epkg env deactivate +    epkg env register|unregister +    epkg env history +    epkg env rollback ``` -软件包安装： -```bash - epkg env create $env // 创建环境 - epkg install $package // 在环境中安装软件包 - epkg env create $env2 --repo $repo // 创建环境2，指定repo - epkg install $package // 在环境2中安装软件包 -``` +## 安装软件 +功能描述： + 在当前activate的环境中安装软件 + 若无环境激活，默认安装到main环境中：`epkg env activate ` -软件包构建： +命令： + `epkg install ` + +示例： ```bash - epkg build ${yaml_path}/$pkg_name.yaml +[root@vbox ~]# epkg env create t1 +EPKG_ACTIVE_ENV: +Environment t1 not exist. +Environment 't1' has been created. +Environment 't1' activated. +[root@vbox ~]# epkg install tree +EPKG_ACTIVE_ENV: t1 +Attention: Install success: 8jkd3nbg9td5jnc738yhrz5yjwy5qzha__openEuler-repos__1.0__3.7.oe2403 2px41kqhx9matg9e5zgy36s06qqdn3nj__glibc-all-langpacks__2.38__29.oe24.... +[root@vbox ~]# epkg install htop +EPKG_ACTIVE_ENV: t1 +Warning: The following packages are already installed and will be skipped: +- 6sgyzx3s7624r0x7rpe4w8642p2d181r__fuse__2.9.9__11.oe2403 +- 3gypc46xq6mqd37ya3mhztz2zfkjghw1__libsigsegv__2.14__1.oe2403 +.... +Attention: Install success: v0wrq5sv9r5znsgtgxkbax24r7f6nq80__htop__3.3.0__1.oe2403 +[root@vbox ~]# ``` -### 安装软件 +## 卸载软件 功能描述： - - 在当前所在环境安装软件（建议操作前确认当前所在环境） + 在当前activate的环境中安装软件 + 若无环境激活，默认安装到main环境中：`epkg env activate ` 命令： + `epkg remove ` - epkg install ${package_name} - -返回示例： -``` -[root@2d785c36ee2e /]# epkg env activate t1 -Add common to path -Add t1 to path -Environment 't1' activated. +示例： +```bash +[root@vbox ~]# epkg env activate t1 Environment 't1' activated. -[root@2d785c36ee2e /]# epkg install tree -EPKG_ENV_NAME: t1 -Caching repodata for: "OS" -Cache for "OS" already exists. Skipping... -Caching repodata for: "OS" -Cache for "OS" already exists. Skipping... -Caching repodata for: "everything" -Cache for "everything" already exists. Skipping... -start download https://repo.oepkgs.net/openeuler/epkg/channel/openEuler-24.09/everything/aarch64//store/FF/FFCRTKRFGFQ6S2YVLOSUF6PHSMRP7A2N__ncurses-libs__6.4__8.oe2409.epkg -############################################################################################################################################################################################################### 100.0% -start download https://repo.oepkgs.net/openeuler/epkg/channel/openEuler-24.09/everything/aarch64//store/D5/D5BOEFTRBNV3E4EXBVXDSRNTIGLGWVB7__glibc-all-langpacks__2.38__34.oe2409.epkg -############################################################################################################################################################################################################### 100.0% -start download https://repo.oepkgs.net/openeuler/epkg/channel/openEuler-24.09/everything/aarch64//store/VX/VX6SUOPGEVDWF6E5M2XBV53VS7IXSFM5__openEuler-repos__1.0__3.3.oe2409.epkg -############################################################################################################################################################################################################### 100.0% -start download https://repo.oepkgs.net/openeuler/epkg/channel/openEuler-24.09/everything/aarch64//store/LO/LO6RYZTBB2Q7ZLG6SWSICKGTEHUTBWUA__libselinux__3.5__3.oe2409.epkg -############################################################################################################################################################################################################### 100.0% -start download https://repo.oepkgs.net/openeuler/epkg/channel/openEuler-24.09/everything/aarch64//store/EP/EPIEEK2P5IUPO4PIOJ2BXM3QPEFTZUCT__basesystem__12__3.oe2409.epkg -############################################################################################################################################################################################################### 100.0% -start download https://repo.oepkgs.net/openeuler/epkg/channel/openEuler-24.09/everything/aarch64//store/2G/2GYDDYVWYYIDGOLGTVUACSBHYVRCRJH3__setup__2.14.5__2.oe2409.epkg -############################################################################################################################################################################################################### 100.0% -start download https://repo.oepkgs.net/openeuler/epkg/channel/openEuler-24.09/everything/aarch64//store/HC/HCOKXTWQQUPCFPNI7DMDC6FGSDOWNACC__glibc__2.38__34.oe2409.epkg -############################################################################################################################################################################################################### 100.0% -start download https://repo.oepkgs.net/openeuler/epkg/channel/openEuler-24.09/everything/aarch64//store/OJ/OJQAHJTY3Y7MZAXETYMTYRYSFRVVLPDC__glibc-common__2.38__34.oe2409.epkg -############################################################################################################################################################################################################### 100.0% -start download https://repo.oepkgs.net/openeuler/epkg/channel/openEuler-24.09/everything/aarch64//store/FJ/FJXG3K2TSUYXNU4SES2K3YSTA3AHHUMB__tree__2.1.1__1.oe2409.epkg -############################################################################################################################################################################################################### 100.0% -start download https://repo.oepkgs.net/openeuler/epkg/channel/openEuler-24.09/everything/aarch64//store/KD/KDYRBN74LHKSZISTLMYOMTTFVLV4GPYX__readline__8.2__2.oe2409.epkg -############################################################################################################################################################################################################### 100.0% -start download https://repo.oepkgs.net/openeuler/epkg/channel/openEuler-24.09/everything/aarch64//store/MN/MNJPSSBS4OZJL5EB6YKVFLMV4TGVBUBA__tzdata__2024a__2.oe2409.epkg -############################################################################################################################################################################################################### 100.0% -start download https://repo.oepkgs.net/openeuler/epkg/channel/openEuler-24.09/everything/aarch64//store/S4/S4FBO2SOMG3GKP5OMDWP4XN5V4FY7OY5__bash__5.2.21__1.oe2409.epkg -############################################################################################################################################################################################################### 100.0% -start download https://repo.oepkgs.net/openeuler/epkg/channel/openEuler-24.09/everything/aarch64//store/EJ/EJGRNRY5I6XIDBWL7H5BNYJKJLKANVF6__libsepol__3.5__3.oe2409.epkg -############################################################################################################################################################################################################### 100.0% -start download https://repo.oepkgs.net/openeuler/epkg/channel/openEuler-24.09/everything/aarch64//store/TZ/TZRQZRU2PNXQXHRE32VCADWGLQG6UL36__bc__1.07.1__12.oe2409.epkg -############################################################################################################################################################################################################### 100.0% -start download https://repo.oepkgs.net/openeuler/epkg/channel/openEuler-24.09/everything/aarch64//store/WY/WYMBYMCARHXD62ZNUMN3GQ34DIWMIQ4P__filesystem__3.16__6.oe2409.epkg -############################################################################################################################################################################################################### 100.0% -start download https://repo.oepkgs.net/openeuler/epkg/channel/openEuler-24.09/everything/aarch64//store/KQ/KQ2UE3U5VFVAQORZS4ZTYCUM4QNHBYZ7__openEuler-release__24.09__55.oe2409.epkg -############################################################################################################################################################################################################### 100.0% -start download https://repo.oepkgs.net/openeuler/epkg/channel/openEuler-24.09/everything/aarch64//store/HD/HDTOK5OTTFFKSTZBBH6AIAGV4BTLC7VT__openEuler-gpg-keys__1.0__3.3.oe2409.epkg -############################################################################################################################################################################################################### 100.0% -start download https://repo.oepkgs.net/openeuler/epkg/channel/openEuler-24.09/everything/aarch64//store/EB/EBLBURHOKKIUEEFHZHMS2WYF5OOKB4L3__pcre2__10.42__8.oe2409.epkg -############################################################################################################################################################################################################### 100.0% -start download https://repo.oepkgs.net/openeuler/epkg/channel/openEuler-24.09/everything/aarch64//store/YW/YW5WTOMKY2E5DLYYMTIDIWY3XIGHNILT__info__7.0.3__3.oe2409.epkg -############################################################################################################################################################################################################### 100.0% -start download https://repo.oepkgs.net/openeuler/epkg/channel/openEuler-24.09/everything/aarch64//store/E4/E4KCO6VAAQV5AJGNPW4HIXDHFXMR4EJV__ncurses-base__6.4__8.oe2409.epkg -############################################################################################################################################################################################################### 100.0% -start install FFCRTKRFGFQ6S2YVLOSUF6PHSMRP7A2N__ncurses-libs__6.4__8.oe2409 -start install D5BOEFTRBNV3E4EXBVXDSRNTIGLGWVB7__glibc-all-langpacks__2.38__34.oe2409 -start install VX6SUOPGEVDWF6E5M2XBV53VS7IXSFM5__openEuler-repos__1.0__3.3.oe2409 -start install LO6RYZTBB2Q7ZLG6SWSICKGTEHUTBWUA__libselinux__3.5__3.oe2409 -start install EPIEEK2P5IUPO4PIOJ2BXM3QPEFTZUCT__basesystem__12__3.oe2409 -start install 2GYDDYVWYYIDGOLGTVUACSBHYVRCRJH3__setup__2.14.5__2.oe2409 -start install HCOKXTWQQUPCFPNI7DMDC6FGSDOWNACC__glibc__2.38__34.oe2409 -start install OJQAHJTY3Y7MZAXETYMTYRYSFRVVLPDC__glibc-common__2.38__34.oe2409 -start install FJXG3K2TSUYXNU4SES2K3YSTA3AHHUMB__tree__2.1.1__1.oe2409 -start install KDYRBN74LHKSZISTLMYOMTTFVLV4GPYX__readline__8.2__2.oe2409 -start install MNJPSSBS4OZJL5EB6YKVFLMV4TGVBUBA__tzdata__2024a__2.oe2409 -start install S4FBO2SOMG3GKP5OMDWP4XN5V4FY7OY5__bash__5.2.21__1.oe2409 -start install EJGRNRY5I6XIDBWL7H5BNYJKJLKANVF6__libsepol__3.5__3.oe2409 -start install TZRQZRU2PNXQXHRE32VCADWGLQG6UL36__bc__1.07.1__12.oe2409 -start install WYMBYMCARHXD62ZNUMN3GQ34DIWMIQ4P__filesystem__3.16__6.oe2409 -start install KQ2UE3U5VFVAQORZS4ZTYCUM4QNHBYZ7__openEuler-release__24.09__55.oe2409 -start install HDTOK5OTTFFKSTZBBH6AIAGV4BTLC7VT__openEuler-gpg-keys__1.0__3.3.oe2409 -start install EBLBURHOKKIUEEFHZHMS2WYF5OOKB4L3__pcre2__10.42__8.oe2409 -start install YW5WTOMKY2E5DLYYMTIDIWY3XIGHNILT__info__7.0.3__3.oe2409 -start install E4KCO6VAAQV5AJGNPW4HIXDHFXMR4EJV__ncurses-base__6.4__8.oe2409 +[root@vbox ~]# epkg remove htop +Packages to remove: +- v0wrq5sv9r5znsgtgxkbax24r7f6nq80__htop__3.3.0__1.oe2403 +Do you want to continue with uninstallation? (y/n): +y +Attention: Remove success: v0wrq5sv9r5znsgtgxkbax24r7f6nq80__htop__3.3.0__1.oe2403 +[root@vbox ~]# ``` -### 列出环境列表 +## 列出环境 功能描述： - - 列出当前epkg所有环境（$EPKG_ENVS_ROOT目录下），及当前处于哪个环境 +    列出当前epkg所有环境，及激活和注册的环境 命令： +    `epkg env list` - epkg env list +示例： +```bash +[root@vbox ~]# epkg env list +EPKG_ACTIVE_ENV: t1 +Environment Status +----------------------------------- +t1 activated +main registered +``` -返回示例： +## 创建环境 +功能描述： + 创建新环境，默认激活创建的环境 - [small_leek@19e784a5bc38 bin]# epkg env list - Available environments(sort by time): - w1 - main - common - You are in [main] now +命令： +    `epkg env create ` - +示例： +```bash +[root@vbox ~]# epkg env create t2 +EPKG_ACTIVE_ENV: t1 +Environment t2 not exist. +Environment 't2' has been created. +Environment 't2' activated. +[root@vbox ~]# epkg env list +EPKG_ACTIVE_ENV: t2 +Environment Status +----------------------------------- +t2 activated +t1 +main registered +``` -### 创建环境 +## 删除环境 功能描述： - - 创建新环境（创建成功后，默认激活新环境，即切换进新环境；但是不全局注册） + 删除环境 命令： +    `epkg env remove ` - epkg env create ${env_name} - -返回示例： - - [small_leek@b0e608264355 bin]# epkg env create work1 - YUM --installroot directory structure created successfully in: /root/.epkg/envs/work1/profile-1 - Environment 'work1' added to PATH. - Environment 'work1' activated. - Environment 'work1' created. +示例： +```bash +[root@vbox ~]# epkg env remove t2 +EPKG_ACTIVE_ENV: t2 +Environment t2 exist. +Environment t2 not registered. +Environment t2 has been removed. +[root@vbox ~]# epkg env list +EPKG_ACTIVE_ENV: +Environment Status +----------------------------------- +t1 +main registered +``` -### 激活环境 +## 激活环境 功能描述： - - 激活指定环境，刷新EPKG_ENV_NAME和RPMDB_DIR（用于安装软件至指定环境时，指向--dbpath），刷新PATH，包含指定环境及common环境，并将指定环境设为第一优先级 + 激活指定的环境，刷新PATH，并将激活环境设为第一优先级 命令： + `epkg env activate ` - epkg env activate ${env_name} - -返回示例： - - [small_leek@9d991d463f89 bin]# epkg env activate main - Environment 'main' activated +示例： +```bash +[root@vbox ~]# epkg env activate main +Environment 'main' activated. +[root@vbox ~]# epkg env list +EPKG_ACTIVE_ENV: main +Environment Status +----------------------------------- +t1 +main activated|registered +[root@vbox ~]# echo $PATH +/root/.epkg/envs/main/profile-current/usr/app-bin:/root/.cargo/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/root/bin +``` -### 取消激活环境 +## 去激活环境 功能描述： - - 取消激活指定环境，刷新EPKG_ENV_NAME和RPMDB_DIR，刷新PATH，默认指向main环境 + 去激活环境，去激活当前已激活的环境，刷新PATH 命令： + `epkg env deactivate` - epkg env deactivate ${env_name} +示例： +```bash +[root@vbox ~]# epkg env activate t1 +Environment 't1' activated. +[root@vbox ~]# echo $PATH +/root/.epkg/envs/t1/profile-current/usr/app-bin:/root/.epkg/envs/main/profile-current/usr/app-bin:/root/.cargo/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/root/bin +[root@vbox ~]# epkg env deactivate +Environment 't1' deactivated. +[root@vbox ~]# echo $PATH +/root/.epkg/envs/main/profile-current/usr/app-bin:/root/.cargo/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/root/bin +``` -返回示例： +## 注册环境 +功能描述： + 持久化注册指定环境，刷新PATH + 注册的环境在新的shell中依然生效 - [small_leek@398ec57ce780 bin]# epkg env deactivate w1 - Environment 'w1' deactivated. +命令： + `epkg env register ` +示例： +```bash +[root@vbox ~]# epkg env register t1 +EPKG_ACTIVE_ENV: +Environment t1 exist. +Environment 't1' has been registered. +[root@vbox ~]# echo $PATH +/root/.epkg/envs/t1/profile-current/usr/app-bin:/root/.epkg/envs/main/profile-current/usr/app-bin:/root/.cargo/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/root/bin +[root@vbox ~]# epkg env list +EPKG_ACTIVE_ENV: +Environment Status +----------------------------------- +t1 registered +main registered +``` -### 注册环境 +## 去注册环境 功能描述： - - 注册指定环境，持久化刷新PATH，包含epkg所有已注册环境，并将指定环境设为第一优先级 +    持久化去注册指定环境，刷新PATH 命令： +    `epkg env unregister ` - epkg env register ${env_name} - -返回示例： - - [small_leek@5042ae77dd75 bin]# epkg env register lkp - EPKG_ACTIVE_ENV: - Environment 'lkp' has been registered to PATH. +示例： +```bash +[root@vbox ~]# epkg env unregister t1 +EPKG_ACTIVE_ENV: +Environment t1 exist. +Environment t1 had been registered. +Environment 't1' has been unregistered from PATH. +``` -### 取消注册环境 +## 环境历史 功能描述： - - 去注册指定环境，持久化刷新PATH，包含除指定环境外的epkg所有已注册环境 +    查看当前激活环境的历史记录 命令： +    `epkg env history` - epkg env unregister ${env_name} - -返回示例： - - [small_leek@69393675945d /]# epkg env unregister w4 - EPKG_ACTIVE_ENV: - Environment 'w4' has been unregistered from PATH. +示例： +```bash +[root@vbox ~]# epkg env activate t1 +Environment 't1' activated. +[root@vbox ~]# epkg env history +-------------------------------------------------- t1 env history -------------------------------------------------- +id | timestamp | action | new_packages | del_packages | command line +----+----------------------------+------------+--------------+--------------+----------------------------------------- +1 | 2025-03-06 20:23:31 +08:00 | install | 70 | 0 | /opt/epkg/users/public/envs/common/profile-current/usr/bin/epkg install tree +2 | 2025-03-06 20:23:38 +08:00 | install | 1 | 0 | /opt/epkg/users/public/envs/common/profile-current/usr/bin/epkg install htop +3 | 2025-03-06 20:23:45 +08:00 | remove | 0 | 1 | /opt/epkg/users/public/envs/common/profile-current/usr/bin/epkg remove htop +``` -### 编译epkg软件包 +## 环境回退 功能描述： - - 根据autopkg提供的yaml编译epkg软件包 +    回退激活环境，history_id即epkg env history中查询的id列 命令： +    `epkg env rollback ` - epkg build ${yaml_path}/$pkg_name.yaml - -返回示例： - - [small_leek@69393675945d /]# epkg build /root/epkg/build/test/tree/package.yaml - pkg_hash: fbfqtsnza9ez1zk0cy23vyh07xfzsydh, dir: /root/.cache/epkg/build-workspace/result - Compress success: /root/.cache/epkg/build-workspace/epkg/fbfqtsnza9ez1zk0cy23vyh07xfzsydh__tree__2.1.1__0.oe2409.epkg \ No newline at end of file +示例： +```bash +[root@vbox ~]# epkg env rollback 2 +Rollback informaton: +New: ["v0wrq5sv9r5znsgtgxkbax24r7f6nq80__htop__3.3.0__1.oe2403"], Del: [] +``` -- Gitee From 20c945370c049da510bde07d5956215db8a44675 Mon Sep 17 00:00:00 2001 From: Yingjiahui Date: Thu, 6 Mar 2025 20:44:44 +0800 Subject: [PATCH 2/5] fix markdownlint --- ...77\347\224\250\346\214\207\345\215\227.md" | 98 ++++++++++++------- 1 file changed, 62 insertions(+), 36 deletions(-) diff --git "a/docs/zh/docs/epkg/epkg\344\275\277\347\224\250\346\214\207\345\215\227.md" "b/docs/zh/docs/epkg/epkg\344\275\277\347\224\250\346\214\207\345\215\227.md" index 49827e5c9..83064f4f3 100644 --- "a/docs/zh/docs/epkg/epkg\344\275\277\347\224\250\346\214\207\345\215\227.md" +++ "b/docs/zh/docs/epkg/epkg\344\275\277\347\224\250\346\214\207\345\215\227.md" @@ -1,8 +1,11 @@ # 介绍 + 本文介绍EPKG包管理器工作环境如何初始化，以及基本功能如何使用。本文涉及操作结果示例均以非root用户为例。 -# 快速上手 +## 快速上手 + 下面的实例介绍了安装不同软件包版本的方式 + ```bash # curl 方式安装epkg # 安装时可选user/global安装模式，user模式仅当前安装用户可用，global模式全局用户可用 @@ -48,7 +51,8 @@ which tree epkg env activate t1 ``` -# EPKG包管理器使用说明 +## EPKG包管理器使用说明 + ```bash Usage:     epkg install @@ -67,15 +71,17 @@ Usage:     epkg env rollback ``` -## 安装软件 +### 安装软件 + 功能描述： - 在当前activate的环境中安装软件 - 若无环境激活，默认安装到main环境中：`epkg env activate ` + 在当前activate的环境中安装软件 + 若无环境激活，默认安装到main环境中：`epkg env activate ` 命令： - `epkg install ` + `epkg install ` 示例： + ```bash [root@vbox ~]# epkg env create t1 EPKG_ACTIVE_ENV: @@ -95,15 +101,17 @@ Attention: Install success: v0wrq5sv9r5znsgtgxkbax24r7f6nq80__htop__3.3.0__1.oe2 [root@vbox ~]# ``` -## 卸载软件 +### 卸载软件 + 功能描述： - 在当前activate的环境中安装软件 - 若无环境激活，默认安装到main环境中：`epkg env activate ` + 在当前activate的环境中安装软件 + 若无环境激活，默认安装到main环境中：`epkg env activate ` 命令： - `epkg remove ` + `epkg remove ` 示例： + ```bash [root@vbox ~]# epkg env activate t1 Environment 't1' activated. @@ -116,14 +124,16 @@ Attention: Remove success: v0wrq5sv9r5znsgtgxkbax24r7f6nq80__htop__3.3.0__1.oe24 [root@vbox ~]# ``` -## 列出环境 +### 列出环境 + 功能描述： -    列出当前epkg所有环境，及激活和注册的环境 + 列出当前epkg所有环境，及激活和注册的环境 命令： -    `epkg env list` + `epkg env list` 示例： + ```bash [root@vbox ~]# epkg env list EPKG_ACTIVE_ENV: t1 @@ -133,14 +143,16 @@ t1 activated main registered ``` -## 创建环境 +### 创建环境 + 功能描述： - 创建新环境，默认激活创建的环境 + 创建新环境，默认激活创建的环境 命令： -    `epkg env create ` + `epkg env create ` 示例： + ```bash [root@vbox ~]# epkg env create t2 EPKG_ACTIVE_ENV: t1 @@ -156,14 +168,16 @@ t1 main registered ``` -## 删除环境 +### 删除环境 + 功能描述： - 删除环境 + 删除环境 命令： -    `epkg env remove ` + `epkg env remove ` 示例： + ```bash [root@vbox ~]# epkg env remove t2 EPKG_ACTIVE_ENV: t2 @@ -178,14 +192,16 @@ t1 main registered ``` -## 激活环境 +### 激活环境 + 功能描述： - 激活指定的环境，刷新PATH，并将激活环境设为第一优先级 + 激活指定的环境，刷新PATH，并将激活环境设为第一优先级 命令： - `epkg env activate ` + `epkg env activate ` 示例： + ```bash [root@vbox ~]# epkg env activate main Environment 'main' activated. @@ -199,14 +215,16 @@ main activated|registered /root/.epkg/envs/main/profile-current/usr/app-bin:/root/.cargo/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/root/bin ``` -## 去激活环境 +### 去激活环境 + 功能描述： - 去激活环境，去激活当前已激活的环境，刷新PATH + 去激活环境，去激活当前已激活的环境，刷新PATH 命令： - `epkg env deactivate` + `epkg env deactivate` 示例： + ```bash [root@vbox ~]# epkg env activate t1 Environment 't1' activated. @@ -218,15 +236,17 @@ Environment 't1' deactivated. /root/.epkg/envs/main/profile-current/usr/app-bin:/root/.cargo/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/root/bin ``` -## 注册环境 +### 注册环境 + 功能描述： - 持久化注册指定环境，刷新PATH - 注册的环境在新的shell中依然生效 + 持久化注册指定环境，刷新PATH + 注册的环境在新的shell中依然生效 命令： - `epkg env register ` + `epkg env register ` 示例： + ```bash [root@vbox ~]# epkg env register t1 EPKG_ACTIVE_ENV: @@ -242,14 +262,16 @@ t1 registered main registered ``` -## 去注册环境 +### 去注册环境 + 功能描述： -    持久化去注册指定环境，刷新PATH + 持久化去注册指定环境，刷新PATH 命令： -    `epkg env unregister ` + `epkg env unregister ` 示例： + ```bash [root@vbox ~]# epkg env unregister t1 EPKG_ACTIVE_ENV: @@ -258,14 +280,16 @@ Environment t1 had been registered. Environment 't1' has been unregistered from PATH. ``` -## 环境历史 +### 环境历史 + 功能描述： -    查看当前激活环境的历史记录 + 查看当前激活环境的历史记录 命令： -    `epkg env history` + `epkg env history` 示例： + ```bash [root@vbox ~]# epkg env activate t1 Environment 't1' activated. @@ -278,7 +302,8 @@ id | timestamp | action | new_packages | del_packages | co 3 | 2025-03-06 20:23:45 +08:00 | remove | 0 | 1 | /opt/epkg/users/public/envs/common/profile-current/usr/bin/epkg remove htop ``` -## 环境回退 +### 环境回退 + 功能描述：     回退激活环境，history_id即epkg env history中查询的id列 @@ -286,6 +311,7 @@ id | timestamp | action | new_packages | del_packages | co     `epkg env rollback ` 示例： + ```bash [root@vbox ~]# epkg env rollback 2 Rollback informaton: -- Gitee From 7c6a1ca77ffa33e9ee1e1cd6e2573a2261060560 Mon Sep 17 00:00:00 2001 From: Yingjiahui Date: Thu, 6 Mar 2025 21:07:50 +0800 Subject: [PATCH 3/5] add _menu.md --- docs/zh/docs/epkg/_menu.md | 0 1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 docs/zh/docs/epkg/_menu.md diff --git a/docs/zh/docs/epkg/_menu.md b/docs/zh/docs/epkg/_menu.md new file mode 100644 index 000000000..e69de29bb -- Gitee From ca771cfd18e380b751e76cf4485d7d092006e6ad Mon Sep 17 00:00:00 2001 From: Yingjiahui Date: Wed, 19 Mar 2025 14:28:38 +0800 Subject: [PATCH 4/5] update rollback echo --- ...pkg\344\275\277\347\224\250\346\214\207\345\215\227.md" | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git "a/docs/zh/docs/epkg/epkg\344\275\277\347\224\250\346\214\207\345\215\227.md" "b/docs/zh/docs/epkg/epkg\344\275\277\347\224\250\346\214\207\345\215\227.md" index 83064f4f3..b2344ebc8 100644 --- "a/docs/zh/docs/epkg/epkg\344\275\277\347\224\250\346\214\207\345\215\227.md" +++ "b/docs/zh/docs/epkg/epkg\344\275\277\347\224\250\346\214\207\345\215\227.md" @@ -314,6 +314,9 @@ id | timestamp | action | new_packages | del_packages | co ```bash [root@vbox ~]# epkg env rollback 2 -Rollback informaton: -New: ["v0wrq5sv9r5znsgtgxkbax24r7f6nq80__htop__3.3.0__1.oe2403"], Del: [] +-------------------------------------- Rollback informaton --------------------------------------- +action | hash | pkg | version | release | dist +-------+----------------------------------+----------------------+------------+---------+------------ +new | v0wrq5sv9r5znsgtgxkbax24r7f6nq80 | htop | 3.3.0 | 1 | 1.oe2403 +Rollback success! ``` -- Gitee From ecc406b572b76382053f467b8b404a5079cafb81 Mon Sep 17 00:00:00 2001 From: Yingjiahui Date: Fri, 28 Mar 2025 10:32:42 +0800 Subject: [PATCH 5/5] remove menu.md --- docs/zh/docs/epkg/_menu.md | 0 1 file changed, 0 insertions(+), 0 deletions(-) delete mode 100644 docs/zh/docs/epkg/_menu.md diff --git a/docs/zh/docs/epkg/_menu.md b/docs/zh/docs/epkg/_menu.md deleted file mode 100644 index e69de29bb..000000000 -- Gitee