知識庫 / Spring / Spring Boot RSS 訂閱

1. 概述

本文將探討如何以服務的方式運行 Spring Boot 應用程序的一些選項。

首先，我們將解釋 Web 應用程序的打包選項和系統服務。 在隨後的部分，我們將探索在 Linux 和 Windows 兩種系統上設置服務時，我們所擁有的各種替代方案。

最後，我們將提供一些額外信息來源的參考。

2. 項目設置與構建説明

This section provides instructions on how to set up your project and build the application.

Prerequisites

Before you begin, ensure you have the following installed:

• Java Development Kit (JDK) 8 or higher
• Maven 3.3 or higher
• A code editor or IDE (e.g., IntelliJ IDEA, Eclipse, VS Code)

Setting up the Project

1. Clone the project repository from GitHub.
2. Navigate to the project directory in your terminal.
3. Import the project into your IDE.

Building the Project

1. Open a terminal and navigate to the project directory.

2. Run the following Maven command to build the project:

   mvn clean install
   

   This command will compile the source code, run the unit tests, and package the application.

Understanding the Build Output

The build process will generate several artifacts, including:

• target/my-app-1.0.jar: The compiled application JAR file.
• target/my-app-1.0-sources.jar: The source code JAR file.
• target/my-app-1.0-test.jar: The test code JAR file.

You can deploy these artifacts to your desired environment.

2.1. 打包

Web 應用程序傳統上以 Web 應用程序歸檔 (WAR) 格式打包，並部署到 Web 服務器。

Spring Boot 應用程序可以打包為 WAR 文件和 JAR 文件。 後者將 Web 服務器嵌入到 JAR 文件中，從而允許您在無需安裝和配置應用程序服務器的情況下運行應用程序。

2.2 Maven 配置

讓我們首先定義我們的 pom.xml 文件的配置：

<packaging>jar</packaging>

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>1.4.0.RELEASE</version>
</parent>

<dependencies>
    ....
</dependencies>

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <configuration>
                <executable>true</executable>
            </configuration>
        </plugin>
    </plugins>
</build>

打包必須設置為 jar 格式。我們撰寫時正使用 Spring Boot 的最新穩定版本，但任何 1.3 版本及更高版本均可使用。有關可用版本的更多信息，請參閲 這裏。

請注意，我們已將 <executable> 參數設置為 true 用於 spring-boot-maven-plugin 插件。這確保了 MANIFEST.MF 文件被添加到 JAR 包中。此 manifest 包含一個 Main-Class 條目，它指定了您應用程序的主類。

2.3. 構建您的應用程序

在應用程序的根目錄下運行以下命令：

$ mvn clean package

可執行 JAR 文件現在位於 target 目錄下，可以通過在命令行中執行以下命令啓動應用程序：

$ java -jar your-app.jar

此時，您仍然需要使用 -jar 選項來調用 Java 解釋器。 能夠將應用程序作為服務啓動，遠比直接調用解釋器更可取，原因有很多。

3. 在 Linux

為了以後台進程的方式運行程序，我們可以簡單地使用 nohup Unix 命令，但這也不是首選方法，原因有很多。更詳細的解釋可以在這個 線程 中找到。

相反，我們將 daemonize 我們的進程。在 Linux 下，我們可以選擇使用傳統的 System V init 腳本或 Systemd 配置文件的方式來配置守護進程。前者傳統上最為人所知，但正在逐漸被後者所取代。

您可以在這裏找到關於兩者之間差異的更多信息 這裏。

為了增強安全性，我們首先創建一個特定用户來運行服務，並相應地更改可執行的 JAR 文件權限：

$ sudo useradd baeldung
$ sudo passwd baeldung
$ sudo chown baeldung:baeldung your-app.jar
$ sudo chmod 500 your-app.jar

3.1. System V Init

一個 Spring Boot 可執行 JAR 文件使得服務設置過程非常簡單：

$ sudo ln -s /path/to/your-app.jar /etc/init.d/your-app

上述命令會創建一個指向您可執行的 JAR 文件的符號鏈接。您必須使用您可執行 JAR 文件的完整路徑，否則符號鏈接將無法正常工作。此鏈接允許您以服務的方式啓動應用程序：

$ sudo service your-app start

腳本支持標準服務命令 、、 和 。 此外：

[Unit]
Description=A Spring Boot application
After=syslog.target

[Service]
User=baeldung
ExecStart=/path/to/your-app.jar SuccessExitStatus=143 

[Install] 
WantedBy=multi-user.target

# Place in /home/{user}/.config/upstart

description "Some Spring Boot application"

respawn # attempt service restart if stops abruptly

exec java -jar /path/to/your-app.jar

<service>
    <id>MyApp</id>
    <name>MyApp</name>
    <description>This runs Spring Boot as a Service.</description>
    <env name="MYAPP_HOME" value="%BASE%"/>
    <executable>java</executable>
    <arguments>-Xmx256m -jar "%BASE%\MyApp.jar"</arguments>
    <logmode>rotate</logmode>
</service>

$ MyApp.exe install