Anpassbare Medienverarbeitungs-Workflows mit Transloadit

Ein anpassbarer Workflow sollte die wenigen Werte offenlegen, die sich pro Auftrag legitim ändern, und dabei seinen Verarbeitungsgraphen kontrolliert halten. Transloadits Assembly Instructions drücken diesen Graphen als benannte Steps aus, und ein gespeichertes Template ermöglicht es einer Anwendung, ihn wiederholt auszuführen, ohne Speicher-Zugangsdaten oder Transformationsrichtlinien erneut zu senden.

Worauf es besonders ankommt

• Verweisen Sie auf gespeicherte Template-Zugangsdaten, statt Cloud-Geheimnisse in Assembly Instructions zu hinterlegen.
• Erfassen Sie für jeden Durchlauf die Template-ID, das Anwendungs-Workflow-Label, die Assembly-ID, die Eingaben und das abschließende Ergebnis.

{
  "allow_steps_override": false,
  "max_number_of_files": 1,
  "max_size": 52428800,
  "notify_url": "https://app.example.com/webhooks/transloadit",
  "steps": {
    ":original": {
      "robot": "/upload/handle"
    },
    "accepted_images": {
      "use": ":original",
      "robot": "/file/filter",
      "accepts": [
        ["${file.mime}", "regex", "^(image/jpeg|image/png|image/webp|image/avif)$"]
      ],
      "error_on_decline": true,
      "error_msg": "Upload a JPEG, PNG, WebP, or AVIF image."
    },
    "web_image": {
      "use": "accepted_images",
      "robot": "/image/resize",
      "width": 1600,
      "height": 1200,
      "resize_strategy": "fit",
      "format": "webp"
    },
    "thumbnail": {
      "use": "accepted_images",
      "robot": "/image/resize",
      "width": 320,
      "height": 320,
      "resize_strategy": "fillcrop",
      "format": "webp"
    },
    "export_web": {
      "use": "web_image",
      "robot": "/s3/store",
      "acl": "private",
      "credentials": "media-output",
      "path": "${fields.tenant_id}/${assembly.id}/web/${unique_prefix}/${file.url_name}"
    },
    "export_thumb": {
      "use": "thumbnail",
      "robot": "/s3/store",
      "acl": "private",
      "credentials": "media-output",
      "path": "${fields.tenant_id}/${assembly.id}/thumb/${unique_prefix}/${file.url_name}"
    }
  }
}

// Illustrative fragment: these objects come from your application, not the SDK.
const assembly = await transloadit.createAssembly({
  files: { image: inputPath },
  params: {
    template_id: process.env.TRANSLOADIT_TEMPLATE_ID,
    fields: {
      tenant_id: tenant.id,
    },
  },
})

await jobs.attachAssembly({
  jobId: job.id,
  assemblyId: assembly.assembly_id,
})

Wissenswerte technische Details

• Ein dateibezogener Step beginnt, sobald ein vorgelagerter Step, der in seinem use-Wert genannt wird, eine Datei ausgibt; nur Merge- oder Bündelungs-Robots warten auf einen vollständigen Satz benannter Eingaben. Die Position eines Steps im JSON-Objekt bestimmt nicht die Ausführungsreihenfolge.
• Assembly Variables wie ${fields.tenant_id}, ${assembly.id} und ${file.url_name} – eine URL-sichere (per URL-Slug erzeugte) Version des Dateinamens der aktuellen Step-Datei einschließlich ihrer Dateierweiterung – werden zur Ausführungszeit aufgelöst und können Dimensionen, Pfade und andere Robot-Parameter-Werte parametrisieren. In den Beispiel-Exportpfaden sorgt ${assembly.id} für Eindeutigkeit je Lauf, und das slashhaltige ${unique_prefix} hält Dateien innerhalb eines Laufs unterscheidbar.
• Wenn allow_steps_override in einem gespeicherten Template auf false gesetzt ist, können Aufrufer keine Ersatz-Steps in dieses Template einfügen. Laufzeitfelder benötigen weiterhin eine anwendungsseitige Validierung und Autorisierung.
• /file/filter kann serverseitig erkannte Dateieigenschaften mit Array-Bedingungen vergleichen. Eine spezifische MIME-Positivliste ist sicherer, als sich auf eine Dateierweiterung oder einen vom Client gemeldeten Typ zu verlassen.
• Template-Zugangsdaten halten Zielgeheimnisse getrennt vom Template-JSON und können aktualisiert werden, ohne Schlüssel in jede Integration zu kopieren.
• Assembly Notifications werden erneut zugestellt, wenn der Empfänger nicht mit HTTP 200 antwortet. Konsumenten müssen die Signatur prüfen und doppelte, verzögerte oder nicht in Reihenfolge eintreffende Zustellungen tolerieren.

Ein praxisnaher Ansatz

Wann Transloadit hilfreich ist

Verwenden Sie ein gespeichertes Template, um /upload/handle, /file/filter, parallele /image/resize-Steps und /s3/store zu verbinden. Sperren Sie den Verarbeitungsgraphen, indem Sie allow_steps_override auf false setzen, übergeben Sie zur Laufzeit begrenzte Felder und gleichen Sie den Abschluss über Assembly Status und verifizierte Webhooks ab.

Architekturgrenze

Assembly Templates beschreiben die Verarbeitung und Bewegung von Dateien. Sie besitzen weder Produktfreigaben noch Mandantenautorisierung, Geschäftszustand oder die Konfigurationshistorie einer Anwendung; diese Entscheidungen bleiben in dem System, das jeden Auftrag startet und protokolliert.