

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

# Device Farm에서 테스트 실행 생성
<a name="how-to-create-test-run"></a>

Device Farm 콘솔 AWS CLI또는 Device Farm API를 사용하여 테스트 실행을 생성할 수 있습니다. 또한 Device Farm용 Jenkins 또는 Gradle 플러그인 등 지원되는 플러그인을 사용할 수도 있습니다. 플러그인에 대한 자세한 내용은 [도구 및 플러그인](aws-device-farm-tools-plugins.md) 단원을 참조하세요. 실행에 대한 자세한 내용은 [실행](test-runs.md) 단원을 참조하세요.

**Topics**
+ [사전 조건](#how-to-create-test-run-prerequisites)
+ [테스트 실행 생성(콘솔)](#how-to-create-test-run-console)
+ [테스트 실행 생성(AWS CLI)](#how-to-create-test-run-cli)
+ [테스트 실행 생성(API)](#how-to-create-test-run-api)
+ [다음 단계](#how-to-create-test-run-console-next-steps)

## 사전 조건
<a name="how-to-create-test-run-prerequisites"></a>

Device Farm에 프로젝트가 있어야 합니다. [AWS Device Farm에서 프로젝트 생성](how-to-create-project.md)의 지침을 수행한 후 이 페이지로 돌아오세요.

## 테스트 실행 생성(콘솔)
<a name="how-to-create-test-run-console"></a>

1. [https://console.aws.amazon.com/devicefarm](https://console.aws.amazon.com/devicefarm)에서 Device Farm 콘솔에 로그인하세요.

1. 탐색 창에서 **모바일 디바이스 테스트**를 선택하고 **프로젝트**를 선택하세요.

1. 프로젝트가 이미 있는 경우 해당 프로젝트에 테스트를 업로드할 수 있습니다. 그렇지 않다면 **새 프로젝트**를 선택하여 **프로젝트의 이름**을 입력한 뒤 **생성**을 선택하세요.

1. 프로젝트를 연 후 **실행 생성**을 선택하세요.

1. (선택 사항) **실행 설정**의 **실행 이름** 섹션에 실행 이름을 입력합니다. 이름이 입력되지 않으면 Device Farm 콘솔은 기본적으로 실행된 'My Device Farm run'의 이름을 지정합니다.

1. (선택 사항) **실행 설정**의 **작업 제한 시간** 섹션에서 테스트 실행의 실행 제한 시간을 지정할 수 있습니다. 무제한 테스트 슬롯을 사용하는 경우 **과금되지 않음**이 **결제 방법**에서 선택되어 있는지 확인하세요.

1. **실행 설정**의 **실행 유형** 섹션에서 실행 유형을 선택합니다. 테스트할 앱이 없거나 Android(.apk) 앱을 테스트하는 경우 **Android 앱**을 선택합니다. iOS(.ipa) 앱을 테스트하는 경우 **iOS 앱**을 선택합니다. 웹 애플리케이션을 테스트하려면 **웹 앱**을 선택합니다.

1. **앱 선택**의 **앱 선택 옵션** 섹션에서 테스트할 수 있는 앱이 없는 경우 **Device Farm에서 제공하는 샘플 앱 선택**을 선택합니다. 자체 앱을 가져오는 경우 **자체 앱 업로드**를 선택하고 애플리케이션 파일을 선택합니다. iOS 앱을 업로드하는 경우 시뮬레이터와 달리 **iOS 디바이스**를 선택해야 합니다.

1. **테스트 구성**에서 사용 가능한 테스트 프레임워크 중 하나를 선택합니다.
**참고**  
사용 가능한 테스트가 없는 경우 **내장: fuzz**를 선택하여 기본 제공된 표준 테스트 스위트를 실행합니다. **내장: Fuzz**를 선택하고 **이벤트 개수**, **이벤트 스로틀**, **Radomizer 시드** 상자가 표시되면 값을 변경하거나 유지할 수 있습니다.

   사용할 수 있는 테스트 스위트에 대한 자세한 내용은 [AWS Device Farm의 테스트 프레임워크 및 내장 테스트](test-types.md) 단원을 참조하세요.

1. **내장: Fuzz**를 선택하지 않은 경우 **테스트 패키지 선택**에서 **파일 선택**을 선택합니다. 테스트가 포함된 파일을 찾아서 선택하세요.

1. 실행 환경에서 **표준 환경에서 테스트 실행** 또는 **테스트 환경 사용자 지정**을 선택하세요. 자세한 내용은 [AWS Device Farm의 테스트 환경](test-environments.md) 단원을 참조하십시오.

1. 사용자 지정 테스트 환경을 사용하는 경우 선택적으로 다음을 수행할 수 있습니다.
   + 사용자 지정 테스트 환경에서 기본 테스트 사양을 편집하려는 경우 **편집**을 선택하여 기본 YAML 사양을 업데이트하세요.
   + 테스트 사양을 변경한 경우 **새로 저장**으로 테스트 사양을 업데이트하세요.
   + 환경 변수를 구성할 수 있습니다. 여기에 제공된 변수는 상위 프로젝트에서 구성할 수 있는 변수보다 우선합니다.

1. **디바이스 선택**에서 다음 작업 중 하나를 수행합니다.
   + 테스트를 실행할 기본 제공 디바이스 풀을 선택하려면 **디바이스 풀**에서 **최고 인기 디바이스**를 선택하세요.
   + 테스트를 실행할 고유한 디바이스 풀을 만들려면 [디바이스 풀 생성](how-to-create-device-pool.md)의 지침을 수행한 후 현재 페이지로 돌아오세요.
   + 이전에 고유한 디바이스 풀을 만들어 두었다면 **디바이스 풀**에서 해당 디바이스 풀을 선택하세요.
   + **수동으로 디바이스 선택**을 선택하고 실행하려는 디바이스를 선택합니다. 이 구성으로는 저장이 불가능합니다.

   자세한 내용은 [AWS Device Farm에서 디바이스 지원디바이스](devices.md) 단원을 참조하십시오.

1. (선택 사항) 구성을 추가하려면 **추가 구성** 드롭다운을 엽니다. 이 섹션에서는 다음 작업을 수행합니다.
   + 실행 역할 ARN을 제공하거나 상위 프로젝트에 구성된 ARN을 재정의하려면 실행 역할 ARN 필드를 사용합니다.
   + 실행 중에 Device Farm이 사용할 다른 데이터를 입력하려면 **데이터 추가** 옆의 **파일 선택** 클릭 후, 해당 데이터가 포함된 .zip 파일을 찾아 선택하세요.
   + 실행 중 Device Farm에 사용할 추가 앱을 설치하려면 **다른 앱 설치** 옆의 **파일 선택** 클릭 후 해당 앱이 들어 있는 .apk 또는 .ipa 파일을 찾아 선택하세요. 설치할 다른 앱에 대해서도 이 절차를 반복하세요. 앱을 업로드한 후 끌어서 놓는 방법으로 설치 순서를 변경할 수 있습니다.
   + 실행 중에 Wi-Fi, Bluetooth, GPS 또는 NFC 활성화 여부를 지정하려면 **무선 상태 설정** 옆의 알맞은 확인란을 선택하세요.
   + 실행을 위해 디바이스 위도 및 경도를 미리 설정하려면 **디바이스 위치** 옆에 좌표를 입력합니다.
   + 실행을 위해 디바이스 로캘을 미리 설정하려면 **디바이스 로캘**에서 로캘을 선택하세요.
   + 테스트 실행 중에 동영상 녹화하려면 **동영상 녹화 활성화**를 선택하세요.
   + 디바이스에서 성능 데이터 캡처하려면 **앱 성능 데이터 캡처 활성화**를 선택하세요.
**참고**  
디바이스 무선 상태 및 로캘 설정은 현재 Android 기본 테스트에만 사용 가능한 옵션입니다.
**참고**  
프라이빗 디바이스가 있는 경우 프라이빗 디바이스 구성도 표시됩니다.

1. 페이지 하단에서 **실행 생성**을 선택하여 실행을 예약합니다.

디바이스를 사용할 수 있게 되면 일반적으로 몇 분 이내에 Device Farm이 실행을 시작합니다. 테스트 실행 중에 Device Farm 콘솔은 실행 테이블에 보류 중 아이콘 ![Device Farm scheduled a job.](http://docs.aws.amazon.com/ko_kr/devicefarm/latest/developerguide/images/df-run-calendar.png)을 표시합니다. 실행 중인 각 디바이스 역시 보류 중 아이콘으로 시작하여 테스트가 시작되면 실행 중 아이콘 ![Device Farm progress indicator.](http://docs.aws.amazon.com/ko_kr/devicefarm/latest/developerguide/images/df-run-progress.png)로 전환합니다. 각 테스트가 완료되면 디바이스 이름 옆에 테스트 결과 아이콘이 표시됩니다. 모든 테스트가 완료되면 실행 옆에 있는 보류 중 아이콘이 테스트 결과 아이콘으로 바뀝니다.

테스트 실행을 중지해야 하는 경우 [AWS Device Farm에서의 실행 중지](how-to-stop-test-runs.md) 단원을 참조하세요.

## 테스트 실행 생성(AWS CLI)
<a name="how-to-create-test-run-cli"></a>

 AWS CLI 를 사용하여 테스트 실행을 생성할 수 있습니다.

**Topics**
+ [1단계: 프로젝트 선택](#how-to-create-test-run-cli-step1)
+ [2단계: 디바이스 풀 선택](#how-to-create-test-run-cli-step2)
+ [3단계: 애플리케이션 파일 업로드](#how-to-create-test-run-cli-step3)
+ [4단계: 테스트 스크립트 패키지 업로드](#how-to-create-test-run-cli-step4)
+ [5단계: 사용자 지정 테스트 사양 업로드(선택 사항)](#how-to-create-test-run-cli-step5)
+ [6단계: 테스트 실행 예약](#how-to-create-test-run-cli-step6)

### 1단계: 프로젝트 선택
<a name="how-to-create-test-run-cli-step1"></a>

테스트 실행을 Device Farm 프로젝트와 연결해야 합니다.

1. Device Farm 프로젝트를 나열하려면 **list-projects**를 실행하세요. 프로젝트가 없는 경우 [AWS Device Farm에서 프로젝트 생성](how-to-create-project.md)를 참조하세요.

   예제

   ```
   aws devicefarm list-projects
   ```

   응답은 Device Farm 프로젝트 목록을 포함합니다.

   ```
   {
       "projects": [
           {
               "name": "MyProject",
               "arn": "arn:aws:devicefarm:us-west-2:123456789101:project:5e01a8c7-c861-4c0a-b1d5-12345EXAMPLE",
               "created": 1503612890.057
           }
       ]
   }
   ```

1. 테스트 실행과 연결할 프로젝트를 선택한 후 Amazon 리소스 이름(ARN)을 적어 둡니다.

### 2단계: 디바이스 풀 선택
<a name="how-to-create-test-run-cli-step2"></a>

테스트 실행과 연결할 디바이스 풀을 선택해야 합니다.

1. 디바이스 풀을 보려면 프로젝트 ARN을 지정하여 **list-device-pools**를 실행하세요.

   예제

   ```
   aws devicefarm list-device-pools --arn {{arn:MyProjectARN}}
   ```

   응답은 **Top Devices** 및 해당 프로젝트에 대해 기존 생성한 모든 디바이스 풀 등 내장 Device Farm 디바이스 풀을 포함합니다.

   ```
   {
       "devicePools": [
           {
               "rules": [
                   {
                       "attribute": "ARN",
                       "operator": "IN",
                       "value": "[\"arn:aws:devicefarm:us-west-2::device:example1\",\"arn:aws:devicefarm:us-west-2::device:example2\",\"arn:aws:devicefarm:us-west-2::device:example3\"]"
                   }
               ],
               "type": "CURATED",
               "name": "Top Devices",
               "arn": "arn:aws:devicefarm:us-west-2::devicepool:example",
               "description": "Top devices"
           },
           {
               "rules": [
                   {
                       "attribute": "PLATFORM",
                       "operator": "EQUALS",
                       "value": "\"ANDROID\""
                   }
               ],
               "type": "PRIVATE",
               "name": "MyAndroidDevices",
               "arn": "arn:aws:devicefarm:us-west-2:605403973111:devicepool:example2"
           }
       ]
   }
   ```

1. 디바이스 풀을 선택하고 ARN을 적어 둡니다

   디바이스 풀을 생성한 후 이 단계로 돌아올 수도 있습니다. 자세한 내용은 [디바이스 풀(AWS CLI)을 생성하세요.](how-to-create-device-pool.md#how-to-create-device-pool-cli) 단원을 참조하세요.

### 3단계: 애플리케이션 파일 업로드
<a name="how-to-create-test-run-cli-step3"></a>

업로드 요청을 생성하고 Amazon Simple Storage Service(Amazon S3)의 미리 서명된 업로드 URL을 가져오려면 다음이 필요합니다.
+ 프로젝트 ARN
+ 앱 파일의 이름
+ 업로드 유형

자세한 내용은 [https://docs.aws.amazon.com/cli/latest/reference/devicefarm/create-upload.html](https://docs.aws.amazon.com/cli/latest/reference/devicefarm/create-upload.html) 단원을 참조하십시오.

1. 파일을 업로드하려면 `–-project-arn`, `--name` 및 `--type` 파라미터와 함께 **create-upload**을 실행하세요.

   다음 예시에서는 Android 앱의 업로드를 생성합니다.

   ```
   aws devicefarm create-upload -–project-arn arn:MyProjectArn -–name {{MyAndroid.apk}} -–type ANDROID_APP
   ```

   응답에는 앱 업로드 ARN 및 미리 서명된 URL이 포함됩니다.

   ```
   {
       "upload": {
           "status": "INITIALIZED",
           "name": "MyAndroid.apk",
           "created": 1535732625.964,
           "url": "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/ExampleURL",
           "type": "ANDROID_APP",
           "arn": "arn:aws:devicefarm:us-west-2:123456789101:upload:5e01a8c7-c861-4c0a-b1d5-12345EXAMPLE"
       }
   }
   ```

1. 앱 업로드 ARN 및 미리 서명된 URL을 적어 둡니다

1. Amazon S3의 미리 서명된 URL을 사용하여 앱 파일을 업로드하세요. 다음 예에서는 **curl**을 사용하여 Android .apk 파일을 업로드합니다.

   ```
   curl -T MyAndroid.apk "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/ExampleURL"
   ```

   자세한 내용을 알아보려면 Amazon Simple Storage Service 사용 설명서의 [미리 서명된 URL을 사용하여 객체 업로드](https://docs.aws.amazon.com/AmazonS3/latest/userguide/PresignedUrlUploadObject.html)를 참조하세요.**

1. 앱 업로드 상태를 확인하려면 **get-upload**를 실행하고 앱 업로드의 ARN을 지정하세요.

   ```
   aws devicefarm get-upload –-arn arn:MyAppUploadARN
   ```

   응답의 상태가 **SUCCEEDED** 될 때까지 기다린 후 테스트 스크립트 패키지를 업로드하세요.

   ```
   {
       "upload": {
           "status": "SUCCEEDED",
           "name": "MyAndroid.apk",
           "created": 1535732625.964,
           "url": "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/ExampleURL", 
           "type": "ANDROID_APP",
           "arn": "arn:aws:devicefarm:us-west-2:123456789101:upload:5e01a8c7-c861-4c0a-b1d5-12345EXAMPLE",
           "metadata": "{"valid": true}"
       }
   }
   ```

### 4단계: 테스트 스크립트 패키지 업로드
<a name="how-to-create-test-run-cli-step4"></a>

다음으로 테스트 스크립트 패키지를 업로드하세요.

1. 업로드 요청을 생성하고 Amazon S3의 미리 서명된 업로드 URL을 가져오려면 `–-project-arn`, `--name`, `--type` 파라미터와 함께 **create-upload**를 실행하세요.

   다음 예에서는 Appium Java TestNG 테스트 패키지 업로드를 생성합니다.

   ```
   aws devicefarm create-upload –-project-arn {{arn:MyProjectARN}} -–name {{MyTests.zip}} –-type APPIUM_JAVA_TESTNG_TEST_PACKAGE
   ```

   응답에는 테스트 패키지 업로드 ARN 및 미리 서명된 URL이 포함됩니다.

   ```
   {
       "upload": {
           "status": "INITIALIZED",
           "name": "MyTests.zip",
           "created": 1535738627.195,
           "url": "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/ExampleURL",
           "type": "APPIUM_JAVA_TESTNG_TEST_PACKAGE",
           "arn": "arn:aws:devicefarm:us-west-2:123456789101:upload:5e01a8c7-c861-4c0a-b1d5-12345EXAMPLE"
       }    
   }
   ```

1. 테스트 패키지 업로드의 ARN과 미리 서명된 URL을 적어 둡니다

1. Amazon S3의 미리 서명된 URL을 사용하여 테스트 스크립트 패키지 파일을 업로드하세요. 다음 예에서는 **curl**을 사용하여 압축된 Appium TestNG 스크립트 파일을 업로드합니다.

   ```
   curl -T MyTests.zip "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/ExampleURL"
   ```

1. 테스트 스크립트 패키지 업로드의 상태를 확인하려면 **get-upload**를 실행하고 1단계의 테스트 패키지 업로드의 ARN을 지정하세요.

   ```
   aws devicefarm get-upload –-arn arn:MyTestsUploadARN
   ```

   응답의 상태가 **SUCCEEDED** 될 때까지 기다린 후 선택 사항인 다음 단계를 진행하세요.

   ```
   {
       "upload": {
           "status": "SUCCEEDED",
           "name": "MyTests.zip",
           "created": 1535738627.195,
           "url": "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/ExampleURL", 
           "type": "APPIUM_JAVA_TESTNG_TEST_PACKAGE",
           "arn": "arn:aws:devicefarm:us-west-2:123456789101:upload:5e01a8c7-c861-4c0a-b1d5-12345EXAMPLE",
           "metadata": "{"valid": true}"
       }
   }
   ```

### 5단계: 사용자 지정 테스트 사양 업로드(선택 사항)
<a name="how-to-create-test-run-cli-step5"></a>

표준 테스트 환경에서 테스트를 실행하는 경우 이 단계를 건너뛰세요.

Device Farm은 지원되는 각 테스트 유형의 기본 테스트 사양 파일을 유지합니다. 다음으로 기본 테스트 사양을 다운로드하여 사용자 지정 테스트 환경에서 테스트를 실행하기 위해 사용자 지정 테스트 사양 업로드를 생성하세요. 자세한 내용은 [AWS Device Farm의 테스트 환경](test-environments.md) 단원을 참조하세요.

1. 기본 테스트 사양의 업로드 ARN을 찾으려면 **list-uploads**를 실행하고 프로젝트 ARN을 지정하세요.

   ```
   aws devicefarm list-uploads --arn {{arn:MyProjectARN}}
   ```

   응답에 기본 테스트 사양의 각 항목이 포함됩니다.

   ```
   {
       "uploads": [
           {
   
               {
                   "status": "SUCCEEDED",
                   "name": "Default TestSpec for Android Appium Java TestNG",
                   "created": 1529498177.474,
                   "url": "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/ExampleURL", 
                   "type": "APPIUM_JAVA_TESTNG_TEST_SPEC",
                   "arn": "arn:aws:devicefarm:us-west-2:123456789101:upload:5e01a8c7-c861-4c0a-b1d5-12345EXAMPLE"
               }
           }
       ]
   }
   ```

1. 목록에서 기본 테스트 사양을 선택하세요. 업로드 ARN을 적어 둡니다

1. 기본 테스트 사양을 다운로드하려면 **get-upload**를 실행하고 업로드 ARN을 지정하세요.

   예제

   ```
   aws devicefarm get-upload –-arn {{arn:MyDefaultTestSpecARN}}
   ```

   응답은 기본 테스트 사양을 다운로드할 수 있는 미리 서명된 URL을 포함합니다.

1. 다음 예에서는 **curl**을 사용하여 기본 테스트 사양을 다운로드하고 `MyTestSpec.yml`로 저장합니다.

   ```
   curl "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/ExampleURL" > MyTestSpec.yml
   ```

1. 테스트 요구 사항에 맞게 기본 테스트 사양을 편집한 후, 향후 테스트 실행에서 수정된 테스트 사양을 사용할 수 있습니다. 사용자 지정 테스트 환경에서 기본 테스트 사양을 그대로 사용하려면 이 단계를 건너뛰세요.

1. 사용자 지정 테스트 사양의 업로드를 생성하려면 테스트 사양 이름, 테스트 사양 유형 및 프로젝트 ARN을 지정하여 **create-upload**를 실행하세요.

   다음 예에서는 Appium Java TestNG 사용자 지정 테스트 사양 업로드를 생성합니다.

   ```
   aws devicefarm create-upload --name MyTestSpec.yml --type APPIUM_JAVA_TESTNG_TEST_SPEC --project-arn {{arn:MyProjectARN}}
   ```

   응답에는 테스트 사양 업로드 ARN 및 미리 서명된 URL이 포함됩니다.

   ```
   {
       "upload": {
           "status": "INITIALIZED",
           "category": "PRIVATE",
           "name": "MyTestSpec.yml",
           "created": 1535751101.221,
           "url": "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/ExampleURL", 
           "type": "APPIUM_JAVA_TESTNG_TEST_SPEC",
           "arn": "arn:aws:devicefarm:us-west-2:123456789101:upload:5e01a8c7-c861-4c0a-b1d5-12345EXAMPLE"
       }
   }
   ```

1. 테스트 사양 업로드의 ARN과 미리 서명된 URL을 적어 둡니다

1. Amazon S3의 미리 서명된 URL을 사용하여 테스트 사양 파일을 업로드하세요. 다음 예에서는 **curl**을 사용하여 Appium JavaTestNG 테스트 사양을 업로드합니다.

   ```
   curl -T MyTestSpec.yml "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/ExampleURL"
   ```

1. 테스트 사양 업로드의 상태를 확인하려면 **get-upload**를 실행하고 업로드 ARN을 지정하세요.

   ```
   aws devicefarm get-upload –-arn {{arn:MyTestSpecUploadARN}}
   ```

   응답의 상태가 **SUCCEEDED** 될 때까지 기다린 후 테스트 실행을 예약하세요.

   ```
   {
       "upload": {
           "status": "SUCCEEDED",
           "name": "MyTestSpec.yml",
           "created": 1535732625.964,
           "url": "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/ExampleURL", 
           "type": "APPIUM_JAVA_TESTNG_TEST_SPEC",
           "arn": "arn:aws:devicefarm:us-west-2:123456789101:upload:5e01a8c7-c861-4c0a-b1d5-12345EXAMPLE",
           "metadata": "{"valid": true}"
       }
   }
   ```

   사용자 지정 테스트 사양을 업데이트하려면 테스트 사양의 업로드 ARN을 지정하여 **update-upload**를 실행하세요. 자세한 내용은 [https://docs.aws.amazon.com/cli/latest/reference/devicefarm/update-upload.html](https://docs.aws.amazon.com/cli/latest/reference/devicefarm/update-upload.html) 단원을 참조하십시오.

### 6단계: 테스트 실행 예약
<a name="how-to-create-test-run-cli-step6"></a>

를 사용하여 테스트 실행을 예약하려면 다음을 **schedule-run**지정하여를 AWS CLI실행합니다.
+ [1단계](#how-to-create-test-run-cli-step1)의 프로젝트 ARN
+ [2단계](#how-to-create-test-run-cli-step2)의 디바이스 풀 ARN
+ [3단계](#how-to-create-test-run-cli-step3)의 앱 업로드 ARN
+ [4단계](#how-to-create-test-run-cli-step4)의 테스트 패키지 업로드 ARN

 사용자 지정 테스트 환경에서 테스트를 실행하는 경우 [5단계](#how-to-create-test-run-cli-step5)의 테스트 사양 ARN도 필요합니다.

**표준 테스트 환경에서 실행을 예약**
+ 프로젝트 ARN, 디바이스 풀 ARN, 애플리케이션 업로드 ARN 및 테스트 패키지 정보를 지정하여 **schedule-run**을 실행하세요.

  예제:

  ```
  aws devicefarm schedule-run --project-arn {{arn:MyProjectARN}} --app-arn {{arn:MyAppUploadARN}} --device-pool-arn {{arn:MyDevicePoolARN}} --name {{MyTestRun}} --test type=APPIUM_JAVA_TESTNG,testPackageArn={{arn:MyTestPackageARN}}
  ```

  응답에는 테스트 실행 상태를 확인할 때 사용할 수 있는 실행 ARN이 포함됩니다.

  ```
  {
      "run": {
          "status": "SCHEDULING",
          "appUpload": "arn:aws:devicefarm:us-west-2:123456789101:upload:5e01a8c7-c861-4c0a-b1d5-12345appEXAMPLE",
          "name": "MyTestRun",
          "radios": {
              "gps": true,
              "wifi": true,
              "nfc": true,
              "bluetooth": true
          },
          "created": 1535756712.946,
          "totalJobs": 179,
          "completedJobs": 0,
          "platform": "ANDROID_APP",
          "result": "PENDING",
          "devicePoolArn": "arn:aws:devicefarm:us-west-2:123456789101:devicepool:5e01a8c7-c861-4c0a-b1d5-12345devicepoolEXAMPLE",
          "jobTimeoutMinutes": 150,
          "billingMethod": "METERED",
          "type": "APPIUM_JAVA_TESTNG",
          "testSpecArn": "arn:aws:devicefarm:us-west-2:123456789101:upload:5e01a8c7-c861-4c0a-b1d5-12345specEXAMPLE",
          "arn": "arn:aws:devicefarm:us-west-2:123456789101:run:5e01a8c7-c861-4c0a-b1d5-12345runEXAMPLE",
          "counters": {
              "skipped": 0,
              "warned": 0,
              "failed": 0,
              "stopped": 0,
              "passed": 0,
              "errored": 0,
              "total": 0
          }
      }
  }
  ```

  자세한 내용은 [https://docs.aws.amazon.com/cli/latest/reference/devicefarm/schedule-run.html](https://docs.aws.amazon.com/cli/latest/reference/devicefarm/schedule-run.html) 단원을 참조하십시오.

**사용자 지정 테스트 환경에서 실행을 예약**
+ 단계는 `--test` 파라미터의 추가 `testSpecArn` 속성이 포함된 표준 테스트 환경의 단계와 거의 동일합니다.

  예제

  ```
  aws devicefarm schedule-run --project-arn {{arn:MyProjectARN}} --app-arn {{arn:MyAppUploadARN}} --device-pool-arn {{arn:MyDevicePoolARN}} --name {{MyTestRun}} --test testSpecArn={{arn:MyTestSpecUploadARN}},type={{APPIUM_JAVA_TESTNG}},testPackageArn={{arn:MyTestPackageARN}}
  ```

**테스트 실행 상태를 확인**
+ **get-run** 명령을 사용하고 실행 ARN을 지정하세요.

  ```
  aws devicefarm get-run --arn arn:aws:devicefarm:us-west-2:111122223333:run:5e01a8c7-c861-4c0a-b1d5-12345runEXAMPLE
  ```

자세한 내용은 [https://docs.aws.amazon.com/cli/latest/reference/devicefarm/get-run.html](https://docs.aws.amazon.com/cli/latest/reference/devicefarm/get-run.html) 단원을 참조하십시오. 에서 Device Farm을 사용하는 방법에 대한 자세한 내용은 섹션을 AWS CLI참조하세요[AWS CLI 참조](cli-ref.md).

## 테스트 실행 생성(API)
<a name="how-to-create-test-run-api"></a>

단계는 AWS CLI 섹션에 설명된 단계와 동일합니다. [테스트 실행 생성(AWS CLI)](#how-to-create-test-run-cli)을(를) 참조하세요.

[https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_ScheduleRun.html](https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_ScheduleRun.html) API를 직접 호출하려면 다음 정보가 필요합니다.
+ 프로젝트 ARN [프로젝트 생성(API)](how-to-create-project.md#how-to-create-project-api) 및 [https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_CreateProject.html](https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_CreateProject.html) 섹션을 참조하세요.
+ 애플리케이션 업로드 ARN [https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_CreateUpload.html](https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_CreateUpload.html)을(를) 참조하세요.
+ 테스트 패키지 업로드 ARN [https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_CreateUpload.html](https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_CreateUpload.html)을(를) 참조하세요.
+ 디바이스 풀 ARN [디바이스 풀 생성](how-to-create-device-pool.md) 및 [https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_CreateDevicePool.html](https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_CreateDevicePool.html)을 참조하세요.

**참고**  
사용자 지정 테스트 환경에서 테스트를 실행하는 경우 테스트 사양 업로드 ARN도 필요합니다. 자세한 내용은 [5단계: 사용자 지정 테스트 사양 업로드(선택 사항)](#how-to-create-test-run-cli-step5) 및 [https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_CreateUpload.html](https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_CreateUpload.html) 섹션을 참조하세요.

자세한 Device Farm API 사용은 [Device Farm 자동화](api-ref.md) 단원을 참조하세요.

## 다음 단계
<a name="how-to-create-test-run-console-next-steps"></a>

Device Farm 콘솔에서 실행이 완료되면 시계 아이콘 ![Device Farm scheduled a job.](http://docs.aws.amazon.com/ko_kr/devicefarm/latest/developerguide/images/df-run-calendar.png)이 성공 ![The test succeeded.](http://docs.aws.amazon.com/ko_kr/devicefarm/latest/developerguide/images/df-run-success.png) 등의 결과 아이콘으로 바뀝니다. 테스트가 완료되자마자 실행에 대한 보고서가 표시됩니다. 자세한 내용은 [AWS Device Farm에 있는 보고서Reports](reports.md) 단원을 참조하세요.

보고서를 사용하려면 [Device Farm에서 테스트 보고서 보기](how-to-use-reports.md)의 지침을 따르세요.