Zum Inhalt springen

Ironfang Rig

Testumgebungen für Integrationen

Echte E-Mails. Echte Callbacks.
Ihr Testlauf.

Geben Sie der getesteten Anwendung eine Außenwelt auf Zeit: ein frisches Postfach, eine öffentliche Callback-URL, einen Mock-Endpunkt und eine Route zu Ihrem Rechner, zugewiesen für einen Lauf, mit einer Aufzeichnung von allem, was dort ankam.

Keine Karte erforderlich. Eine Suite-Datei neben Ihrem Code, ein Lauf pro Test und Adressen, die in dem Moment abgeschaltet werden, in dem der Lauf endet.

Ironfang Rig / Zeitleiste des LaufsBeispielausgabe

Für diesen Lauf bereitgestellt

run-k7c3...@inbox.rig.ironfang.uk

hooks.rig.ironfang.uk/h/...

21 Ereignisse

lückenlos in Reihenfolge

  1. #5email.received
  2. #6callback.received
  3. #8connector.request.completed
  4. #16fault.injected
  5. #21connector.request.completed

Über einen ausgehenden Connector an Ihren Rechner weitergeleitet. Kein eingehender Port.

Lauf 01a0b9 / TTL 20 Min. 5 von 5 Erwartungen erfüllt

Alles, was ein Lauf erhält

Adressen, die für einen einzigen Lauf existieren

Eine Suite benennt die Identitäten, die eine Anwendung von der Außenwelt braucht. Jeder Lauf erhält neue, nicht erratbare und nur ihm zugeordnete Identitäten, die abgeschaltet werden, sobald der Lauf endet.

Ein echtes Postfach für jeden Lauf

Jeder Lauf erhält eine Adresse unter inbox.rig.ironfang.uk, die E-Mails von überall annimmt. Die Nachricht wird geparst, Betreff, Links und Einmalcodes werden für den Abgleich herausgelöst, und die Rohbytes werden als Nachweis aufbewahrt.

Öffentliche Callback-URLs

Registrieren Sie eine nicht erratbare URL beim Zahlungsanbieter, beim Versanddienstleister oder in Ihrer eigenen Warteschlange. Jede Anfrage wird mit Methode, Pfad, Body und einem Hash aufgezeichnet, und der Absender erhält sofort eine 200.

An Ihren Rechner weitergeleitet

Binden Sie einen Callback an ein Routen-Label und starten Sie ironfang rig connect neben der Anwendung. Anfragen erreichen einen lokalen Port über einen ausgehenden Socket, und die lokale Antwort wird aufgezeichnet. Kein eingehender Port, kein Tunnel zu konfigurieren.

Mock-HTTP-Endpunkte

Geordnete Regeln prüfen Methode, Pfad, Header und JSON-Felder und antworten mit Status, Body und Verzögerung Ihrer Wahl. Dieselbe Anfrage erhält jedes Mal dieselbe Antwort.

Störungen mit Absicht, und Wiederholung

Verzögern, duplizieren oder verwerfen Sie einen weitergeleiteten Callback, oder lassen Sie einen Mock mit einem gewählten Status antworten. Wiederholen Sie einen aufgezeichneten Callback, um Idempotenz nachzuweisen. Jedes Auslösen ist ein Ereignis neben dem, auf das es gewirkt hat.

Eine Zeitleiste, die Sie behalten können

Jede Beobachtung ist ein Ereignis mit lückenloser Sequenznummer. Warten Sie auf das nächste, bewerten Sie die Erwartungen am Ende und exportieren Sie den ganzen Lauf als ZIP mit einem Manifest der Hashes.

Suites bleiben bestehen. Läufe sind kurzlebig. Ressourcen haben eine ausdrückliche Lebensdauer.

Jede Ressource, jedes Ereignis und jede Grenze steht in der Dokumentation.

Suite als Code

Eine Datei neben dem Code. Ein Lauf pro Test.

Die Suite-Datei benennt die Identitäten, die die Anwendung braucht, und was ein Lauf beobachten muss. Die CLI synchronisiert sie, startet einen Lauf, übergibt die Adressen als Umgebungsvariablen an Ihren Testprozess und schließt den Lauf mit einer Bewertung ab, wenn der Prozess endet.

  1. Committen Sie ironfang.rig.yaml und führen Sie ironfang rig run -- npm test aus.
  2. Ihre Tests lesen die Adressen von Postfach, Callback und Mock aus der Umgebung.
  3. Warten Sie auf die Ereignisse, die Sie interessieren; wiederholen oder stören Sie gezielt.
  4. Die Erwartungen werden anhand der Zeitleiste bewertet, und der Exit-Code sagt bestanden oder fehlgeschlagen.
