Einführung

Wenn wir als Entwickler anfangen, Dinge zu entwickeln, ist es eines unserer Hauptziele, das, was wir erstellt haben, mit anderen zu teilen. Für Frontend-Entwickler ist dies dank großartiger Hosting-Dienste wie Vercel und Netlify, die Frontend-Apps nahtlos unterstützen, oft unkompliziert. Für Backend-Entwickler kann es jedoch eine größere Herausforderung sein, unsere Arbeit zu präsentieren. Wir erstellen APIs, arbeiten mit Datenbanken, und obwohl JSON leistungsstark sein mag, ist es optisch nicht so überzeugend wie eine mit CSS oder Lottie erstellte Animation.

Deshalb ist es von entscheidender Bedeutung, einen effizienten und zuverlässigen Weg zur Bereitstellung von Backend-Anwendungen zu finden. Spring Boot, ein beliebtes Java-basiertes Framework, vereinfacht den Prozess der Erstellung produktionsbereiter Anwendungen, ihre Bereitstellung kann jedoch immer noch eine Herausforderung sein. Hier kommt Koyeb ins Spiel. Koyeb bietet eine leistungsstarke und benutzerfreundliche Plattform, die es Entwicklern ermöglicht, ihre Spring Boot-Anwendungen schnell und mit minimalem Setup bereitzustellen. In diesem Leitfaden führen wir Sie von Anfang bis Ende durch den gesamten Prozess der Bereitstellung einer Spring Boot-Anwendung mit einer PostgreSQL-Datenbank auf Koyeb.

1. Voraussetzungen

Bevor wir mit dem Bereitstellungsprozess beginnen, stellen Sie sicher, dass Sie über Folgendes verfügen:

• Eine grundlegende Spring Boot-Anwendung. Wenn Sie noch keine haben, können Sie mit Spring Initializr schnell ein Projekt mit diesen Abhängigkeiten generieren:
  • Frühlingsnetz
  • Spring Data JPA
  • PostgreSQL-Treiber
• Ein GitHub- (oder GitLab/Bitbucket-) Repository, in dem Ihr Spring Boot-Projekt gehostet wird.
• Ein Neon-Konto. Melden Sie sich bei Neon an
• Ein Koyeb-Konto. Melden Sie sich auf der Website von Koyeb an, wenn Sie noch keins haben.
• Maven oder Gradle installiert, je nachdem, wie Ihr Spring Boot-Projekt konfiguriert ist.

2. Datenbank einrichten

• Instanziieren Sie auf Koyeb eine KOSTENLOSE PostgreSQL-Datenbank, die eine Datenbank-URL bereitstellt aber auf 50 Stunden pro Monat begrenzt ist.

– Instanziieren Sie auf Neon eine KOSTENLOSE PostgreSQL-Datenbank, die auch eine Datenbank-URL bereitstellt.

3. Datenbank mit Spring Boot verbinden

Im Ressourcenverzeichnis erstellen Sie eine Datei mit dem Namen env.properties. Darin werden alle Ihre Umgebungsvariablen gespeichert, in diesem Fall DB_URL, DB_USERNAME und DB_PASSWORD.

ÜBERTRAGEN SIE NIEMALS diese Datei in das Repository Ihres Githubs.

env.properties-Datei:

DB_USERNAME=
DB_PASSWORD=
DB_URL=

Ihre application.properties-Datei:

application.propertiesfile:

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

Erläuterung

• server.port – Dies ist der Port, auf dem Ihre Anwendung ausgeführt wird. Wir legen eine Umgebungsvariable PORT mit einem Fallback von 8080 fest, falls PORT null ist.
• spring.datasource.url – Dies ist eine Umgebungsvariable, die vom Neon- oder Koyeb-Dashboard stammt.
• spring.datasource.username – Dies ist eine Umgebungsvariable, die vom Neon- oder Koyeb-Dashboard stammt.
• spring.datasource.password – Dies ist eine Umgebungsvariable, die vom Neon- oder Koyeb-Dashboard stammt.
• spring.config.import – Dies importiert die Datei, in der Sie Ihre sensiblen Daten speichern.

4. Erstellen Sie eine system.properties-Datei

Erstellen Sie im Stammverzeichnis des Projekts eine system.properties-Datei.

Diese Datei gibt die zu verwendende Java-Laufzeitversion an, damit das Koyeb-Java-Buildpack das Projekt mit der richtigen Version ausführt.

Denken Sie daran: Koyeb akzeptiert die Hauptversionswerte 1.8, 11, 13, 15, 17, 19 und 20.

Wenn Sie keine Java-Version angeben, wird Version 1.8 verwendet.

Ich verwende Java 21. Wenn Sie eine andere Version verwenden, ändern Sie diese entsprechend.

system.properties

java.runtime.version=21

5. Erstellen Sie einen Controller

Dieser Controller zeigt die Hello World-Nachricht an der /-Route an.

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";
    }

}

6. Schieben Sie den Code auf Github

Erstellen Sie ein öffentliches Repository auf Github und pushen Sie Ihren Code. Besorgen Sie sich die URL dieses Repositorys.

7. Bereitstellung auf Koyeb

• Geben Sie Ihr Koyeb-Konto ein.
• Gehen Sie zu Dienste > Webdienste > Webdienste mit Github erstellen.
• Stellen Sie eine Verbindung zu Github her oder fügen Sie die URL des öffentlichen Repositorys ein.
• Warten Sie, bis das Projekt erstellt wurde.
• Bei Erfolg wird eine öffentliche URL generiert und jeder kann auf Ihre Spring Boot-Anwendung zugreifen.

Abschluss

Das ist es! Sie haben eine Spring Boot-Anwendung erstellt, sie mit einer Cloud-Datenbank verbunden und alles auf Koyeb bereitgestellt. Dies kann der Beginn eines Projekts sein, das Sie in Ihrem Portfolio präsentieren möchten, damit Kunden sehen können, was Sie tun können.

Sie können diese Anwendung mit einem Bild-Uploader-Artikel erweitern.

Danke fürs Lesen!

? Referenz

• Koyeb – Spring Boot-Bereitstellung
• Koyeb – Java-Referenz

? Sprechen Sie mit mir

• LinkedIn
• Github
• Portfolio