Den blå pille: IP + port og service-fil

Velkommen til blue pill deployment.

Første gang du skal deploye din web applikation skal der lidt opsætning til. Når det er gjort, er det forholdsvis enkelt at gen-deploye en ny udgave af websitet. For at kunne overføre en web applikation til Dropletten skal vi igennem følgende trin (oversigt):

1. Lav en folder på din Droplet ( kald den webs), hvor java jar-filen skal lægge i.
2. Byg din applikation i IntelliJ ved hjælp af Maven til en såkaldt fat jar file
3. Kopier jar-filen til Dropletten
4. Lav en service fil, som kan bruges til at starte, genstarte og stoppe din applikation
5. Overfør din database til Droplettens Postgres (hvis den ikke allerede ligger der)
6. Start dit website

Herunder kommer detaljerne:

1. På din droplet og opret mappe

Log på remote som jetty brugeren og lav folderen ~/webs

2. På din lokale maskine (lav en fat jar)

For at kunne bygge en fat jar skal dette være til stede sidst i pom.xml:

 <build>
        <finalName>lifehack</finalName>

        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.10.1</version>
                <configuration>
                    <source>17</source>
                    <target>17</target>
                </configuration>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-shade-plugin</artifactId>
                <version>3.4.1</version>
                <configuration>
                    <transformers>
                        <transformer
                            implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                            <mainClass>app.Main</mainClass>
                        </transformer>
                    </transformers>
                    <filters>
                        <filter>
                            <artifact>*:*</artifact>
                            <excludes>
                                <exclude>META-INF/*.SF</exclude>
                                <exclude>META-INF/*.DSA</exclude>
                                <exclude>META-INF/*.RSA</exclude>
                            </excludes>
                        </filter>
                    </filters>
                </configuration>
                <executions>
                    <execution>
                        <phase>package</phase>
                        <goals>
                            <goal>shade</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>

• Byg projektet med maven package (i IntelliJ)
• Hop ned i target mappen og åbn en terminal

3. Kopier applikationen med secure copy

scp app.jar jetty@IP:~/webs/

Check på din Droplet at filen blev kopieret det rigtige sted hen.

4. Åbn for port 7070 i ufw

Dit Javalin website er konfigureret til at lytte på en bestemt port. Typisk i Main.class. Vi bruger normalt 7070, men hvis du vil hoste flere Javalin applikationer på Dropletten, så skal du køre på andre porte. F.eks. 7071, 7072 osv. Og de porte skal du også åbne for. Men i første omgang åbner vi bare for 7070:

sudo ufw allow 7070/tcp
sudo ufw status

5. Gør din applikation til en service på Dropletten

Log på remote igen. Du skal nu oprette en såkaldt service-fil ved navnet jettyapp eller hvad du ønsker at kalde den (cupcake, carport etc)

sudo nano /etc/systemd/system/jettyapp.service

Kopier denne konfiguration ind - og ret den til mht. , og hørende til dit projekt:

[Unit]
Description=Simple webapplication built in Java Javalin and running on Jetty
After=syslog.target network.target

[Service]
SuccessExitStatus=143

User=jetty
Group=sudo

Type=simple

Environment="JAVA_HOME=/usr/bin/java"
WorkingDirectory=/home/jetty/webs
ExecStart=/usr/bin/java -jar /home/jetty/webs/<appnavn>.jar
ExecStop=/bin/kill -15 $MAINPID

RestartSec=10
Restart=always

Environment="DEPLOYED=PROD"
Environment="JDBC_USER=postgres"
Environment="JDBC_PASSWORD=<dit-sikre-password>"
Environment="JDBC_CONNECTION_STRING=jdbc:postgresql://localhost:5432/%%s?currentSchema=public"
Environment="JDBC_DB=<dit_database_navn>"

[Install]
WantedBy=multi-user.target

Gem filen i Nano og gør service filen klar til brug:

sudo systemctl daemon-reload

Herefter kan du starte, gen-starte, stoppe og få en status på servicen således:

sudo service jettyapp start
sudo service jettyapp restart
sudo service jettyapp stop
sudo service jettyapp status

Hvis servicen fejler kan du se loggen med:

sudo journalctl -u jettyapp

Du skal selvfølgelig ændre jettyapp med det du har kaldt din service.

Hvis du har brug for at se log fra jetty, så brug:

sudo service jettyapp status

Du vil nok bemærke at applikationen ikke kører endnu. Det skyldes at vi mangler at migrere databasen.

6. Overfør din database til Dropletten - hvis den ikke allerede er der

• How to export and import a Postgres database

7. Vis dit website

Nu kan du tilgå dit website på http://ip:7070

Videre herfra

Du er sådan set færdig med oprettelse og konfiguration af din Droplet - og har fået deployet din web applikation. Måske er det tid til en kop kaffe?

• Hop tilbage til oversigten