第四章、源码部署
如果项目中你想修改thingsboard的登录界面、表现图标等等内容，那么可以使用源码方式部署。
我们还是从一台刚安装好的假造机开始。
安装的服务器系统：Ubuntu 24.04 LTS
1、安装前预备
1.1、获取最新的软件包索引信息
1.2、安装Maven
ThingsBoard 编译必要 Maven 3.1.0+，因此先要安装Maven
- sudo apt-get install maven
- sudo apt install openjdk-17-jdk
- sudo update-alternatives --config java
这里我们选1让他使用17的版本。
查抄java版本
这样就对了
openjdk version "17.0.11" 2024-04-16
OpenJDK Runtime Environment (build 17.0.11+9-Ubuntu-1)
OpenJDK 64-Bit Server VM (build 17.0.11+9-Ubuntu-1, mixed mode, sharing)
2、下载源代码
2.1下载源代码
在ubuntu里去githab上克隆项目有点慢，不是很推荐，可以用有梯子的电脑去https://github.com/thingsboard/thingsboard下载，
或者使用我提供的3.7版本
thingsboard3.7源代码
下载后用终端工具里的sftp工具上传到你的用户目次中。（在第三章安装包部署里提过）
2.2解压代码
- sudo unzip thingsboard-3.7.zip
下面命令先安装unzip
然后再次运行解压缩代码
得到一个thingsboard-3.7的目次
进去看看
可以看到文件都存在了
4、在服务器上编译项目
thingsboard可以在你服务器上举行编译，你也可以在你的电脑上举行编译后在把文件复制到服务器上安装。这里先讲在服务器上直接举行编译。先决条件你要按开始装好maven和java。
忽然发现一个好方法，就是用
- mvn dependency:go-offline
4.1、更改maven镜像仓库
由于访问Maven默认连接的仓库位置在国外相当慢，maven下载的东西又多，编译过程极难完成。因此必须更改Maven的默认连接位置。
使用apt安装的maven，他的配置文件settings.xml在Ubuntu中的位置在/usr/share/maven/conf
修改他
- sudo vi /usr/share/maven/conf/settings.xml
按i进如编辑模式，把这一段改为
- <mirror>
- <id>nexus-aliyun</id>
- <mirrorOf>central</mirrorOf>
- <name>Nexus aliyun</name>
- <url>http://maven.aliyun.com/nexus/content/groups/public</url>
- </mirror>
4.2、编译项目
如果你对程序必要修改，那么你先做相关修改，修改后，再运行编译，我们这里先暂时跳过修改环节，反面再具体说。
回到我们之前的thingsboard解压的目次。
ls看一下目次内文件，确保有pom.xml文件
运行编译命令，-DskipTests参数意思是跳过编译过程中的测试阶段
- sudo mvn clean install -DskipTests
最大最大的就是网络！
好比这个gradle错误。Could not install Gradle distribution from 'https://services.gradle.org/distributions/gradle-7.3.3-bin.zip'.
[INFO] ------------------------------------------------------------------------
[INFO] BUILD FAILURE
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 10:06 min
[INFO] Finished at: 2024-07-12T02:41:43Z
[INFO] ------------------------------------------------------------------------
[ERROR] Failed to execute goal org.thingsboard:gradle-maven-plugin:1.0.12:invoke (default) on project http: org.gradle.tooling.GradleConnectionException: Could not install Gradle distribution from 'https://services.gradle.org/distributions/gradle-7.3.3-bin.zip'. -> [Help 1]
[ERROR]
[ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
[ERROR] Re-run Maven using the -X switch to enable full debug logging.
[ERROR]
[ERROR] For more information about the errors and possible solutions, please read the following articles:
[ERROR] [Help 1] http://cwiki.apache.org/confluence/display/MAVEN/MojoFailureException
[ERROR]
[ERROR] After correcting the problems, you can resume the build with the command
[ERROR] mvn <args> -rf org.thingsboard.transport:http
再好比：Could not download Yarn: Could not download https://github.com/yarnpkg/yarn/releases/download/v1.22.17/yarn-v1.22.17.tar.gz这个错误
都是因为网络的问题造成的。可以参考反面windows编译的小节，
你可以去手动下载这些包，然后放在相应的目次里来解决。但。。。
去折腾这些包，不如想办法把服务器去爬楼梯。反面我们在windows下面演示如何解决这些问题。
最好的方案就是把服务器挂在能爬梯的网络上，30分钟就能搞定！，至于方法大家只有各想办法了，不方便说哈。不外有时间还是要多试几次才能搞定。
另外我反面第五章提供各位一份干净的依靠库使用。也可以加速构建的速度。
常见的编译失败缘故起因除了网络问题，还有一下几点：
1、必须用sudo管理员身份运行mvn编译。
2、不要忘记安装java17，只支持java17的版本才能编译成功。
3、务必在thingboard目次中有pom.xml文件的目次中实行编译。
编译失败的话发起还是使用clean参数再次下载。
每次失败最好重新用clean参数清算做一次
1、
2、
- sudo mvn clean install -DskipTests
这里我们介绍在windows10下面对源码举行编译。
ps：因为想对thingsboard举行一些定制化开辟，所以研究了下windows下对其举行编译，下面是基础的部分，具体在编译过程中遇到的坑，会在下一章单独举行分析。
如果你对编译、定制无需求，可以跳过这一节和下一章。
5.1、安装OpenJDK
在我们之前安装包安装的时间OpenJDK的版本是17.0.11，windows我们也用这个版本。去微软下载靠谱一些。
下载地点：https://learn.microsoft.com/zh-cn/java/openjdk/download
选择你要的windows版本下载安装。
为了方便我把所有都选上了
安装完毕后务必重启！
5.2、安装Maven
去https://maven.apache.org/download.cgi下在最新的Maven，我这里是3.8.8，把内里的文件放在自己想放的目次里。我这里是放在 C:\maven 目次。
Maven – Download Apache Maven
5.2、编辑情况变量
先是系统变量添加一个
变量名：MAVEN_HOME
变量值：C:\maven
你们根据自己的情况设置变量值，这个目次下要包括bin、boot、conf、lib这些目次哦。
接下来是用户变量
新建一个
%MAVEN_HOME%\bin\
在命令行运行
MVN --version
表示安装成功！
5.3、更改maven镜像仓库
同在服务器上运行一样，必要吧maven仓库位置改一下，在你的maven目次下有个conf目次，内里有个settings.xml
找到下面这一段，大概在159行左右
把这一段改为
- <mirror>
- <id>nexus-aliyun</id>
- <mirrorOf>central</mirrorOf>
- <name>Nexus aliyun</name>
- <url>http://maven.aliyun.com/nexus/content/groups/public</url>
- </mirror>
5.3、安装git
构建过程必要用到git，去官网下载安装
https://git-scm.com/downloads
5.4、编译项目
用管理员权限运行命令提示行
输入：
- mvn clean install -DskipTests
由于大部分情况是网络问题，因此常见的解决错误思绪是单独去下载这个文件，然后复制到对应的目的位置，再重新编译一次。
在重新编译前，发起单独清算一下之前的缓存。
然后再开始新的编译
- mvn clean install -DskipTests
5.5.1、gradle分发包错误
收到下面这个错误
[ERROR] Failed to execute goal org.thingsboard:gradle-maven-plugin:1.0.12:invoke (default) on project http: org.gradle.tooling.GradleConnectionException: Could not install Gradle distribution from 'https://services.gradle.org/distributions/gradle-7.3.3-bin.zip'. -> [Help 1]
这是gradle分发包下载出错了
看一下错误信息
手动下载gradle
https://services.gradle.org/distributions/gradle-7.3.3-bin.zip
找到上面图片表现的路径 ，把这个手动下载的文件复制到这个目次中去。
然后再次运行编译
mvn clean install -DskipTests
5.5.2、Yarn安装错误
收到下面这个错误
Failed to execute goal com.github.eirslett:frontend-maven-plugin:1.12.0:install-node-and-yarn (install node and npm) on project ui-ngx: Could not extract the Yarn archive: Could not extract archive: 'C:\Users\Administrator\.m2\repository\com\github\eirslett\yarn\1.22.17\yarn-1.22.17.tar.gz'
错误说的很具体，解压文件失败，我们去C:\Users\Administrator\.m2\repository\com\github\eirslett\yarn\1.22.17这个目次看看，发现啥也没有，
同上去下载这个yarn-1.22.17.tar.gz复制到C:\Users\Administrator\.m2\repository\com\github\eirslett\yarn\1.22.17
这个目次中去。
重要：
修改名字为：yarn-1.22.17.tar.gz
这里给出下载链接
https://github.com/yarnpkg/yarn/releases/tag/v1.22.17
5.5.3、缺少预期的许可证头
错误信息（你大概收到的不止一个这样的错误，一一改正）
Failed to execute goal com.mycila:license-maven-plugin:3.0:check (default) on project util: Some files do not have the expected license header -> [Help 1]
org.apache.maven.lifecycle.LifecycleExecutionException: Failed to execute goal com.mycila:license-maven-plugin:3.0:check (default) on project util: Some files do not have the expected license header
这个错误表明有些文件缺少预期的许可证头。为了修复这个问题，你必要确保所有文件都包含正确的许可证头。
必要找出哪些文件缺少许可证头。
我们这里是C:/Users/Administrator/Desktop/thingsboard-3.7/common/util/bin/src/test/resources/logback-test.xml
打开这个文件，将下面license头加到文件开头。
- <!--
- Copyright © 2016-2024 The Thingsboard Authors
- Licensed under the Apache License, Version 2.0 (the "License");
- you may not use this file except in compliance with the License.
- You may obtain a copy of the License at
- http://www.apache.org/licenses/LICENSE-2.0
- Unless required by applicable law or agreed to in writing, software
- distributed under the License is distributed on an "AS IS" BASIS,
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- See the License for the specific language governing permissions and
- limitations under the License.
- -->
5.5.4、yarn install错误
[ERROR] Failed to execute goal com.github.eirslett:frontend-maven-plugin:1.12.0:yarn (yarn install) on project ui-ngx: Failed to run task: 'yarn install --non-interactive --network-concurrency 4 --network-timeout 100000 --mutex network' failed. org.apache.commons.exec.ExecuteException: Process exited with an error: 1 (Exit value: 1) -> [Help 1]
这是网络问题造成的，我们看看出错的地方
去下载git安装即可
Git for Windows
记得重启后再次编译
5.5.5、总结
大部分的问题还是网络造成的，因此搭建一个好的梯子相当重要。如果过程中发生错误，那么第一看缘故起因，缺啥文件，不能下载利市动下载，能下载就多试几次。总体过程是痛楚的。
6、编译成功后的事
不管在ubuntu和window中编译，成功后在thingsboard目次的application目次下会有个target目次
内里包含了Ubuntu的thingsboard.deb安装包
包含了thingsboard-windows的安装包
还有thingsboard.rpm安装包
可以根据必要选择安装
具体安装我们在之前第三章已经讲过了。
按照之前的把相关依靠、情况装好，再安装即可。
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。 |
