SpringBoot簡單打包部署(附工程)

時間 2019-11-29

原文原文鏈接

前言

本文主要介紹SpringBoot的一些打包事項和項目部署以及在其中遇到一些問題的解決方案。html

SpringBoot打包

在SpringBoot打包這塊，咱們就用以前的一個web項目來進行打包。首先須要明確的是，該項目打包的形態是可執行的jar包，仍是在tomcat下運行的war包。雖然本項目是用maven構建的，用maven打包也更加方便，可是這裏也說明普通非maven打包的項目如何打包。java

Maven打包

首先是maven方式打包: 若是是jar包需在pom.xml指定打成的包爲：git

<packaging>jar</packaging>  
複製代碼

若是是war包。需在pom.xml指定打成的包爲：github

<packaging>war</packaging>  
複製代碼

並經過<scope>標籤在打包的時候排除tomcat依賴web

<dependency>
	<groupId>org.springframework.boot</groupId>
	<artifactId>spring-boot-starter-tomcat</artifactId>
	<scope>provided</scope>
</dependency>
複製代碼

而後添加SpringBoot自帶的打包方式 示例以下:spring

<build>
		<defaultGoal>compile</defaultGoal>
		<sourceDirectory>src</sourceDirectory>
		<finalName>springboot-package</finalName>
		<plugins>
			<plugin>
				<groupId>org.springframework.boot</groupId>
				<artifactId>spring-boot-maven-plugin </artifactId>
				<configuration>
					<fork>true</fork>
					<mainClass>com.pancm.App</mainClass>
				</configuration>
				<executions>
					<execution>
						<goals>
							<goal>repackage</goal>
						</goals>
					</execution>
				</executions>
			</plugin>
		</plugins>
	</build>
複製代碼

注：<finalName>標籤是指定打包以後的名稱，<mainClass>是指定main函數。shell

也能夠不用SpringBoot自帶的打包方式，使用maven的assembly插件進行打包。 示例以下:apache

<build>
    <plugins>
		  <plugin>
            <groupId>org.apache.maven.plugins</groupId>  
            <artifactId>maven-assembly-plugin</artifactId>  
            <version>2.5.5</version>  
            <configuration>
                <archive>  
                    <manifest>  
                        <mainClass>com.pancm.App</mainClass>  
                    </manifest>  
                </archive>  
                <descriptorRefs>  
                    <descriptorRef>jar-with-dependencies</descriptorRef>  
                </descriptorRefs>  
            </configuration>  
        </plugin> 
       </plugins>
	</build> 
複製代碼

在pom.xml中添加完相應的標籤以後，咱們只需在項目同級（pom.xml同級）輸入tomcat

mvn clean package
複製代碼

便可完成打包若是想排除測試代碼，則能夠輸入:springboot

mvn clean package  -Dmaven.test.skip=true
複製代碼

來進行打包。

通常咱們是把application.properties和logback.xml文件放在resources文件夾中，可是進行打包以後，它們也會包含在jar或war包中，若是咱們想更改配置，則會比較麻煩。若是想將它們和項目放在同級目錄下，application.properties能夠直接移出和項目同級的目錄下，由於Spring程序會按優先級從下面這些路徑來加載application.properties配置文件：

springboot默認加載的logback是在classpath目錄下，這時咱們只須要在application.properties配置文件指定logback.xml的路徑便可。添加以下:

logging.config=logback.xml
複製代碼

若是引入了第三方的jar包，可是又沒法經過maven私服進行下載，這時能夠手動進行編譯。例如，我寫了一個工具類爲Mytools，而後把它打成了一個jar包，而後放在個人這個項目中lib目錄下，而且須要引用它，那麼此時即可以對該jar包進行編譯到本地倉庫中，而後再pom.xml添加相應的名稱和版本號。命令示例:

mvn install:install-file -Dfile=lib/pancmtools.jar -DgroupId=com.panncm.utils -DartifactId=pancm-utils -Dversion=1.0 -Dpackaging=jar
複製代碼

