frontend-maven-plugin插件问题解决

1.插件介绍

frontend-maven-plugin为项目本地下载/安装Node和NPM，运行npm install命令 。

它适用于Windows，OS X和Linux。

这个插件也可以下载Node和Yarn，

然后运行yarn install你的项目。

使用这个插件目的：

• 让你的前端和后端版本尽可能分开，通过减少它们之间的交互量到最低限度; 仅使用1个插件。
• 让您在构建过程中使用Node.js及其库，而无需为构建系统全局安装Node / NPM
• 让您确保在每个构建环境中运行的Node和NPM的版本是相同的

2.插件使用示例

我所在的项目security-admin/pom.xml配置如下：

<plugin>
    <groupId>com.github.eirslett</groupId>
    <artifactId>frontend-maven-plugin</artifactId>
    <version>1.6</version>
    <configuration>
        <workingDirectory>${project.build.directory}</workingDirectory>
    </configuration>
    <executions>
        <execution>
            <phase>prepare-package</phase>
            <id>install node and npm</id>
            <goals>
                <goal>install-node-and-npm</goal>
            </goals>
            <configuration>
                <nodeVersion>v8.12.0</nodeVersion>
                <npmVersion>6.4.1</npmVersion>
            </configuration>
        </execution>
        <execution>
            <phase>prepare-package</phase>
            <id>npm install</id>
            <goals>
                <goal>npm</goal>
            </goals>
            <configuration>
                <arguments>install</arguments>
            </configuration>
        </execution>
    </executions>
</plugin>

3.离线环境打包问题解决方法

该插件在打包security-admin工程时，

要求联网下载文件，并且之后的npm需要连接远程仓库，

而我们的工程是在内网打包的，不能随意连接外网，

从而会导致打包失败。

使用的打包测试命令：

mvn package -pl security-admin -am -DskipTests

离线打包的解决方法有两种：

3.1.修改downloadRoot改变下载的地址，使用国内或者内网URL:

下载node-v8.12.0-linux-x64.tar.gz安装包，默认连接如下网址：

<!-- optional: where to download node and npm from. Defaults to https://nodejs.org/dist/ -->
<downloadRoot>https://nodejs.org/dist/</downloadRoot>
https://nodejs.org/dist/v8.12.0/node-v8.12.0-linux-x64.tar.gz

3.1.1.如果无法连接国外网址，可以使用国内淘宝的网址：

<downloadRoot>http://npm.taobao.org/mirrors/node/</downloadRoot>
http://npm.taobao.org/mirrors/node/v8.12.0/node-v8.12.0-linux-x64.tar.gz

downloadRoot的配置参考如下：

<execution>
    <phase>prepare-package</phase>
    <id>install node and npm</id>
    <goals>
        <goal>install-node-and-npm</goal>
    </goals>
    <configuration>
        <nodeVersion>v8.12.0</nodeVersion>
        <npmVersion>6.4.1</npmVersion>
        <downloadRoot>http://npm.taobao.org/mirrors/node/</downloadRoot>
    </configuration>
</execution>

注意downloadRoot不支持本地文件目录

3.1.2.如果国内网址也无法使用，只能连接内网

可以使用本地启动tomcat的方式，将要下载的安装包提前下好，

放到tomcat的webapp目录下，启动tomcat提供下载服务，

详细步骤请参考：
使用tomcat搭建HTTP文件下载服务器

然后将downloadRoot改为tomcat服务的路径，从tomcat下载相应的包，解决问题。

3.2.使用本地目录缓存，则不需要联网下载

查看打包过程发现如下日志：

[INFO] Downloading https://nodejs.org/dist/v8.12.0/node-v8.12.0-linux-x64.tar.gz to /home/maven/repository/com/github/eirslett/node/8.12.0/node-8.12.0-linux-x64.tar.gz

插件从指定网址下载node-v8.12.0-linux-x64.tar.gz下载文件到本地缓存目录后，

并且改名为node-8.12.0-linux-x64.tar.gz，

当每次开始编译时，插件会先查看缓存目录文件是否已经存在，

存在则不会重新下载，不存在才会去联网，

所有可以先从其他路径获取需要的安装包文件，

