View a markdown version of this page

Beispiel: Dateien auf Amazon S3 veröffentlichen - Amazon CodeCatalyst

Amazon CodeCatalyst ist nicht mehr offen für neue Kunden. Bestandskunden können den Service weiterhin wie gewohnt nutzen. Weitere Informationen finden Sie unter Wie migriert man von CodeCatalyst.

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.

Beispiel: Dateien auf Amazon S3 veröffentlichen

Der folgende Beispiel-Workflow umfasst die Amazon S3-Veröffentlichungsaktion zusammen mit einer Build-Aktion. Der Workflow erstellt eine statische Dokumentationswebsite und veröffentlicht sie dann auf Amazon S3, wo sie gehostet wird. Der Workflow besteht aus den folgenden Bausteinen, die sequentiell ausgeführt werden:

  • Ein Trigger — Dieser Trigger startet den Workflow-Lauf, der automatisch ausgeführt wird, wenn Sie eine Änderung an Ihr Quell-Repository übertragen. Weitere Informationen zu Auslösern finden Sie unter Automatisches Starten einer Workflow-Ausführung mithilfe von Triggern.

  • Eine Build-Aktion (BuildDocs) — Beim Auslösen erstellt die Aktion eine statische Dokumentationswebsite (mkdocs build) und fügt die zugehörigen HTML-Dateien und unterstützenden Metadaten zu einem MyDocsSite aufgerufenen Artefakt hinzu. Weitere Informationen zur Build-Aktion finden Sie unterBauen mit Workflows.

  • Eine Amazon S3-Veröffentlichungsaktion (PublishToS3) — Nach Abschluss der Build-Aktion kopiert diese Aktion die Site im MyDocsSite Artefakt zum Hosting nach Amazon S3.

Anmerkung

Das folgende Workflow-Beispiel dient zur Veranschaulichung und funktioniert ohne zusätzliche Konfiguration nicht.

Anmerkung

Im folgenden YAML-Code können Sie den Connections: Abschnitt weglassen, wenn Sie möchten. Wenn Sie diesen Abschnitt weglassen, müssen Sie sicherstellen, dass die im Feld Standard-IAM-Rolle in Ihrer Umgebung angegebene Rolle die Berechtigungen und Vertrauensrichtlinien enthält, die für die Amazon S3-Veröffentlichungsaktion erforderlich sind. Weitere Informationen zum Einrichten einer Umgebung mit einer Standard-IAM-Rolle finden Sie unter. Erstellen einer Umgebung Weitere Informationen zu den Berechtigungen und Vertrauensrichtlinien, die für die Amazon S3-Veröffentlichungsaktion erforderlich sind, finden Sie in der Beschreibung der Role Eigenschaft im. Aktion „Amazon S3 veröffentlichen“ YAML

Name: codecatalyst-s3-publish-workflow
SchemaVersion: 1.0

Triggers:
  - Type: PUSH
    Branches:
      - main
Actions:
  BuildDocs:
    Identifier: aws/build@v1
    Inputs:
      Sources:
        - WorkflowSource
    Configuration:
      Steps:
        - Run: echo BuildDocs started on `date`
        - Run: pip install --upgrade pip
        - Run: pip install mkdocs
        - Run: mkdocs build
        - Run: echo BuildDocs completed on `date`
    Outputs:
      Artifacts:
      - Name: MyDocsSite
        Files:
          - "site/**/*"
        
  PublishToS3:
    Identifier: aws/s3-publish@v1
    Environment:
      Name: codecatalyst-s3-publish-environment
      Connections:
        - Name: codecatalyst-account-connection
          Role: codecatalyst-s3-publish-build-role
    Inputs:
      Sources:
        - WorkflowSource
      Artifacts:
        - MyDocsSite
    Configuration:      
      DestinationBucketName: amzn-s3-demo-bucket
      SourcePath: /artifacts/PublishToS3/MyDocSite/site
      TargetPath: my/docs/site