▲ PromNET

SÚGÓ › AI integráció

PromNET CLI használata

Telepítés, login PAT-tal, projekt- és domain-listázás, scriptelhető deploy-flow — minden parancssorból.

A PromNET CLI egy parancssori eszköz, amellyel scriptelhető módon tudod elérni a fiókod fontosabb erőforrásait: Cloud-projekteket, domain-eket, fiók-adatokat. A REST API-ra épül, ugyanazokat a Personal Access Token-eket (PAT) használja — csak nem kell minden hívást manuálisan curl-zni.

Telepítés

Globális npm-csomagként

npm install -g @promnet/cli

Ezután a promnet parancs bárhonnan elérhető a gépen:

promnet --version
# 1.0.0

npx-szel (telepítés nélkül)

Ha nem akarod globálisan telepíteni, vagy CI-ben futtatod:

npx @promnet/cli@latest --version

CI-ben a @latest helyett rögzített verziót ajánlunk (pl. @promnet/[email protected]), hogy egy upstream-frissítés ne törje el a build-et.

Rendszerkövetelmények

  • Node.js 18 vagy újabb (a fetch natívan kell)
  • macOS / Linux / Windows (PowerShell és WSL alatt is működik)

Bejelentkezés (promnet login)

A CLI-nek tudnia kell, melyik fiókodhoz csatlakozzon. Ehhez egy Personal Access Token (PAT) kell, amelyet a webes felületen generálsz.

1. PAT generálása

Nyisd meg a /app/api-tokens oldalt (a profilból is elérhető a “API tokenek” linken keresztül).

  1. Kattints “Új token generálása”
  2. Adj egy beszédes nevet — pl. cli-laptop-2026 vagy github-actions
  3. Válassz scope-okat ahhoz, amit használni fogsz:
    • account:read — promnet me parancshoz
    • cloud:read — promnet cloud list parancshoz
    • cloud:write — promnet cloud create parancshoz (amint elérhető)
    • domain:read — promnet domain list parancshoz
  4. Állíts lejáratot (30-90 nap) — ha a token leszivárog, magától elévül
  5. Kattints “Token generálása”
  6. Másold le a kapott promnet_pat_... stringet — ez csak egyszer látszik

2. Login parancs

A terminálban:

promnet login

A CLI rákérdez a tokenre — illeszd be a vágólapról. A token nem a shell-history-ba kerül, hanem a ~/.promnet/credentials fájlba (csak a te user-edre olvasható módban, chmod 600).

? PAT token: [paste]
✓ Bejelentkezve mint [email protected] (Pro plan)

Ha későbbi login-nál mást fiókkal próbálkozol, a parancs felülírja az előző token-t.

Alternatíva: környezeti változó

CI-ben vagy automatizált scriptekben kényelmesebb a PROMNET_TOKEN env-változó:

export PROMNET_TOKEN="promnet_pat_..."
promnet me

Ha az env be van állítva, a CLI a ~/.promnet/credentials helyett azt használja. GitHub Actions-ben a secrets.PROMNET_TOKEN a megfelelő hely.

Alapparancsok

promnet me — fiók-info

A bejelentkezett fiók adatai, a kvóta-felhasználás és az aktív előfizetés:

promnet me
[email protected]
Plan:           Cloud Pro
Cloud projects: 7 / 20
Domain:         3 / 10
Managed AI:     143 / 500 üzenet (jún 1-én nullázódik)
2FA:            on

promnet cloud list — projektek listája

promnet cloud list
SLUG          TEMPLATE   STATUS    LAST DEPLOY
landing       astro      live      2026-04-28 14:22
docs          astro      live      2026-04-25 09:11
prototype     html       building  2026-05-01 08:03

JSON-output (script-elhetőhöz):

promnet cloud list --json | jq '.[] | select(.status == "live") | .slug'

promnet cloud create — új projekt

promnet cloud create --slug uj-landing --template astro

A --slug egyedi lesz a fiókodban (3-30 karakter, kisbetű/szám/kötőjel), a --template a kezdő-csomag (astro, html, next-static).

