예시: Amazon S3에 파일 게시 - Amazon CodeCatalyst

Amazon CodeCatalyst는 2025년 11월 7일부터 신규 고객에게 더 이상 공개되지 않습니다. 서비스를 사용하려면 2025년 11월 7일 이전에 가입하세요. 자세한 내용은 CodeCatalyst에서 마이그레이션하는 방법 단원을 참조하십시오.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

예시: 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 게시 작업에 필요한 권한 및 신뢰 정책에 대한 자세한 내용은 'Amazon S3 게시' 작업 YAML의 Role 속성 설명을 참조하세요.

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