安装工具

操作步骤

1. 获取软件包：https://gitee.com/openeuler/devkit-pipeline/releases/download/v1.0.3/devkit-pipeline-v1.0.3.tar.gz。
2. 上传软件包到鲲鹏服务器并解压，解压后linux文件夹下有deploy_tool、download_tool、machine.yaml和script_generator文件。
   

   • deploy_tool：批量部署工具
   • download_tool：一键下载工具
   • machine.yaml：配置文件
   • script_generator：生成Jenkins、GitLab流水线运行模板

   详细内容请参见工具介绍。

   若当前鲲鹏服务器没有外网访问权限，请在有网络的鲲鹏服务器使用Linux版本的一键下载工具来下载批量部署工具所需的组件包，或在有网络的Windows环境中使用Windows版本的一键下载工具来下载部署工具所需的组件包。

3. 使用RSA协议生成公私钥对，执行以下命令在当前路径下生成RSA公私钥对。

   ssh-keygen -t rsa

   

   生成公私钥对命令参考：ssh-keygen [-b bits] [-t rsa] [-f output_keyfile]

   • -b：指定bytes长度。
   • -t：指定生成的密钥类型。
   • -f：指定公私钥文件名。

   执行命令后，回显信息会提示用户输入生成公私钥对所用密码，若输入密码，则后续批量部署工具在运行时需要用户手动输入密码，或在machine.yaml配置文件中新增一行password参数并填入公私钥对所用密码。

4. 执行以下命令配置本节点免密连接其他节点。

   ssh-copy-id -i filepath/id_rsa.pub USER@REMOTE_HOST

   

   • -i：指定用户配置免密的公钥路径。
   • USER：远程服务器用户名。
   • REMOTE_HOST：远程服务器IP地址。

   执行命令后提示输入远程服务器密码，输入密码后公钥被复制到远程服务器的authorized_keys文件中，实现免密登录远程服务器。若上述IP地址中出现本机IP地址，或想要本机到本机的安装部署，则需要配置本机到本机的免密登录。

5. 部署执行Compatibility Testing的执行机、DevKit CLI的扫描机、ClamAV的病毒扫描执行机或者DevKit Web的DevKit部署机上的普通用户需要配置sudo权限与sudo免密。

   执行visudo命令修改“/etc/sudoers”文件。

   1. 普通用户（USER）配置sudo权限，需在“/etc/sudoers”文件中对比“root ALL=(ALL) ALL”新增一行。

      root    ALL=(ALL)       ALL 
      USER    ALL=(ALL)       NOPASSWD: ALL

   2. 普通用户（USER）配置sudo免密，需在“ /etc/sudoers”文件中对比 “# %wheel ALL=(ALL) NOPASSWD: ALL”新增一行。

      # %wheel        ALL=(ALL)       NOPASSWD: ALL 
      USER            ALL=(ALL)       NOPASSWD: ALL

6. （可选）执行以下命令下载组件，若当前环境可联网，可跳过此步骤。
   • 可按machine.yaml配置文件中的有效角色下载GCC for openEuler、BiSheng Compiler、BiSheng JDK8、BiSheng JDK17、Compatibility Testing、DevKit Web、DevKit CLI和DevKit Tester组件。

     ./download_tool -f ./machine.yaml

   • 可通过一键下载工具下载本地iso镜像。

     ./download_tool -iso auto

   

   download_tool命令参数说明：

   • -f：指定yaml文件路径。
   • -iso：指定下载iso版本，输入“auto”将自动检测操作系统版本，并自动下载对应的版本iso文件。
7. 安装依赖。
   安装A-FOT工具前需要先使用yum安装“perf”命令，A-FOT工具为c_builder_gcc角色（即c/cpp构建机）。

   yum install perf -y

8. 执行以下命令部署组件。
   可按machine.yaml配置文件中的有效角色部署GCC for openEuler、BiSheng Compiler、BiSheng JDK8、BiSheng JDK17、Compatibility Testing、DevKit Web、DevKit CLI、ClamAV和DevKit Tester组件。

   ./deploy_tool -f ./machine.yaml 

   

   -f：指定yaml文件路径。

   批量部署工具将标准输出作为日志输出地址，没有生成单独的日志文件。

   使用批量部署工具，需要提前在目标节点安装tar命令用于安装组件。