A parancs visszaadja a projekt URL-jét és az API-feltöltési endpointot:

✓ Projekt létrehozva
  Slug:   uj-landing
  URL:    https://uj-landing.promnet.hu
  Deploy: promnet cloud deploy uj-landing ./dist

promnet domain list — domain-ek

promnet domain list
DOMAIN              REG. ÁLLAPOT  LEJÁRAT      DNS
example.hu          aktív         2027-03-15   PromNET
example.com         aktív         2026-11-08   Külső (Cloudflare)

Scriptelhető deploy-flow példa

Egy tipikus build-and-deploy script CI-ben:

#!/bin/bash
set -e

# 1. Build
npm ci
npm run build

# 2. Deploy a PromNET Cloud-ra
export PROMNET_TOKEN="$PROMNET_TOKEN_FROM_CI_SECRET"
promnet cloud deploy landing ./dist

# 3. Verify
URL=$(promnet cloud list --json | jq -r '.[] | select(.slug=="landing") | .url')
curl -fsSL "$URL" > /dev/null && echo "Deploy OK: $URL"

GitHub Actions ekvivalens:

name: Deploy to PromNET
on:
  push:
    branches: [main]

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with: { node-version: 20 }
      - run: npm ci && npm run build
      - run: npx @promnet/[email protected] cloud deploy landing ./dist
        env:
          PROMNET_TOKEN: ${{ secrets.PROMNET_TOKEN }}

Troubleshooting

401 Unauthorized belépéskor

A token érvénytelen, lejárt vagy visszavonva. Generálj újat a /app/api-tokens oldalon, és futtasd újra a promnet login parancsot.

403 Forbidden egy parancsnál

A token nem rendelkezik a parancs szükséges scope-jával. Pl. ha a tokened csak cloud:read-et tartalmaz, a promnet cloud create hibát fog dobni:

✗ Hiba: 403 — A token-nek nincs 'cloud:write' scope-ja
   Generálj új tokent a megfelelő jogosultságokkal: /app/api-tokens

Megoldás: új tokent generálsz a megfelelő scope-okkal (vagy az adott tokent szerkeszted, ha támogatott — jelenleg új token kell).

command not found: promnet

  • Ellenőrizd, hogy a globális npm-bin a PATH-ben van-e: npm config get prefix → <prefix>/bin-nek a PATH-ben kell lennie
  • WSL-en figyelj: a Windows-os Node és a WSL-Linux-os Node külön npm-prefix-szel rendelkezik
  • Ha minden kötél szakad: npx @promnet/cli@latest <parancs> mindig megy

ETIMEDOUT vagy ENOTFOUND

Hálózati gond — corporate proxy, VPN, vagy átmenetileg nem érhető el a promnet.hu API. A CLI tiszteletben tartja a HTTPS_PROXY env-változót:

export HTTPS_PROXY="http://proxy.cegedmegse.hu:8080"
promnet me

A token szivárgott — mit tegyek?

  1. Azonnal a /app/api-tokens oldalon kattints a token melletti “Visszavonás” gombra
  2. Generálj újat (más névvel, hogy lásd az audit-logban a különbséget)
  3. promnet login újra
  4. Ha publikus repo-ba commit-oltad, a git-history-ből is távolítsd el (git filter-repo vagy BFG)
  5. Ellenőrizd a last_used_at mezőt a régi token-nél — ha gyanús IP-ről jött kérés, jelezd az [email protected] címen

Verziófrissítés

npm update -g @promnet/cli
promnet --version

A CLI automatikusan figyelmeztet, ha új verzió érhető el (a parancs végén egy ↑ frissítés elérhető: 1.1.0 sor).

A CLI nem helyettesíti a webes UI-t — komplex feladatokhoz (Stripe-számlázás, DNS-rekord-szerkesztés, AI chatbot konfigurálás) maradj a dashboardnál. A CLI ott jó, ahol automatizálni akarsz: deploy-pipeline, monitoring-script, napi listázás.

← AI integráció Frissítve: 2026. 05. 01.