View a markdown version of this page

Erstellen Sie einen Workflow - AWS Transfer Family
Konfigurieren Sie einen Workflow und führen Sie ihn ausWorkflow-Details anzeigen

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Erstellen Sie einen Workflow

Sie können einen verwalteten Workflow erstellen, indem Sie den verwenden AWS-Managementkonsole, wie in diesem Thema beschrieben. Um die Workflow-Erstellung so einfach wie möglich zu gestalten, sind für die meisten Abschnitte der Konsole kontextbezogene Hilfebereiche verfügbar.

Ein Workflow besteht aus zwei Arten von Schritten:

  • Nennschritte — Nennschritte sind Dateiverarbeitungsschritte, die Sie auf eingehende Dateien anwenden möchten. Wenn Sie mehr als einen nominalen Schritt auswählen, wird jeder Schritt in einer linearen Reihenfolge verarbeitet.

  • Exception-handling Schritte — Ausnahmebehandler sind Dateiverarbeitungsschritte, die AWS Transfer Family ausgeführt werden, falls nominale Schritte fehlschlagen oder zu Validierungsfehlern führen.

Erstellen Sie einen Arbeitsablauf

  1. Öffnen Sie die AWS Transfer Family Konsole unter https://console.aws.amazon.com/transfer/.

  2. Wählen Sie im linken Navigationsbereich Workflows aus.

  3. Wählen Sie auf der Seite Workflows die Option Workflow erstellen aus.

  4. Geben Sie auf der Seite „Workflow erstellen“ eine Beschreibung ein. Diese Beschreibung wird auf der Workflow-Seite angezeigt.

  5. Wählen Sie im Abschnitt Nominale Schritte die Option Schritt hinzufügen aus. Fügen Sie einen oder mehrere Schritte hinzu.

    1. Wählen Sie einen Schritttyp aus den verfügbaren Optionen aus. Weitere Informationen zu den verschiedenen Schritttypen finden Sie unterVerwenden Sie vordefinierte Schritte.

    2. Wählen Sie Weiter und konfigurieren Sie dann die Parameter für den Schritt.

    3. Wählen Sie Weiter und überprüfen Sie dann die Details für den Schritt.

    4. Wähle Schritt erstellen, um den Schritt hinzuzufügen und fortzufahren.

    5. Fügen Sie bei Bedarf weitere Schritte hinzu. Die maximale Anzahl von Schritten in einem Workflow ist 8.

    6. Nachdem Sie alle erforderlichen nominalen Schritte hinzugefügt haben, scrollen Sie nach unten zum Abschnitt Exception Handlers — optional und wählen Sie Add step aus.

      Anmerkung

      Damit Sie in Echtzeit über Fehler informiert werden, empfehlen wir Ihnen, Ausnahmebehandler und Schritte einzurichten, die ausgeführt werden, wenn Ihr Workflow fehlschlägt.

  6. Um Ausnahmebehandler zu konfigurieren, fügen Sie Schritte auf die gleiche Weise wie zuvor beschrieben hinzu. Wenn eine Datei dazu führt, dass ein Schritt eine Ausnahme auslöst, werden Ihre Ausnahmehandler nacheinander aufgerufen.

  7. (Optional) Scrollen Sie nach unten zum Abschnitt „Tags“ und fügen Sie Tags für Ihren Workflow hinzu.

  8. Überprüfen Sie die Konfiguration und wählen Sie Workflow erstellen.

    Wichtig

    Nachdem Sie einen Workflow erstellt haben, können Sie ihn nicht mehr bearbeiten. Überprüfen Sie die Konfiguration daher sorgfältig.

Konfigurieren Sie einen Workflow und führen Sie ihn aus

Bevor Sie einen Workflow ausführen können, müssen Sie ihn einem Transfer Family-Server zuordnen.

Um Transfer Family so zu konfigurieren, dass ein Workflow für hochgeladene Dateien ausgeführt wird

  1. Öffnen Sie die AWS Transfer Family Konsole unter https://console.aws.amazon.com/transfer/.

  2. Wählen Sie im linken Navigationsbereich Server aus.

    • Um den Workflow zu einem vorhandenen Server hinzuzufügen, wählen Sie den Server aus, den Sie für Ihren Workflow verwenden möchten.

    • Erstellen Sie alternativ einen neuen Server und fügen Sie ihm den Workflow hinzu. Weitere Informationen finden Sie unter Konfiguration eines SFTP-, FTPS- oder FTP-Serverendpunkts.

  3. Scrollen Sie auf der Detailseite für den Server nach unten zum Abschnitt Zusätzliche Details und wählen Sie dann Bearbeiten aus.

    Anmerkung

    Standardmäßig sind Servern keine Workflows zugeordnet. Sie verwenden den Abschnitt Zusätzliche Details, um dem ausgewählten Server einen Workflow zuzuordnen.

  4. Wählen Sie auf der Seite Zusätzliche Details bearbeiten im Abschnitt Verwaltete Workflows einen Workflow aus, der für alle Uploads ausgeführt werden soll.

    Anmerkung

    Wenn Sie noch keinen Workflow haben, wählen Sie Neuen Workflow erstellen, um einen zu erstellen.

    1. Wählen Sie die Workflow-ID, die Sie verwenden möchten.

    2. Wählen Sie eine Ausführungsrolle. Dies ist die Rolle, die Transfer Family bei der Ausführung der Workflow-Schritte einnimmt. Weitere Informationen finden Sie unter IAM-Richtlinien für Workflows. Wählen Sie Save (Speichern) aus.

    Der Bildschirm „Verwaltete Workflows“ mit Werten für den Workflow und die Ausführungsrolle.
