Vývojáři → Návody

Nasazení aplikace pomocí git push

NameOcean App Server je linuxový server s vaším projektem v git repozitáři. Vy pushnete, on spustí. Tento návod provede aplikaci ve Flasku od prvního pushe až na vlastní doménu s HTTPS; u Django, Node.js a Next.js se liší jediný řádek.

Jak se požadavky dostanou k vaší aplikaci

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

Certifikáty drží load balancer, takže server obsluhuje pouze port 80. Vaše aplikace naslouchá na 127.0.0.1:8000 pod supervisorem a nginx jí předává požadavky.

1. Server a váš SSH klíč

nameocean
$ 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

Server se účtuje měsíčně; servers create bez --yes pouze zobrazí cenu. Server můžete vytvořit také v Nástěnka → Hosting. ssh-keys add nainstaluje ~/.ssh/id_ed25519.pub, který git používá pro push.

2. Projekt

app.py
import os

from flask import Flask

app = Flask(__name__)


@app.get("/")
def home():
    return f"Hello from {os.environ.get('SITE_NAME', 'NameOcean')}"
requirements.txt
flask
gunicorn
.nameocean/deploy.sh
#!/bin/bash
# runs on the server after every push, in /root/app, with your env variables
set -e
pip install -r requirements.txt

Do deploy.sh patří kroky sestavení: instalace balíčků, migrace, npm run build. Jeho výstup se při pushi zobrazí ve vašem terminálu.

3. První nasazení

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

nameocean deploy přidá git remote s názvem nameocean, pushne aktuální větev do /root/app na serveru (server od té doby nasazuje tuto větev), pushne ji také do vašeho origin a restartuje aplikace.

4. Spuštění (jednorázově)

Řekněte supervisoru, jak aplikaci spustit, a nginx, aby jí předával požadavky. Oba soubory jsou na serveru s příklady pro každý stack; stačí odkomentovat.

ssh
$ 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

Sekce [program:app] pro Flask:

/root/conf/supervisor.conf
[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

U ostatních stacků se mění pouze command (příklady najdete i v souboru):

Django/root/.pyenv/versions/app/bin/gunicorn myproject.wsgi:application --workers 2 --bind 127.0.0.1:8000
FastAPI/root/.pyenv/versions/app/bin/uvicorn main:app --host 127.0.0.1 --port 8000 --workers 2
Node.js/usr/bin/node server.js s environment=NODE_ENV="production",PORT="8000",HOST="127.0.0.1"
Next.js/usr/bin/npx next start -H 127.0.0.1 -p 8000 a npm ci && npm run build v deploy.sh
Go/root/app/server a go build -o server . v deploy.sh

Vaše aplikace nyní běží na https://3f9a1c2e.nameocean.org.

5. Nastavení a tajné údaje

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

Dostane je každá aplikace, deploy.sh i SSH relace a aplikace se restartují, aby je načetly. Ukládají se pouze na serveru, nikdy v repozitáři ani v databázi NameOcean.

6. Vaše doména

nameocean
$ nameocean bind kahvebot.com 3f9a1c2e

DNS domény musí být u NameOcean. NameOcean přidá DNS záznamy, vystaví certifikát a nastaví load balancer (HTTP na HTTPS a holou doménu na www); obvykle to trvá několik minut. Na serveru se nic nemění.

7. Každé další nasazení

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

Každé nasazení odešle webhookovou událost server.deployed s commitem a informací, zda se aplikace spustily. Zálohy, restarty a zbytek API: App Server API. Na serveru najdete návod pro AI agenty v /root/AGENTS.md.