

Amazon CodeCatalyst는 더 이상 신규 고객에게 공개되지 않습니다. 기존 고객은 정상적으로 서비스를 계속 이용할 수 있습니다. 자세한 내용은 [CodeCatalyst에서 마이그레이션하는 방법](migration.md) 단원을 참조하십시오.

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

# universal-test-runner와 통합
<a name="test.universal-test-runner"></a>

테스트 작업은 오픈 소스 명령줄 도구인 `universal-test-runner`와 통합됩니다. `universal-test-runner`는 [테스트 실행 프로토콜](https://github.com/aws/universal-test-runner/blob/main/protocol/README.md)을 사용하여 주어진 프레임워크에서 모든 언어에 대한 테스트를 실행합니다. `universal-test-runner`는 다음 프레임워크를 지원합니다.
+ [Gradle](https://gradle.org/)
+ [Jest](https://jestjs.io/)
+ [Maven](https://maven.apache.org/)
+ [pytest](https://pytest.org)
+ [.NET](https://learn.microsoft.com/en-us/dotnet/core/tools/)

`universal-test-runner`는 테스트 동작을 위해 큐레이팅된 이미지에만 설치됩니다. 용자 지정 Docker Hub 또는 Amazon ECR을 사용하도록 테스트 동작을 구성하는 경우 고급 테스트 특성을 사용하려면 `universal-test-runner`를 수동으로 설치해야 합니다. 이렇게 하려면 이미지에 Node.js(14 이상)를 설치한 후 다음 쉘 명령 `- Run: npm install -g @aws/universal-test-runner`을 사용하여 `npm`을 통해 `universal-test-runner`를 설치합니다. 쉘 명령을 통해 컨테이너에 Node.js를 설치하는 방법에 대한 자세한 내용은 [Installing and Updating Node Version Manager](https://github.com/nvm-sh/nvm#install--update-script)를 참조하세요.

`universal-test-runner`에 대한 자세한 내용은 [What is universal-test-runner?](https://github.com/aws/universal-test-runner#-what-is-universal-test-runner) 섹션을 참조하세요.

------
#### [ Visual ]

**시각적 편집기에서 universal-test-runner 사용**

1. [https://codecatalyst.aws/](https://codecatalyst.aws/)에서 CodeCatalyst 콘솔을 엽니다.

1. 탐색 창에서 **CI/CD**를 선택한 다음 **워크플로**를 선택합니다.

1. 워크플로의 이름을 선택합니다.

1. **편집**을 선택합니다.

1. **비주얼**을 선택합니다.

1. **작업**을 선택합니다.

1. **작업**에서 **테스트**를 선택합니다.

1. **구성** 탭에서 지원되는 프레임워크를 선택하여 샘플 코드를 업데이트하여 **쉘 명령** 필드를 완료합니다. 예를 들어 지원되는 프레임워크를 사용하려면 다음과 유사한 `Run` 명령을 사용합니다.

   ```
   - Run: run-tests <framework>
   ```

   원하는 프레임워크가 지원되지 않는 경우 사용자 지정 어댑터 또는 러너를 제공하는 것이 좋습니다. **쉘 명령** 필드에 대한 설명은 [Steps](build-action-ref.md#build.configuration.steps) 섹션을 참조하세요.

1. (선택 사항) 커밋하기 전에 워크플로의 YAML 코드를 검증하려면 **검증**을 선택합니다.

1. **커밋**을 선택하고 커밋 메시지를 입력한 다음 **커밋**을 다시 선택합니다.

------
#### [ YAML ]

**YAML 편집기에서 universal-test-runner 사용**

1. [https://codecatalyst.aws/](https://codecatalyst.aws/)에서 CodeCatalyst 콘솔을 엽니다.

1. 탐색 창에서 **CI/CD**를 선택한 다음 **워크플로**를 선택합니다.

1. 워크플로의 이름을 선택합니다.

1. **편집**을 선택합니다.

1. **YAML**을 선택합니다.

1. **작업**을 선택합니다.

1. **작업**에서 **테스트**를 선택합니다.

1. 필요에 따라 YAML 코드를 수정합니다. 예를 들어 지원되는 프레임워크를 사용하려면 다음과 유사한 `Run` 명령을 사용합니다.

   ```
   Configuration:
     Steps:
       - Run: run-tests <framework>
   ```

   원하는 프레임워크가 지원되지 않는 경우 사용자 지정 어댑터 또는 러너를 제공하는 것이 좋습니다. **Steps** 속성에 대한 설명은 [Steps](build-action-ref.md#build.configuration.steps) 섹션을 참조하세요.

1. (선택 사항) 커밋하기 전에 워크플로의 YAML 코드를 검증하려면 **검증**을 선택합니다.

1. **커밋**을 선택하고 커밋 메시지를 입력한 다음 **커밋**을 다시 선택합니다.

------