手动把node-v8.12.0-linux-x64.tar.gz放到对应的目录：

/home/maven/repository/com/github/eirslett/node/8.12.0/

具体操作如下：

下载安装包node-v8.12.0-linux-x64.tar.gz：
https://nodejs.org/dist/v8.12.0/node-v8.12.0-linux-x64.tar.gz

创建目录：

mkdir -p /home/maven/repository/com/github/eirslett/node/8.12.0/

上传安装包：

ftp node-v8.12.0-linux-x64.tar.gz /home/maven/repository/com/github/eirslett/node/8.12.0/

并且改名，去掉名字中的v：

mv node-v8.12.0-linux-x64.tar.gz node-8.12.0-linux-x64.tar.gz

上面需要的npm进行同样的操作即可：

[INFO] Downloading https://registry.npmjs.org/npm/-/npm-6.4.1.tgz to /home/maven/repository/com/github/eirslett/npm/6.4.1/npm-6.4.1.tar.gz
mkdir -p /home/maven/repository/com/github/eirslett/npm/6.4.1/
mv npm-6.4.1.tgz npm-6.4.1.tar.gz

3.3.npm使用内网的制品库作为远程仓库地址

在pom中插件的配置项中增加如下两个配置项：

vim security-admin/pom.xml

<npmRegistryURL>https://10.41.103.97:443/artifactory/api/npm/zenap-npm-virtual</npmRegistryURL>
<arguments>install --strict-ssl=false</arguments>

3.3.1.如果未 设置npmRegistryURL则会报如下错误，因为内网无法访问到外网远程仓库：

[INFO] --- frontend-maven-plugin:1.6:npm (npm install) @ security-admin-web ---
[INFO] Running 'npm install' in /home/compile/ranger/security-admin/target
[ERROR] npm ERR! code ENOTFOUND
[ERROR] npm ERR! errno ENOTFOUND
[ERROR] npm ERR! network request to https://registry.npmjs.org/requirejs failed, reason: getaddrinfo ENOTFOUND registry.npmjs.org registry.npmjs.org:443
[ERROR] npm ERR! network This is a problem related to network connectivity.
[ERROR] npm ERR! network In most cases you are behind a proxy or have bad network settings.
[ERROR] npm ERR! network
[ERROR] npm ERR! network If you are behind a proxy, please make sure that the
[ERROR] npm ERR! network 'proxy' config is set properly.  See: 'npm help config'
[ERROR]
[ERROR] npm ERR! A complete log of this run can be found in:
[ERROR] npm ERR!     /root/.npm/_logs/2018-10-15T08_23_03_167Z-debug.log
[INFO] -------------------------------------------------------------------

3.3.2.改为内网的仓库后，还是报错，无法解析返回的html文件：

17 http fetch GET 200 https://10.41.103.97:443/artifactory/public-npm-remote-cache/requirejs 64ms
18 silly fetchPackageMetaData error for requirejs@^2.3.6 Unexpected token < in JSON at position 0 while parsing near '<!DOCTYPE HTML PUBLI...'

查看淘宝的npm返回结果，返回的是一个json文件，里面记录了版本信息：
https://registry.npm.taobao.org/requirejs

查看资料后，发现如下URL会返回josn格式的结果：
https://10.41.103.97:443/artifactory/api/npm/zenap-npm-virtual/requirejs

所以npmRegistryURL配置如下：

<npmRegistryURL>https://10.41.103.97:443/artifactory/api/npm/zenap-npm-virtual</npmRegistryURL>

3.3.3.如果不配置设置strict-ssl为false，则打包时会报证书不存在错误：

23 verbose stack FetchError: request to https://10.41.103.97:443/artifactory/api/npm/zenap-npm-virtual/requirejs failed, reason: Hostname/IP doesn't match certificate's altnames: "IP: 10.41.103.97 is not in the cert's list: "

设置strict-ssl为false关闭强制SSL检查：

<arguments>install --strict-ssl=false</arguments>

实际上这个参数执行一次就会改变全局变量，

但是重复执行也没有问题，可以写入到pom中执行，

防止第一次编译的时候没有该配置项导致失败。