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

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

# 워크플로 시작하기
<a name="workflows-getting-started"></a>

이 자습서에서는 첫 번째 워크플로를 생성하고 구성하는 방법을 알아봅니다.

**작은 정보**  
미리 구성된 워크플로로 시작하시겠습니까? 작동하는 워크플로, 샘플 애플리케이션 및 기타 리소스를 사용하여 프로젝트를 설정하는 지침이 포함된 [블루프린트를 사용하여 프로젝트 생성](projects-create.md#projects-create-console-template) 섹션을 참조하세요.

**Topics**
+ [사전 조건](#get-started-create-workflow-prerequisites)
+ [1단계: 워크플로 생성 및 구성](#get-started-create-workflow-create)
+ [2단계: 커밋을 사용하여 워크플로 저장](#get-started-create-workflow-commit)
+ [3단계: 실행 결과 보기](#get-started-create-workflow-results)
+ [(선택 사항) 4단계: 정리](#get-started-create-workflow-cleanup)

## 사전 조건
<a name="get-started-create-workflow-prerequisites"></a>

시작하기 전:
+ CodeCatalyst **스페이스**가 필요합니다. 자세한 내용은 [스페이스 생성](spaces-create.md) 섹션을 참조하세요.
+ CodeCatalyst 스페이스에는 다음과 같은 빈 프로젝트가 필요합니다.

  ```
  codecatalyst-project
  ```

   자세한 내용은 [Amazon CodeCatalyst에서 빈 프로젝트 생성](projects-create.md#projects-create-empty) 섹션을 참조하세요.
+ 프로젝트에는 다음과 같은 CodeCatalyst **리포지토리**가 필요합니다.

  ```
  codecatalyst-source-repository
  ```

  자세한 내용은 [소스 리포지토리 생성](source-repositories-create.md) 섹션을 참조하세요.

**참고**  
기존 프로젝트와 소스 리포지토리가 있는 경우 이를 사용할 수 있지만, 이 자습서 마지막에 새 프로젝트를 만들면 정리가 더 쉬워집니다.

## 1단계: 워크플로 생성 및 구성
<a name="get-started-create-workflow-create"></a>

이 단계에서는 소스 코드가 변경될 때 자동으로 빌드하고 테스트하는 워크플로를 만들고 구성합니다.

**워크플로 생성**

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

1. **워크플로 생성**을 선택합니다.

   워크플로 정의 파일은 CodeCatalyst 콘솔의 YAML 편집기에 나타납니다.

**워크플로 구성**

**시각적** 편집기 또는 **YAML** 편집기에서 워크플로를 구성할 수 있습니다. YAML 편집기로 시작한 다음 시각적 편집기로 전환해 보겠습니다.

1. **\$1 작업**을 선택하면 워크플로에 추가할 수 있는 워크플로 작업 목록을 볼 수 있습니다.

1. **빌드** 작업에서 **\$1**를 선택하여 작업의 YAML을 워크플로 정의 파일에 추가합니다. 이제 워크플로는 다음과 유사하게 보입니다.

   ```
   Name: Workflow_fe47
   SchemaVersion: "1.0"
   
   # Optional - Set automatic triggers.
   Triggers:
     - Type: Push
       Branches:
         - main
   
   # Required - Define action configurations.
   Actions:
     Build_f0:
       Identifier: aws/build@v1
   
       Inputs:
         Sources:
           - WorkflowSource # This specifies that the action requires this workflow as a source
   
       Outputs:
         AutoDiscoverReports:
           Enabled: true
           # Use as prefix for the report files
           ReportNamePrefix: rpt
   
       Configuration:
         Steps:
           - Run: echo "Hello, World!"
           - Run: echo "<?xml version=\"1.0\" encoding=\"UTF-8\" ?>" >> report.xml
           - Run: echo "<testsuite tests=\"1\" name=\"TestAgentJunit\" >" >> report.xml
           - Run: echo "<testcase classname=\"TestAgentJunit\" name=\"Dummy
               Test\"/></testsuite>" >> report.xml
   ```

   워크플로는 `WorkflowSource` 소스 리포지토리의 파일을 `Build_f0` 작업을 실행하는 컴퓨팅 머신에 복사하고, `Hello, World!`를 로그에 인쇄하고, 컴퓨팅 머신에서 테스트 보고서를 검색하고, 이를 CodeCatalyst 콘솔의 **보고서** 페이지에 출력합니다.

1. **시각적** 편집기에서 워크플로 정의 파일을 보려면 시각적을 선택합니다. 시각적 편집기의 필드를 사용하면 YAML 편집기에 표시된 YAML 속성을 구성할 수 있습니다.

## 2단계: 커밋을 사용하여 워크플로 저장
<a name="get-started-create-workflow-commit"></a>

이 단계에서는 변경 사항을 저장합니다. 워크플로는 리포지토리에 `.yaml` 파일로 저장되므로 커밋과 함께 변경 사항을 저장합니다.

**워크플로 변경 사항 커밋**

1. (선택 사항) 워크플로의 YAML 코드가 유효한지 확인하려면 **검증**을 선택합니다.

1. **커밋**을 선택합니다.

1. **워크플로 파일 이름**에 **my-first-workflow**과 같은 워크플로 구성 파일의 이름을 입력합니다.

1. **커밋 메시지**에 **create my-first-workflow.yaml**과 같은 커밋을 식별하는 메시지를 입력합니다.

1. **리포지토리**에서 (`codecatalyst-repository`) 워크플로를 저장할 리포지토리를 선택합니다.

1. **브랜치 이름**에서 (`main`) 워크플로를 저장할 브랜치를 선택합니다.

1. **커밋**을 선택합니다.

새 워크플로가 워크플로 목록에 나타납니다. 표시하는 데 몇 초 정도 걸릴 수 있습니다.

워크플로는 커밋과 함께 저장되고 워크플로에 코드 푸시 트리거가 구성되어 있으므로 워크플로를 저장하면 워크플로 실행이 자동으로 시작됩니다.

## 3단계: 실행 결과 보기
<a name="get-started-create-workflow-results"></a>

이 단계에서는 커밋에서 시작된 실행으로 이동하여 결과를 봅니다.

**실행 결과 보기**

1. 워크플로의 이름을 선택합니다. 예를 들어 `Workflow_fe47`입니다.

   소스 리포지토리의 레이블(**WorkflowSource**)과 빌드 작업(예: **Build\$1f0**)을 보여주는 워크플로 다이어그램입니다.

1. 워크플로 실행 다이어그램에서 빌드 작업(예: **Build\$1f0**)을 선택합니다.

1. **로그,** **보고서**, **구성** 및 **변수** 탭의 내용을 검토합니다. 이 탭은 빌드 작업의 결과를 보여줍니다.

   자세한 내용은 [빌드 작업 결과 보기](build-view-results.md) 섹션을 참조하세요.

## (선택 사항) 4단계: 정리
<a name="get-started-create-workflow-cleanup"></a>

이 단계에서는 자습서에서 생성한 리소스를 정리합니다.

**리소스 삭제**
+ 이 자습서를 위해 새 프로젝트를 만들었다면 삭제합니다. 지침은 [프로젝트 삭제](projects-delete.md) 섹션을 참조하세요. 프로젝트를 삭제하면 소스 리포지토리와 워크플로도 삭제됩니다.