9. 查看部署结果。

   批量部署工具将各组件安装至用户家目录下的“.local”文件夹下。

   

   工具部署完成后，当前窗口需要重新加载环境变量，推荐执行“su - USER”命令使新的环境变量生效，其中USER为执行部署工具的用户。

   环境变量重新加载后，可查看对应组件的部署结果。

   • GCC for openEuler部署结果

     批量部署工具将GCC for openEuler安装包解压至用户家目录下的“.local”文件夹下，并在用户的~/.bashrc文件中新增如下四行命令。用户重新登录服务器后即可查询当前环境所用gcc版本。

     export GCC_HOME=${HOME}/.local/gcc-10.3.1-2023.12-aarch64-linux
     export PATH=${GCC_HOME}/bin:${PATH}
     export INCLUDE=${GCC_HOME}/include:${INCLUDE}
     export LD_LIBRARY_PATH=${GCC_HOME}/lib64:${LD_LIBRARY_PATH}

   • BiSheng Compiler部署结果

     批量部署工具将BiSheng Compiler安装包解压至用户家目录下的“.local”文件夹下，并在用户的~/.bashrc文件中新增如下三行命令。用户重新登录服务器后即可查询当前环境所用clang版本。

     export BISHENG_COMPILER_HOME=${HOME}/.local/BiShengCompiler-3.2.0-aarch64-linux
     export PATH=${BISHENG_COMPILER_HOME}/bin:${PATH}
     export LD_LIBRARY_PATH=${BISHENG_COMPILER_HOME}/lib:${BISHENG_COMPILER_HOME}/lib/aarch64-unknown-linux-gnu:${LD_LIBRARY_PATH}

   • BiSheng JDK8部署结果

     批量部署工具将BiSheng JDK8安装包解压至用户家目录下的“.local”文件夹下。执行以下命令查询部署结果。

     查询当前环境所用Java版本。

     java -version

     终端返回信息，即Java环境设置成功。

     openjdk version "1.8.0_402"

   • BiSheng JDK17部署结果

     批量部署工具将BiSheng JDK17安装包解压至用户家目录下的“.local”文件夹下。执行以下命令查询部署结果。

     查询当前环境所用Java版本。

     java -version

     终端返回信息，即Java环境设置成功。

     openjdk version "17.0.10" 2024-01-16

   • A-FOT部署结果

     批量部署工具将A-FOT安装包解压至用户家目录下的“.local”文件夹下，并在用户的~/.bashrc文件中新增如下两行命令。用户重新登录服务器后，配置好配置文件后即可使用a-fot --config_file a-fot.ini（也可通过命令行灵活配置，请参见安装A-FOT工具）进行优化应用。

     export A_FOT_HOME=${HOME}/.local/a-fot 
     export PATH=${A_FOT_HOME}:${PATH}

   • Compatibility Testing部署结果

     批量部署工具会在“${HOME}”路径下解压 compatibility_testing.tar.gz文件夹，执行以下命令可确认关键文件是否存在。

     ls ${HOME}/.local/compatibility_testing/bin/compatibility_test

   • DevKit Web部署结果

     批量部署工具会在“/opt”目录下安装DevKit Web端后台，只安装java_perf插件，并初始化管理员（devadmin）用户密码，初始密码为devkit123。

   • DevKit CLI部署结果
     可执行以下命令查看DevKit CLI安装位置。

     which devkit

   • DevKit Tester部署结果

     批量部署工具会在“${HOME}”路径下解压devkit_tester.tar.gz文件夹，执行以下命令可确认关键文件是否存在。

     ls ${HOME}/.local/devkit_tester

   • ClamAV工具部署结果

     执行以下命令查看ClamAV工具的版本。

     clamscan -V

     终端返回信息，即ClamAV工具部署成功。

     ClamAV 0.103.9/26818/Mon Feb 20 16:21:31 2023

   • 无感切换依赖

     若用户的某些应用或命令希望使用批量部署工具安装的BiSheng Compiler的相关环境变量，可以执行以下命令。

     source ${HOME}/.local/wrap-bin/devkit_pipeline.sh

   

   不建议在同一环境下部署BiSheng JDK8和BiSheng JDK17，若在同一环境下部署，只有一个JDK生效。