pom.xml添加

<dependency>
			<groupId>com.panncm.utils</groupId>
			<artifactId>pancm-utils</artifactId>
			<version>1.0</version>
</dependency>
複製代碼

即可以進行打包了。

普通項目打包

若是是普通的項目，沒有使用maven構建的話，可使用eclipse等工具進行打包。若是是jar包首先在eclipse中運行該項目(main方法運行)，而後在eclipse中右鍵項目 export ->java -> runnable jar file-> package required libraries into generated jar 指定main方法，而後選擇打包的名稱以及打包的路徑。點擊finish完成打包。

若是是war包在eclipse中右鍵項目 export ->web -> war file，而後選擇打包的名稱以及打包的路徑。點擊finish完成打包。

Ant打包

介紹了上述兩種打包以後，這裏介紹下經過ant方法進行打包(須要安裝ant環境，安裝方式基本和maven一致，指定路徑，配置環境變量，這裏就不在過多講述了)。通常打包以後，咱們須要將包和配置文件放在一個目錄下，這時咱們又不想手動進行復制粘貼的話，就能夠用ant來進行打包，將打包的文件整合在一塊兒。這裏咱們就編寫一個build.xml的配置文件。

<?xml version="1.0" encoding="UTF-8"?>
<project name="springboot-package" default="copyAll" basedir=".">
	<property name="build" value="build" />
	<property name="target" value="target" />
	<target name="clean">
		<delete dir="${target}" />
		<delete dir="${build}" />
	</target>

	<target name="create-path" depends="clean">
		<mkdir dir="${build}" />
	</target>

	<target name="mvn_package" depends="create-path">
		<exec executable="cmd" failonerror="true">
			<arg line="/c mvn install:install-file -Dfile=lib/pancmtools.jar -DgroupId=com.panncm.utils -DartifactId=pancm-utils -Dversion=1.0 -Dpackaging=jar" />
		</exec>
		<exec executable="cmd" failonerror="true">
			<arg line="/c mvn clean package" />
		</exec>
	</target>

	<target name="copyAll" depends="mvn_package">
		<copy todir="${build}" file="${target}/springboot-package.jar"></copy> 
		<copy todir="${build}" file="logback.xml"></copy>
		<copy todir="${build}" file="application.properties"></copy>
		<copy todir="${build}" file="run.bat"></copy>
	</target>
</project>
複製代碼

注：<mkdir dir="${build}" />是指定文件存放的文件夾，executable是使用cmd命令，line是執行的語句，標籤是將文件複製到指定的文件夾中。

而後再新建一個 build.bat文件，裏面只須要填寫 ant就好了。準備完以後，只需雙擊build.bat，項目和配置文件就自動到build文件中了，省去了不少操做。

雖然如今流行經過jenkins進行打包部署，不過使用ant加maven進行打包也不錯的，比較簡單。

SpringBoot部署

若是是jar項目 Windows系統在項目同級目錄下輸入:

java -jar springboot-package 
複製代碼

便可啓動項目。關閉項目，只需關掉dos界面就能夠了。也能夠寫一個bat文件進行運行。

Linux系統在項目同級目錄下輸入:

nohup -jar springboot-package &
複製代碼

便可啓動。關閉輸入:

kill -9 pid（jar的進程id）
複製代碼

也能夠在init.d註冊一個服務示例:

ln -s /home/jars/app/springboot-package.jar /etc/init.d/springboot-package
chmod +x /etc/init.d/springboot-package
複製代碼

而後輸入:

service springboot-package start|stop|restart
複製代碼

進行啓動或者中止。固然也能夠編寫xshell腳本進行啓動和關閉。

若是是war項目將war放在tomcat/webapp目錄下，而後啓動tomcat就能夠了。Windows系統在tomcat/bin目錄下雙擊startup.bat便可啓動，雙擊shutdown.bat關閉。 Linux系統則在tomcat/bin 目錄下輸入startup.sh便可啓動，輸入shutdown.sh關閉。