Rulare headless și integrare continuă

Un scenariu construit în interfață se execută fără fereastră din linia de comandă. Este calea care vă transformă testele de API într-o etapă de pipeline.

restorm \
  --open ./projet.restorm \
  --run "Find pets by status" \
  --headless \
  --param status=available

Ediția Pro

Rularea headless este inclusă în edițiile Pro și Enterprise. Necesită un token de organizație, furnizat în variabila de mediu RESTORM_TOKEN. Vedeți Planuri și capacități.

Argumentele

Argument	Rol
--open <path>, -o	Proiectul de deschis. Obligatoriu împreună cu --run
--run <target>	Scenariul de rulat. Prezența sa activează modul linie de comandă
--by <name|id>	Cum desemnează --run scenariul: după nume (implicit) sau după identificator
--headless	Nicio fereastră. Fără el, fereastra se afișează în timp ce jurnalul defilează în consolă
--param name=value	O valoare pentru un parametru de intrare al scenariului (o cutie Input / Param). Se poate repeta
--all-logs	Include intrările motorului; implicit sunt emise numai cele ale acțiunii Log
--out <file>	Scrie jurnalul și într-un fișier, pe măsură ce se produce
--clear-settings, -cls	Resetează preferințele înainte de lansare

Un --param prost format (fără =) este semnalat la ieșirea de eroare și ignorat. name= (valoare vidă) este acceptat.

Valorile sunt convertite în funcție de tipul declarat al parametrului — vedeți Variabile și date.

--param vizează intrările scenariului, nu variabilele de mediu

--param alimentează cutiile Input / Param declarate în scenariu — el nu modifică o variabilă de mediu. Astfel, --param status=available de mai sus funcționează doar pentru că scenariul expune un parametru de intrare numit status. Dorința de a suprascrie URL-ul de bază cu --param baseUrl=… nu ar avea niciun efect dacă baseUrl este o variabilă de mediu: o valoare care trăiește într-un mediu nu poate fi suprascrisă din linia de comandă. Pentru a face o astfel de valoare controlabilă din CI, expuneți-o ca parametru de intrare al scenariului (o cutie Input / Param) și cablați-o acolo unde aveți nevoie de ea.

Codurile de ieșire

Cod	Semnificație
0	Scenariul s-a încheiat corect
1	Eșec, anulare sau eroare a motorului
2	Țintă negăsită, fișier --out inaccesibil sau --run fără --open
3	Drept refuzat: RESTORM_TOKEN absent, invalid sau revocat, plan insuficient ori punct de verificare inaccesibil

Această convenție este cea care face rezultatul direct utilizabil de un runner de CI.

Ieșirea

Jurnalul este scris la ieșirea standard, o intrare pe rând, de îndată ce este produsă, sub forma unei secvențe YAML:

- message: "🔵 [2026-07-29 10:30:00.123] Commande créée"
  data: { id: 4271 }

Nivelurile sunt prefixate cu o pastilă: ⚪ debug, 🔵 info, 🟠 warn, 🔴 error. Liniile nu sunt niciodată tăiate — ieșirea rămâne grep-abilă. Erorile pleacă la ieșirea de eroare standard.

Este exact textul pe care îl produce butonul „copiază jurnalul” din interfață: același format de ambele părți.

Secretele în CI

Folosiți sursa de secret variabilă de mediu: secretul este injectat de seiful sistemului dumneavoastră de CI, Restorm nu face decât să îl citească și nimic nu este scris în proiect. Vedeți Secrete.

Fixați versiunea

Canalul de descărcare publică fișiere versionate (restorm_<version>_amd64.deb): nu există un alias latest. Fixați versiunea în pipeline-ul dumneavoastră — oricum, asta se dorește în CI, pentru ca o versiune nouă să nu schimbe comportamentul unui job fără revizuire. Numele exacte ale fișierelor ultimei versiuni sunt listate în manifestul latest-linux.yml al aceluiași canal.

GitHub Actions

name: Tests d'API
on: [push]

jobs:
  api:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Installer Restorm
        env:
          RESTORM_VERSION: '1.4.2' # versiunea pe care doriți să o fixați
        run: |
          curl -sSL -o restorm.deb \
            "https://dl.restorm.app/restorm_${RESTORM_VERSION}_amd64.deb"
          sudo apt-get install -y ./restorm.deb

      - name: Exécuter les tests de fumée
        env:
          RESTORM_TOKEN: ${{ secrets.RESTORM_TOKEN }}
          API_TOKEN: ${{ secrets.API_TOKEN }}
        run: |
          xvfb-run -a restorm \
            --open ./api.restorm \
            --run "Find pets by status" \
            --headless \
            --all-logs \
            --out run.log \
            --param status=available

      - name: Publier le journal
        if: always()
        uses: actions/upload-artifact@v4
        with:
          name: journal-restorm
          path: run.log

GitLab CI

tests-api:
  image: ubuntu:24.04
  variables:
    RESTORM_TOKEN: $RESTORM_TOKEN
    RESTORM_VERSION: '1.4.2' # versiunea pe care doriți să o fixați
  before_script:
    - apt-get update && apt-get install -y curl xvfb
    - curl -sSL -o restorm.deb "https://dl.restorm.app/restorm_${RESTORM_VERSION}_amd64.deb"
    - apt-get install -y ./restorm.deb
  script:
    - >
      xvfb-run -a restorm
      --open ./api.restorm
      --run "Find pets by status"
      --headless --all-logs --out run.log
      --param status=$PET_STATUS
  artifacts:
    when: always
    paths: [run.log]

Ce se schimbă în mod headless

• Acțiunile Toast nu fac nimic; execuția continuă normal.
• Parametrii nu pot fi ceruți interactiv: furnizați-i pe toți cu --param sau lăsați-i să își ia valoarea implicită.
• Serverul MCP nu pornește niciodată pe o mașină fără afișaj, oricare ar fi setarea.

Obținerea unui token

Tokenul RESTORM_TOKEN (prefixat cu rstk_) se generează din tabloul de bord al contului dumneavoastră. Este atașat organizației, nu unei persoane: este tokenul care se pune în seiful sistemului de CI. Vedeți Conturi și conectare.