Ekzekutimi headless dhe integrimi i vazhdueshëm

Një skenar i ndërtuar brenda ndërfaqes ekzekutohet pa dritare nga rreshti i komandës. Kjo është rruga që i shndërron testet tuaja të API-ve në një hap të pipeline-it.

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

Botimi Pro

Ekzekutimi headless përfshihet në botimet Pro dhe Enterprise. Ai kërkon një token organizate, të dhënë në variablën e mjedisit RESTORM_TOKEN. Shihni Planet dhe aftësitë.

Argumentet

Argumenti	Roli
--open <path>, -o	Projekti që do të hapet. I detyrueshëm me --run
--run <target>	Skenari që do të ekzekutohet. Prania e tij aktivizon modalitetin e rreshtit të komandës
--by <name|id>	Si e tregon --run skenarin: me emër (parazgjedhje) ose me identifikues
--headless	Asnjë dritare. Pa të, dritarja shfaqet ndërsa regjistri rrëshqet në konsolë
--param name=value	Një vlerë për një parametër hyrës të skenarit (një kuti Input / Param). I përsëritshëm
--all-logs	Përfshin zërat e motorit; si parazgjedhje lëshohen vetëm ata të veprimit Log
--out <file>	E shkruan regjistrin edhe brenda një skedari, vazhdimisht
--clear-settings, -cls	Riinicializon preferencat përpara nisjes

Një --param i keqformuar (pa =) sinjalizohet në daljen e gabimit dhe shpërfillet. name= (vlerë bosh) pranohet.

Vlerat shndërrohen sipas tipit të deklaruar të parametrit — shihni Variablat dhe të dhënat.

--param synon hyrjet e skenarit, jo variablat e mjedisit

--param ushqen kutitë Input / Param të deklaruara brenda skenarit — ai nuk e ndryshon një variabël mjedisi. Kështu, --param status=available më sipër funksionon vetëm sepse skenari ekspozon një parametër hyrës me emrin status. Të duash ta mbivendosësh URL-në bazë me --param baseUrl=… nuk do të kishte asnjë efekt nëse baseUrl është një variabël mjedisi: një vlerë që jeton brenda një mjedisi nuk mund të mbivendoset nga rreshti i komandës. Që një vlerë e tillë të bëhet e drejtueshme nga CI-ja, ekspozojeni si parametër hyrës të skenarit (një kuti Input / Param) dhe kabllëzojeni aty ku ju nevojitet.

Kodet e daljes

Kodi	Kuptimi
0	Skenari përfundoi si duhet
1	Dështim, anulim, ose gabim i motorit
2	Caku nuk u gjet, skedari --out i paarritshëm, ose --run pa --open
3	E drejtë e refuzuar: RESTORM_TOKEN mungon, është i pavlefshëm ose i revokuar, plani është i pamjaftueshëm, ose pika e verifikimit është e paarritshme

Është pikërisht kjo konventë që e bën rezultatin drejtpërdrejt të përdorshëm nga një runner CI-je.

Dalja

Regjistri shkruhet në daljen standarde, një zë në një kohë, sapo prodhohet, në formën e një sekuence YAML:

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

Nivelet paraprihen nga një pastilë: ⚪ debug, 🔵 info, 🟠 warn, 🔴 error. Rreshtat nuk këputen kurrë — dalja mbetet e grep-ueshme. Gabimet nisen drejt daljes standarde të gabimeve.

Ky është saktësisht teksti që prodhon butoni «kopjo regjistrin» i ndërfaqes: i njëjti format nga të dyja anët.

Sekretet në CI

Përdorni burimin e sekreteve variabël mjedisi: sekreti injektohet nga arka e CI-së suaj, Restorm vetëm e lexon dhe asgjë nuk shkruhet brenda projektit. Shihni Sekretet.

Fiksoni versionin

Kanali i shkarkimit publikon skedarë të versionuar (restorm_<version>_amd64.deb): nuk ka asnjë alias latest. Fiksoni versionin brenda pipeline-it tuaj — kjo është gjithsesi ajo që duam në CI, që një version i ri të mos ndryshojë sjelljen e një pune pa rishikim. Emrat e saktë të skedarëve të versionit të fundit renditen në manifestin latest-linux.yml të të njëjtit kanal.

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' # versioni që doni të fiksoni
        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' # versioni që doni të fiksoni
  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]

Çfarë ndryshon në headless

• Veprimet Toast nuk bëjnë asgjë; ekzekutimi vazhdon normalisht.
• Parametrat nuk mund të kërkohen në mënyrë ndërvepruese: jepini të gjithë me --param, ose lërini të marrin vlerën e tyre të parazgjedhur.
• Serveri MCP nuk niset kurrë mbi një makinë pa ekran, cilido qoftë rregullimi.

Marrja e një token-i

Token-i RESTORM_TOKEN (me parashtesën rstk_) gjenerohet nga paneli i llogarisë suaj. Ai është i lidhur me organizatën, jo me një person: ky është token-i që vendoset në arkën e CI-së. Shihni Llogaritë dhe lidhja.