將檔案發佈到 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: my-bucket
      SourcePath: /artifacts/PublishToS3/MyDocSite/site
      TargetPath: my/docs/site