记录Microscope的安装过程

一、简述

 本文主要是介绍microscope的安装过程，以及安装过程中碰到的问题的记录

二、准备环境

 准备环境主要是准备安装microscope所需要node、npm、yarn等工具；

 1、安装node、npm、yarn

 在这里一定不要去node官网下载最新的包进行安装，不管是lts的nodev12还是最新的nodev14，在后面使用yarn的时候都会有各种问题’

# 下载node v10
cd /usr/local/src/
wget https://nodejs.org/dist/latest-v10.x/node-v10.22.0-linux-x64.tar.xz
# 解压
tar xf node-v10.22.0-linux-x64.tar.xz 
# 下面这个是个人习惯
mv node-v10.22.0-linux-x64 /usr/local/node
# 设置命令软链
ln -s /usr/local/node/bin/node /usr/bin/
ln -s /usr/local/node/bin/npm  /usr/bin/

 2、安装gcc等

 比较省事儿的做法就是下面这条命令，一劳永逸，如果网络慢的话，可以只安装gcc-c++这个试试。

yum install -y gcc*

 3、安装yarn

 安装yarn有很多种，源码编译等各种方式，我用下面的方式。

#安装yarn命令
npm install -g yarn
#设置命令软链，上面命令执行之后会在/usr/local/node/bin/下生成yarn的命令文件
ln -s /usr/local/node/bin/yarn /usr/bin/

 4、安装python3

 在这里，我表示怀疑是不是python3真的是必须的。先介绍下安装方式吧。

#先安装epel-relase
yum install -y epel-release
#安装python36
yum install python36
#查看是否安装成功
python3 --version

 5、安装git、wget命令

yum install -y git wget

三、安装microscope

 1、下载仓库

mkdir -pv /data
cd /data
#clone microscope源码
git clone https://github.com/citahub/microscope-v2/

 2、安装依赖

yarn install

这个地方要好好的说说碰到的问题了

• 如果安装node的时候，使用的是V12 版以上的版本，会出现gyp ERR! build error这种错误

 
gyp ERR! build error
gyp ERR! stack Error: `make` failed with exit code: 2

 在回显中会有类似上面的错误吧，这个没办法，只能降级到V10 以及以下的版本，推荐V10版本，因为我用的成功了

• 执行了install之后，可能会有一个提示，包含yarn upgrade字样，升级一下依赖包，这个执行就好了。

• 可能会碰到 make 的时候，提示有gcc的报错，可能是gcc安装的不是很完整，请使用一下命令

 yum install -y gcc*

 执行了之后，再去执行yarn install 和yarn upgrade命令

• 如果此处碰到关于python的报错，请使用一下命令

#修改默认python解释器为python3.6版本
rm -rf /usr/bin/python
ln -s /usr/bin/python3.6 /usr/bin/python

##此修改会影响yum命令安装包，如果要使用yum命令请使用一下命令恢复原python2.7
rm -rf /usr/bin/python
ln -s /usr/bin/python2.7 /usr/bin/python

3、调试环境

 使用下面命令检查调试 环境是否还是有问题

yarn start

 该命令执行之后，会打开只允许本地访问的端口，会有以下

看到上面图片中的内容，就表示调试没有问题，此事可以另开一个终端，访问curl 127.0.0.1:3000看能否访问到，我访问到的是下图内容，就表示调试没有问题，接下来打包

4、构建前端文件

yarn build

命令执行完成出现以下图片中内容

中间省略若干内容

进入目录“/data/microscope-v2/build”，能看到已经生成的前端文件

[root@ecs-965f build]# ls
bundle.css  bundle.js  favicon.ico  images  index.html  service-worker.js  webfonts

5、部署microscope前端文件

使用nginx提供web服务

# 安装nginx服务
yum install -y nginx

#将web文件放到nginx的默认web目录中，或者修改nginx配置文件也可以，方式多种。
rm -rf /usr/share/nginx/html/*
cp -a /data/microscope-v2/build/*  /usr/share/nginx/html/

# 为web文件赋权
chown -R nginx  /usr/share/nginx/html/*

#启动nginx，访问80端口
systemctl restart nginx