Anmerkung

Wenn Sie nicht mehr möchten, dass ein Workflow dem Server zugeordnet wird, können Sie die Zuordnung entfernen. Details hierzu finden Sie unter Entfernen Sie einen Workflow von einem Transfer Family-Server.

Um einen Workflow auszuführen

Um einen Workflow auszuführen, laden Sie eine Datei auf einen Transfer Family-Server hoch, den Sie mit einem zugehörigen Workflow konfiguriert haben.

Anmerkung

Jedes Mal, wenn Sie einen Workflow von einem Server entfernen und durch einen neuen ersetzen oder die Serverkonfiguration aktualisieren (was sich auf die Ausführungsrolle eines Workflows auswirkt), müssen Sie ungefähr 10 Minuten warten, bevor Sie den neuen Workflow ausführen. Der Transfer Family-Server speichert die Workflow-Details im Cache, und es dauert 10 Minuten, bis der Server seinen Cache aktualisiert.

Darüber hinaus müssen Sie sich von allen aktiven SFTP-Sitzungen abmelden und sich nach Ablauf der 10-minütigen Wartezeit wieder anmelden, um die Änderungen zu sehen.

Beispiel
# Execute a workflow
> sftp bob@s-1234567890abcdef0.server.transfer.us-east-1.amazonaws.com

Connected to s-1234567890abcdef0.server.transfer.us-east-1.amazonaws.com.
sftp> put doc1.pdf
Uploading doc1.pdf to /amzn-s3-demo-bucket/home/users/bob/doc1.pdf
doc1.pdf                                                                    100% 5013KB 601.0KB/s   00:08    
sftp> exit
>

Nachdem Ihre Datei hochgeladen wurde, wird die definierte Aktion für Ihre Datei ausgeführt. Wenn Ihr Workflow beispielsweise einen Kopierschritt enthält, wird die Datei an den Speicherort kopiert, den Sie in diesem Schritt definiert haben. Sie können Amazon CloudWatch Logs verwenden, um die ausgeführten Schritte und ihren Ausführungsstatus zu verfolgen.

Workflow-Details anzeigen

Sie können Details zu zuvor erstellten Workflows oder zu Workflow-Ausführungen anzeigen. Um diese Details anzuzeigen, können Sie die Konsole oder die AWS Command Line Interface (AWS CLI) verwenden.

Console
Workflow-Details anzeigen

  1. Öffnen Sie die AWS Transfer Family Konsole unter https://console.aws.amazon.com/transfer/.

  2. Wählen Sie im linken Navigationsbereich Workflows aus.

  3. Wählen Sie auf der Seite Workflows einen Workflow aus.

    Die Seite mit den Workflow-Details wird geöffnet.

    Der Workflow-Detailbildschirm für einen Transfer Family-Workflow, auf dem die Beschreibung, die Schritte, die Ausnahmebehandler und die Ausführungen während des Fluges angezeigt werden.
CLI

Verwenden Sie den describe-workflow CLI-Befehl, um die Workflow-Details anzuzeigen, wie im folgenden Beispiel gezeigt. Ersetzen Sie die Workflow-ID w-1234567890abcdef0 durch Ihren eigenen Wert. Weitere Informationen finden Sie unter describe-workflow in der AWS CLI Befehlsreferenz. 

# View Workflow details
> aws transfer describe-workflow --workflow-id w-1234567890abcdef0
{
    "Workflow": {
        "Arn": "arn:aws:transfer:us-east-1:111122223333:workflow/w-1234567890abcdef0",
        "WorkflowId": "w-1234567890abcdef0",
        "Name": "Copy file to shared_files",
        "Steps": [
            {
                "Type": "COPY",
                "CopyStepDetails": {
                "Name": "Copy to shared",
                "FileLocation": {
                    "S3FileLocation": {
                        "Bucket": "amzn-s3-demo-bucket",
                        "Key": "home/shared_files/"
                    }
                }
                }
            }
        ],
        "OnException": {}
    }
}

Wenn Ihr Workflow als Teil eines AWS CloudFormation Stacks erstellt wurde, können Sie den Workflow mithilfe der CloudFormation Konsole () https://console.aws.amazon.com/cloudformation verwalten.

Der Bildschirm mit den Workflow-Details für einen Workflow, der Teil eines AWS CloudFormation Stacks ist, zeigt die Meldung an, in der Sie diesen Workflow verwalten CloudFormation.