在 Koyeb 上部署 Spring Boot 应用程序

发布于2024-11-08

Deploying Spring Boot Applications on Koyeb

介绍

当我们作为开发人员开始构建东西时，我们的主要目标之一就是与他人分享我们所创建的内容。对于前端开发人员来说，这通常很简单，这要归功于 Vercel 和 Netlify 等出色的托管服务，它们无缝支持前端应用程序。然而，对于后端开发人员来说，展示我们的工作可能更具挑战性。我们构建 API，使用数据库，虽然 JSON 可能很强大，但它在视觉上不如使用 CSS 或 Lottie 构建的动画那么引人注目。

这就是为什么找到一种高效可靠的方式来部署后端应用程序至关重要。 Spring Boot 是一种流行的基于 Java 的框架，它简化了构建生产就绪应用程序的过程，但部署它们仍然是一个挑战。这就是 Koyeb 的用武之地。Koyeb 提供了一个强大且易于使用的平台，允许开发人员以最少的设置快速部署他们的 Spring Boot 应用程序。在本指南中，我们将引导您完成在 Koyeb 上部署带有 PostgreSQL 数据库的 Spring Boot 应用程序的整个过程，从开始到结束。

1. 前提条件

在我们深入部署过程之前，请确保您具备以下条件：

一个基本的 Spring Boot 应用程序。 如果您没有，您可以使用 Spring Initializr 快速生成一个具有以下依赖项的项目：
- Spring Web
- Spring Data JPA
- PostgreSQL 驱动程序
GitHub（或 GitLab/Bitbucket）存储库，托管 Spring Boot 项目的位置。
Neon 帐户。 在 Neon 注册
一个 Koyeb 帐户。 如果您没有 Koyeb 的网站，请注册。
已安装 Maven 或 Gradle，具体取决于您的 Spring Boot 项目的配置方式。

2. 设置数据库

在 Koyeb 上，实例化一个免费 PostgreSQL 数据库，它将提供数据库 URL 但每月仅限 50 小时。

-在 Neon 上，实例化一个免费 PostgreSQL 数据库，该数据库还将提供数据库 URL。

3.使用Spring boot连接数据库

在资源目录中，您将创建一个名为 env.properties 的文件，其中存储所有环境变量，在本例中为 DB_URL、DB_USERNAME 和 DB_PASSWORD。

永远不要提交这个文件到你的github的存储库。

env.properties 文件：

DB_USERNAME=
DB_PASSWORD=
DB_URL=

您的application.properties文件：

application.properties文件：

server.port=${PORT:8080}

spring.datasource.url=${DB_URL}
spring.datasource.username=${DB_USERNAME}
spring.datasource.password=${DB_PASSWORD}

spring.jpa.hibernate.ddl-auto=update

spring.config.import=classpath:env.properties

解释

server.port - 这是您的应用程序将运行的端口。我们设置了一个环境变量 PORT，如果 PORT 为空，则回退为 8080。
spring.datasource.url - 这是来自 Neon 或 Koyeb 仪表板的环境变量。
spring.datasource.username - 这是来自 Neon 或 Koyeb 仪表板的环境变量。
spring.datasource.password - 这是来自 Neon 或 Koyeb 仪表板的环境变量。
spring.config.import - 这将导入您存储敏感数据的文件。

4.创建system.properties文件

在项目的根目录下，创建一个system.properties文件。

此文件指定要使用的 Java 运行时版本，以便 Koyeb Java 构建包使用正确的版本执行项目。

记住：Koyeb 接受主要版本值 1.8、11、13、15、17、19 和 20。

如果不指定Java版本，版本1.8将被使用。

我正在使用Java 21。如果您使用的是其他版本，请相应更改。

系统属性

java.runtime.version=21

5. 创建控制器

此控制器将在 / 路由处显示 Hello World 消息。

package com.example.demo.Modules.User.controller;

import org.springframework.web.bind.annotation.RestController;

import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.GetMapping;

@RestController
public class UserController {

    @GetMapping("/")
    public String helloWorld() {
        return "Hello World";
    }

}