So öffnen Sie .CWL-Dateien unter Linux
Um .CWL-Dateien unter Linux zu öffnen, installieren Sie einen CWL-Executor (normalerweise die cwltool-Referenzimplementierung), führen Sie ihn aus und führen Sie den Workflow/das Tool mithilfe der .cwl-Datei und der erforderlichen Eingabeobjektdatei aus.
Schritt-für-Schritt-Anleitung
- Installieren Sie einen CWL-Executor (normalerweise die cwltool-Referenzimplementierung), führen Sie ihn aus und führen Sie den Workflow/das Tool mithilfe der .cwl-Datei und der erforderlichen Eingabeobjektdatei aus.
- Öffnen Sie die .cwl-Datei in einem Texteditor, wenn Sie nur den YAML/JSON-Inhalt anzeigen oder bearbeiten möchten.
- Verwenden Sie die offizielle CWL-Implementierungsliste, um bei Bedarf einen alternativen Runner auszuwählen (z. B. wenn Sie andere Ausführungs-Backends benötigen).
Empfohlene Software
- VS Code
- Notepad++/TextEdit
- jq (CLI)
Alternative Methoden
- Open .CWL in a browser-based viewer if desktop apps fail.
- Try opening .CWL on Linux with a secondary app to rule out app-specific issues.
- Convert .CWL only with trusted tools when direct opening is not possible.
Häufige Probleme
Die .CWL-Datei wird als Text geöffnet, aber nicht „ausgeführt“.
Eine .cwl-Datei ist eine Workflow-/Tool-Beschreibung, kein eigenständiges Programm. Es muss von einem CWL-Läufer ausgeführt werden, normalerweise zusammen mit einer Eingabeobjektdatei und den erforderlichen Tools/Containern.
- Führen Sie die Datei mit einem CWL-Executor (z. B. der cwltool-Referenzimplementierung) aus, anstatt darauf zu doppelklicken.
- Prüfen Sie, ob der Workflow eine separate Eingabeparameterdatei (häufig YAML/JSON) erwartet und stellen Sie diese bei der Ausführung bereit.
- Stellen Sie sicher, dass die referenzierten Befehlszeilentools oder Container in Ihrer Umgebung verfügbar sind.
Runner meldet Validierungsfehler oder „nicht unterstützte CWL-Version“
CWL-Dokumente deklarieren eine CWL-Version und müssen der Spezifikation entsprechen; Ein Runner kann Dokumente ablehnen, die nicht dem erwarteten Schema oder der erwarteten Version entsprechen.
- Bestätigen Sie die CWL-Version des Dokuments und vergleichen Sie sie mit den unterstützten Versionen Ihres Läufers.
- Validieren Sie die Dokumentstruktur anhand der CWL-Spezifikation und korrigieren Sie fehlende/falsche Felder.
- Probieren Sie eine andere CWL-Implementierung aus der offiziellen Liste aus, wenn Ihr aktueller Executor die Funktionen des Dokuments nicht unterstützt.
Der Workflow wird gestartet, schlägt jedoch aufgrund fehlender Tools, Pfade oder Container fehl
CWL-Workflows rufen häufig externe Befehlszeilentools oder Container auf; Fehler treten auf, wenn Abhängigkeiten nicht vorhanden sind, nicht zugänglich sind oder von den Erwartungen des Workflows abweichen.
- Überprüfen Sie die Workflow-/Tool-Anforderungen und stellen Sie sicher, dass die erforderliche Software installiert oder über Container-Referenzen verfügbar ist.
- Überprüfen Sie Dateipfade und Eingabedateinamen in Ihrem Eingabeobjekt. Stellen Sie sicher, dass referenzierte Dateien vorhanden und lesbar sind.
- Führen Sie die Ausführung mit erhöhter Protokollierung in Ihrem Executor aus, um zu ermitteln, welcher Schritt fehlgeschlagen ist und warum, und passen Sie dann die Umgebung oder Eingaben entsprechend an.
Verwirrung bei der Dateizuordnung (wird in der falschen App geöffnet)
Betriebssysteme erkennen .cwl möglicherweise nicht als ausführbare Workflow-Beschreibung und öffnen sie mit einem Standardeditor oder einem nicht verwandten Programm.
- Öffnen Sie es explizit mit einem Texteditor zum Anzeigen oder mit Ihrem CWL-Runner über die Befehlszeile zur Ausführung.
- Vermeiden Sie es, die Erweiterung zu ändern; Installieren/konfigurieren Sie stattdessen einen CWL-Runner und verwenden Sie ihn zum Verarbeiten der Datei.
- Wenn Sie konsistentes Verhalten benötigen, dokumentieren Sie einen Standardläufer und -befehl für Ihr Team (z. B. mit cwltool).
Sicherheitshinweis
Behandeln Sie .cwl-Dateien als ausführbare Anweisungen: Durch das Ausführen eines CWL-Workflows können Befehlszeilentools ausgeführt und Dateien gelesen/geschrieben werden. Führen Sie daher Workflows nur von Quellen aus, denen Sie vertrauen.