version: 1
project: acme-shop
suite: checkout
resources:
  customer_email:
    type: email
  stripe_callback:
    type: callback
    connector:
      route: stripe
expectations:
  - id: order_email
    resource: customer_email
    event: email.received
    match: { subject_contains: "Your order" }
  - id: stripe_forwarded
    resource: stripe_callback
    event: connector.request.completed
    match: { outcome: delivered, status: 200 }

Drei Zugänge

Aus dem Terminal, aus der CI oder von einem Assistenten

Dieselben Läufe, dieselbe Zeitleiste und dieselben Bewertungen, gleich auf welchem Weg der Lauf gestartet wird.

  1. Kommandozeile

    ironfang rig synchronisiert, startet Läufe, wartet, wiederholt und exportiert Nachweise. Eine einzelne statische Binärdatei für Linux, macOS und Windows, mit einer Prüfsummendatei pro Release.

  2. GitHub Actions

    ironfang-ltd/rig-action/start@v1 exportiert jede Adresse in den Job; finish@v1 gibt die Bewertungen aus und lässt den Schritt fehlschlagen, wenn der Lauf fehlschlägt.

  3. MCP-Tools

    19 Tools auf dem Ironfang MCP-Server, damit ein Coding-Agent einen Lauf starten, den lokalen Connector vorbereiten, auf der Zeitleiste warten und eine Störung scharf schalten kann, ohne den Editor zu verlassen.

Preise

In Ihrem Ironfang-Konto enthalten

Ironfang Rig ist in seiner ersten Version. Es gibt keinen eigenen Tarif und keine Kosten für Läufe, Ressourcen oder Ereignisse, innerhalb der dokumentierten Grenzen.

Was Sie brauchen

Einen Plattform-API-Schlüssel mit Rig-Berechtigungen, erstellt im Portal. Dasselbe Konto wie für die anderen Produkte.

Was begrenzt ist

Läufe dauern bis zu 24 Stunden; 32 Ressourcen und 64 Erwartungen pro Suite; 500 Nachrichten, 1.000 Callbacks und 5.000 Mock-Aufrufe pro Lauf.

Was als Nächstes kommt

Nutzungsbasierte Preise werden auf dieser Seite veröffentlicht, bevor irgendetwas berechnet wird. Nichts, was Sie gegen die API bauen, ändert sich dadurch.

Fragen

Was Ironfang Rig tut und was nicht

Führt Ironfang Rig meine Tests aus?
Nein. Es ist die Außenwelt, mit der Ihre Tests sprechen: die Adressen, die Aufzeichnung dessen, was dort ankam, und die Störungen, die Sie angefordert haben. Ihr Test-Runner, Ihre Assertions und Ihre Anwendung bleiben bei Ihnen, wo immer sie laufen.
Wie erreicht ein Callback eine Anwendung auf meinem Laptop?
Über ironfang rig connect, eine kleine Binärdatei, die sich über einen ausgehenden WebSocket mit einem für den Lauf erstellten Einmal-Token beim Gateway anmeldet. Die Plattform nennt immer nur ein Routen-Label; wohin das Label zeigt, legen Sie auf Ihrer Kommandozeile fest, und es verlässt Ihren Rechner nie.
Ist irgendetwas zufällig?
Nein. Störungen lösen bei der nächsten Beobachtung aus, auf die sie zutreffen, genau so oft, wie Sie es angefordert haben. Das Warten auf ein Ereignis liest zuerst die Zeitleiste, sodass dieselbe Zeitleiste und dieselbe Anfrage immer dasselbe Ereignis liefern. Zwei Läufe derselben Suite mit demselben Datenverkehr ergeben dieselben Bewertungen.
Was passiert danach mit den Daten?
Adressen nehmen nichts mehr an, sobald ein Lauf endet. Rohe Nachrichten- und Anfragebytes werden sieben Tage aufbewahrt, der Lauf mit seiner Zeitleiste neunzig Tage, danach werden sie gelöscht. Exportieren Sie vorher das Nachweispaket, wenn ein Lauf diese Frist überdauern muss.

Weniger betreiben. Mehr ausliefern.

Geben Sie Ihren Tests die Außenwelt.

Committen Sie eine Suite-Datei, starten Sie einen Lauf und sehen Sie zu, wie echte E-Mails und echte Callbacks auf einer Zeitleiste ankommen, die Sie behalten können.

Keine Karte erforderlich. Ironfang Rig zeichnet auf, was die zugewiesenen Adressen erreicht hat; es führt Ihre Tests nicht aus und untersucht Ihre Anwendung nicht.