例: Amazon S3 にファイルを発行する

次のワークフローの例には、Amazon S3 公開アクションとビルドアクションが含まれています。ワークフローは静的ドキュメントウェブサイトを構築し、Amazon S3 に公開してホストします。ワークフローは、連続して実行される次の構成要素で構成されます。

• トリガー – このトリガーは、ソースリポジトリに変更をプッシュすると、ワークフローを自動的に開始します。トリガーについての詳細は、「トリガーを使用してワークフローを自動的に開始する」を参照してください。

• ビルドアクション (BuildDocs) – トリガー時に、アクションは静的ドキュメントウェブサイト (mkdocs build) を構築し、関連付けられたHTMLファイルとサポートメタデータを というアーティファクトに追加しますMyDocsSite。ビルドアクションの詳細については、「」を参照してくださいワークフローを使用した構築。

• Amazon S3 パブリッシュアクション (PublishToS3) – ビルドアクションが完了すると、このアクションはアーMyDocsSiteティファクト内のサイトをホスト用に Amazon S3 にコピーします。

注記

次のワークフロー例は説明を目的としており、追加の設定なしでは機能しません。

注記

次のYAMLコードでは、必要に応じて Connections:セクションを省略できます。このセクションを省略する場合は、環境のデフォルトロールフィールドに指定されたIAMロールに、Amazon S3 公開アクションに必要なアクセス許可と信頼ポリシーが含まれていることを確認する必要があります。デフォルトのIAMロールで環境を設定する方法の詳細については、「」を参照してください環境を作成する。Amazon S3 公開アクションに必要なアクセス許可と信頼ポリシーの詳細については、 のRoleプロパティの説明を参照してくださいAmazon S3 公開」アクション 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