Alkalmazás telepítése git push segítségével

Hogyan jutnak el a kérések az alkalmazásához

visitor ──HTTPS:443──▶ NameOcean load balancer ──HTTP:80──▶ nginx ──▶ your app on 127.0.0.1:8000

A tanúsítványokat a terheléselosztó kezeli, így a szerver csak a 80-as porton szolgál ki. Az alkalmazása a supervisor alatt a 127.0.0.1:8000 címen figyel, az nginx pedig továbbítja neki a kéréseket.

1. Egy szerver és az Ön SSH-kulcsa

$ nameocean servers plans
$ nameocean servers create --plan starter --yes
$ nameocean servers ls
ID   NAME      STATUS   PLAN     DEFAULT DOMAIN          DOMAINS
812  3f9a1c2e  running  starter  3f9a1c2e.nameocean.org  -
$ nameocean servers ssh-keys add 3f9a1c2e

A szerver díját havonta számlázzuk; a servers create a --yes nélkül csak az árat mutatja meg. A szervert a Vezérlőpult → Tárhely menüpontban is létrehozhatja. Az ssh-keys add telepíti a ~/.ssh/id_ed25519.pub kulcsot, amelyet a git a pusholáshoz használ.

2. A projekt

import os

from flask import Flask

app = Flask(__name__)


@app.get("/")
def home():
    return f"Hello from {os.environ.get('SITE_NAME', 'NameOcean')}"

flask
gunicorn

#!/bin/bash
# runs on the server after every push, in /root/app, with your env variables
set -e
pip install -r requirements.txt

A deploy.sh fájlba kerülnek a build lépések: csomagok telepítése, migrációk, npm run build. Kimenete pusholáskor megjelenik a termináljában.

3. Első telepítés

$ git add . && git commit -m "First deploy"
$ nameocean deploy 3f9a1c2e

A nameocean deploy hozzáad egy nameocean nevű git remote-ot, a szerveren a /root/app könyvtárba pusholja az aktuális branchet (ettől kezdve a szerver ezt a branchet telepíti), pusholja a saját origin remote-jára is, majd újraindítja az alkalmazásokat.

4. Futtatás (egyszer)

Adja meg a supervisornak, hogyan indítsa az alkalmazást, az nginxnek pedig, hogy továbbítsa neki a kéréseket. Mindkét fájl megtalálható a szerveren, minden stackhez példákkal; csak ki kell vennie a megjegyzésből a megfelelő sorokat.

$ nameocean servers info 3f9a1c2e   # the ssh line
$ ssh -p 2152 root@3f9a1c2e.nameocean.org
# vi /root/conf/supervisor.conf   # uncomment the Flask [program:app] and the shared settings
# supervisorctl reread && supervisorctl update
# vi /root/conf/nginx.conf        # remove the static "location /", uncomment the proxy one
# nginx -t && systemctl reload nginx
# curl -s http://127.0.0.1/
Hello from NameOcean

A [program:app] Flask esetén:

[program:app]
command=/root/.pyenv/versions/app/bin/gunicorn app:app --workers 2 --bind 127.0.0.1:8000
directory=/root/app
environment=PATH="/root/.pyenv/versions/app/bin:/usr/local/bin:/usr/bin:/bin"
autostart=true
autorestart=true
redirect_stderr=true
stdout_logfile=/var/log/supervisor/app.log

Más stackeknél csak a command változik (a fájl ezeket a példákat is tartalmazza):

Az alkalmazása mostantól elérhető a https://3f9a1c2e.nameocean.org címen.

5. Beállítások és titkos adatok

$ nameocean servers env set 3f9a1c2e SITE_NAME=Kahvebot SECRET_KEY=…

Minden alkalmazás, a deploy.sh és minden SSH-munkamenet megkapja őket, az alkalmazások pedig újraindulnak, hogy beolvassák őket. Kizárólag a szerveren tárolódnak, soha nem a repositoryban vagy a NameOcean adatbázisában.

6. Az Ön domainje

$ nameocean bind kahvebot.com 3f9a1c2e

A domain DNS-ének a NameOceanen kell lennie. A NameOcean hozzáadja a DNS-rekordokat, kiállítja a tanúsítványt és beállítja a terheléselosztót (HTTP-ről HTTPS-re, valamint a csupasz domainről a www-re); ez általában néhány percet vesz igénybe. A szerveren semmi sem változik.

7. Minden további telepítés

$ git commit -am "New page"
$ nameocean deploy
$ nameocean servers logs 3f9a1c2e --app app -f   # if it does not come up

Minden telepítés küld egy server.deployed webhook eseményt a committal, és azzal, hogy az alkalmazások elindultak-e. Biztonsági mentések, újraindítások és az API többi része: App Server API. A szerveren a /root/AGENTS.md fájlban útmutató található az AI-ügynökök számára.