Deploying To Linux With Nginx

1. Install JRE: sudo apt install openjdk-11-jre-headless
2. Create a service file /etc/systemd/system/example.com.service and paste the following contents - note: if you used Cleaver to provision your server, the file exists but you will need to modify it accordingly

[Unit]
Description=example.com
After=network.target

[Service]
ExecStart=/usr/bin/java -jar example.jar
Restart=always
User=cleaver
Group=cleaver
Environment=PATH=/usr/bin:/usr/local/bin
WorkingDirectory=/home/cleaver/example.com

[Install]
WantedBy=multi-user.target

3. Create a nginx config file for your domain /etc/nginx/sites-available/example.com and paste the following - note: if the file already exists, you will need to make modifications accordingly

include cleaver-conf/example.com/header/*.conf;

map $http_upgrade $connection_upgrade {
    default upgrade;
    ''   '';
}

server {
    listen 443 ssl http2;
    listen [::]:443 ssl http2;

    include /etc/nginx/h5bp/directive-only/ssl.conf;
    include /etc/nginx/h5bp/directive-only/ssl-stapling.conf;

    ssl_certificate       /etc/nginx/ssl/example.com/fullchain.pem;
    ssl_certificate_key   /etc/nginx/ssl/example.com/privkey.pem;
    ssl_dhparam /etc/nginx/dhparams.pem;
    server_name example.com;

    charset utf-8;

    include cleaver-conf/example.com/*.conf;

    client_max_body_size 0;
    client_header_buffer_size 50M;
    proxy_read_timeout     1200;
    proxy_connect_timeout  240;

    access_log off;
    location = /favicon.ico { access_log off; log_not_found off; }
    location = /robots.txt  { access_log off; log_not_found off; }
    error_log /var/log/nginx/example.com-error.log error;

    location / {
        proxy_pass              http://localhost:9999;
        proxy_http_version      1.1;
        proxy_set_header        X-Forwarded-For $remote_addr;
        proxy_set_header        X-Forwarded-Proto      $scheme;
        proxy_set_header        X-Forwarded-Host       $http_host;
        proxy_set_header        Upgrade                $http_upgrade;
        proxy_set_header        Connection             $connection_upgrade;
    }

    root /home/cleaver/example.com/current;
    location ^~ /.well-known/acme-challenge/ {
        allow all;
    }
}

Make note of the port number 9999 above in proxy_pass http://localhost:9999;. You can change it to any random port number but you'll need this port number value in your .env file later.

4. Check to see if /etc/nginx/sites-enabled/example.com exists.

If not, you need to create a link pointing to the above config file we created by running: cd /etc/nginx/sites-enabled && ln -s ../sites-available/example.com .

5. Now you need to copy these files from your local project folder over to remote /home/cleaver/example.com folder:

You can use scp command to copy from your local machine to the remote server. This is how we'd copy an example.jar file (be sure to run alpas jar command in your project's root to create jar file):

scp -i ~/.ssh/cleaver/<private-ssh-key> ./example.jar cleaver@<server-ip>:/home/cleaver/example.com/

<private-ssh-key> is the private ssh key on your local machine that allows you to connect to the remote server.

6. Open /home/cleaver/example.com/.env file on the remote server and make few changes:

APP_PORT=<port-address-from-step-3>
APP_LEVEL=prod
APP_URL=example.com

7. Let's reload the service file: sudo systemctl daemon-reload.
8. Let's test nginx config to make sure everything is good: sudo service nginx configtest. If this says [ FAIL ], then something is wrong in your nginx config file. Don't proceed before fixing it.
9. If step 8 says [ OK ], then run sudo service nginx reload.
10. Let's restart the actual web app now sudo service example.com restart.

Give it a couple of seconds and your site should now be available at https://example.com.

1. To build the jar: ./alpas jar.
2. To copy the jar: scp -i ~/.ssh/cleaver/<private-ssh-key> ./example.jar cleaver@<server-ip>:/home/cleaver/example.com/.
3. To restart the server (from within the remote server and as a root user): sudo service example.com restart.