Руководство по компиляции We-cmdb

Подготовка к компиляции

1. Подготовьте один хост Linux;
2. Рекомендуется использовать операционную систему Ubuntu 16.04 или выше, либо CentOS 7 или выше;
3. Необходим доступ к интернету (для загрузки пакетов зависимостей из сети);
4. Установите Git:
   • с помощью yum:

     yum install -y git
   • вручную, обратитесь к руководству по установке Git (git_install_guide.md);
5. Установите Docker версии 1.17.03.x или выше:
   • с помощью yum:

     yum-config-manager --add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo
     yum makecache fast
     yum install docker-ce -y
   • вручную, обратитесь к руководству по установке Docker (docker_install_guide.md);
6. Запустите Docker:

   systemctl start docker

Процесс компиляции

1. Извлеките код с GitHub:

   Переключитесь на каталог локального репозитория и выполните команду:

   cd /app/wecmdb/
   git clone https://github.com/WeBankPartners/we-cmdb.git

   Введите учётные данные GitHub для авторизации и загрузите код на локальный компьютер. После завершения загрузки вы увидите каталог we-cmdb в локальном каталоге. Войдите в этот каталог и изучите его структуру:

   

2. Загрузите базовый образ Alpine и образ ccr.ccs.tencentyun.com/webankpartners/golang-ext:v1.15.6:

   docker pull alpine
   docker pull ccr.ccs.tencenyun.com/webankpartners/golang-ext:v1.15.6

   Образ ccr.ccs.tencentyun.com/webankpartners/golang-ext:v1.15.6 основан на официальном образе golang:1.15.6 с дополнительными пакетами расширений. Просмотрите список образов:

3. Установите Node.js (рекомендуется) или загрузите образ node:12.13.1:

   Поскольку образы Node.js на Docker слишком большие и медленные, рекомендуется установить Node.js вручную:

   • установите вручную:

     cd /usr/local/src
     wget https://npm.taobao.org/mirrors/node/v14.7.0/node-v14.7.0-linux-x64.tar.xz
     xz -d node-v14.7.0-linux-x64.tar.xz
     tar xf node-v14.7.0-linux-x64.tar
     mv node-v14.7.0-linux-x64 node
     Настройте системную переменную PATH, если хотите сохранить изменения, запишите их в системный или пользовательский файл переменных среды:

     export NODEPATH=/usr/local/src/node
     export PATH=$PATH:$NODEPATH/bin
   • установка через yum:

     yum install nodejs -y
   • загрузка через Docker:

     docker pull node:12.13.1

4. Скомпилируйте и упакуйте в образ:

   Перейдите в корневой каталог проекта:

   cd /app/wecmdb/we-cmdb
   make image PLUGIN_VERSION=v0.0.1

   Если при первой сборке npm front-end возникает ошибка «Error: EACCES: permission denied, mkdir '/app/wecmdb/we-cmdb/cmdb-ui/node_modules/node-sass/.node-gyp'», это означает, что у вас нет достаточных прав для установки пакета node-sass при выполнении команды от имени root. Необходимо выполнить следующую команду для установки node-sass:

   cd cmdb-ui
   npm install node-sass --unsafe-perm=true --allow-root
   npm install
   cd ..

   После установки выполните make image PLUGIN_VERSION=v0.0.1 для повторной установки. Просмотрите образ: