Amplify 애플리케이션에 대한 엔드 투 엔드 Cypress 테스트 설정

Amplify 앱의 테스트 단계에서 엔드 투 엔드(E2E) 테스트를 실행하여 코드를 프로덕션으로 푸시하기 전에 회귀를 포착할 수 있습니다. 테스트 단계는 빌드 사양 YAML에서 구성할 수 있습니다. 현재는 빌드 중에 Cypress 테스트 프레임워크만 실행할 수 있습니다.

Cypress는 브라우저에서 E2E 테스트를 실행할 수 있는 JavaScript 기반 테스트 프레임워크입니다. E2E 테스트를 설정하는 방법을 설명하는 튜토리얼은 풀 스택 CI/CD 배포를 위해 Amplify를 통해 엔드 투 엔드 Cypress 테스트 실행하기 블로그 게시물을 참조하십시오.

기존 Amplify 애플리케이션에 Cypress 테스트 추가

Amplify 콘솔에서 앱의 빌드 설정을 업데이트하여 기존 앱에 Cypress 테스트를 추가할 수 있습니다. 빌드 사양 YAML에는 Amplify에서 빌드를 실행하는 데 사용할 빌드 명령 및 관련 설정 모음이 포함되어 있습니다. 이 test 단계를 사용하여 빌드 시 모든 테스트 명령을 실행할 수 있습니다. E2E 테스트의 경우 Amplify Hosting은 테스트용 UI 보고서를 생성할 수 있는 Cypress와의 긴밀한 통합을 제공합니다.

다음 목록에서는 테스트 설정 및 사용 방법에 대해 설명합니다.

빌드 사양 amplify.yml 파일에서 발췌한 다음 예시는 앱에 Cypress 테스트를 추가하는 방법을 설명합니다.

test:
  phases:
    preTest:
      commands:
        - npm ci
        - npm install -g pm2
        - npm install -g wait-on
        - npm install mocha mochawesome mochawesome-merge mochawesome-report-generator
        - pm2 start npm -- start
        - wait-on http://localhost:3000
    test:
      commands:
        - 'npx cypress run --reporter mochawesome --reporter-options "reportDir=cypress/report/mochawesome-report,overwrite=false,html=false,json=true,timestamp=mmddyyyy_HHMMss"'
    postTest:
      commands:
        - npx mochawesome-merge cypress/report/mochawesome-report/mochawesome*.json > cypress/report/mochawesome.json
        - pm2 kill
  artifacts:
    baseDirectory: cypress
    configFilePath: '**/mochawesome.json'
    files:
      - '**/*.png'
      - '**/*.mp4'

Amplify 애플리케이션 또는 브랜치에 대한 테스트 끄기

테스트 구성을 amplify.yml 빌드 설정에 추가한 후에는 모든 브랜치의 모든 빌드에 대해 test 단계가 실행됩니다. 테스트 실행을 전역적으로 비활성화하거나 특정 브랜치에 대한 테스트만 실행하려는 경우, 빌드 설정을 수정하는 대신 USER_DISABLE_TESTS 환경 변수를 사용할 수 있습니다.

모든 브랜치에 대한 테스트를 전역적으로 비활성화하려면 모든 브랜치에 대해 값이 true인 USER_DISABLE_TESTS 환경 변수를 추가합니다. 다음 스크린샷은 모든 브랜치에 대해 테스트가 비활성화된 Amplify 콘솔의 환경 변수 섹션을 나타냅니다.

특정 브랜치에 대한 테스트를 비활성화하려면 모든 브랜치에 대해 값이 false인 USER_DISABLE_TESTS 환경 변수를 추가한 다음, 비활성화하려는 각 브랜치에 대해 값이 true인 재정의를 추가합니다. 다음 스크린샷에서는 기본 브랜치에 테스트가 비활성화되고 다른 모든 브랜치에서는 활성화되어 있습니다.

이 변수를 사용하여 테스트를 비활성화하면 빌드 중에 테스트 단계를 완전히 건너뜁니다. 테스트를 다시 활성화하려면 이 값을 false로 설정하거나 환경 변수를 삭제합니다.