Amazon CodeCatalyst는 더 이상 신규 고객에게 공개되지 않습니다. 기존 고객은 정상적으로 서비스를 계속 이용할 수 있습니다. 자세한 내용은 [CodeCatalyst에서 마이그레이션하는 방법](migration.md) 단원을 참조하십시오. 기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # 작업 간 아티팩트 및 파일 공유 *아티팩트*는 워크플로 작업의 출력이며 일반적으로 폴더 또는 파일 아카이브로 구성됩니다. 아티팩트를 사용하면 작업 간에 파일과 정보를 공유할 수 있기 때문에 아티팩트가 중요합니다. 예를 들어, `sam-template.yml` 파일을 *생성* 하는 빌드 작업이 있을 수 있지만 배포 작업에서 파일을 *사용*하려는 경우가 있습니다. 이 시나리오에서는 아티팩트를 사용하여 빌드 작업이 배포 작업과 `sam-template.yml` 파일을 공유하도록 허용합니다. 코드는 다음과 같을 것입니다. ``` Actions: BuildAction: Identifier: aws/build@v1 Steps: - Run: sam package --output-template-file sam-template.yml Outputs: Artifacts: - Name: MYARTIFACT Files: - sam-template.yml DeployAction: Identifier: aws/cfn-deploy@v1 Inputs: Artifacts: - MYARTIFACT Configuration: template: sam-template.yml ``` 이전 코드에서 빌드 작업(`BuildAction`)은 `sam-template.yml` 파일을 생성한 다음 라는 출력 아티팩트 `MYARTIFACT`에 추가합니다. 후속 배포 작업(`DeployAction`)은 `MYARTIFACT`를 입력으로 지정하여 `sam-template.yml` 파일에 대한 액세스 권한을 부여합니다. **Topics** + [아티팩트를 출력 및 입력으로 지정하지 않고 공유할 수 있나요?](#workflows-working-artifacts-share) + [워크플로 간에 아티팩트를 공유할 수 있나요?](#workflows-working-artifacts-share-wf) + [아티팩트 예시](workflows-working-artifacts-ex.md) + [출력 아티팩트 정의](workflows-working-artifacts-output.md) + [입력 아티팩트 정의](workflows-working-artifacts-refer.md) + [아티팩트의 파일 참조](workflows-working-artifacts-refer-files.md) + [아티팩트 다운로드](workflows-download-workflow-outputs.md) ## 아티팩트를 출력 및 입력으로 지정하지 않고 공유할 수 있나요? 예, 작업의 YAML 코드의 `Outputs` 및 `Inputs` 섹션에서 아티팩트를 지정하지 않고 작업 간에 아티팩트를 공유할 수 있습니다. 이렇게 하려면 컴퓨팅 공유를 켜야 합니다. 컴퓨팅 공유 및 아티팩트가 켜져 있을 때 아티팩트를 지정하는 방법에 대한 자세한 내용은 [작업 간에 컴퓨팅 공유](compute-sharing.md) 섹션을 참조하세요. **참고** 컴퓨팅 공유 기능을 사용하면 `Outputs` 및 `Inputs` 섹션이 필요 없어 워크플로의 YAML 코드를 간소화할 수 있지만, 이 기능을 켜기 전에 알아두어야 할 제한 사항이 있습니다. 이러한 제한에 대한 자세한 내용은 [컴퓨팅 공유 고려 사항](compute-sharing.md#compare-compute-sharing) 섹션을 참조하세요. ## 워크플로 간에 아티팩트를 공유할 수 있나요? 아니요. 서로 다른 워크플로 간에 아티팩트를 공유할 수 없지만 동일한 워크플로 내의 작업 간에 아티팩트를 공유할 수 있습니다. # 아티팩트 예시 다음 예시에서는 Amazon CodeCatalyst 워크플로 정의 파일에서 아티팩트를 출력, 입력 및 참조하는 방법을 보여줍니다. **Topics** + [예시: 아티팩트 출력](#workflows-working-artifacts-ex-basic) + [예시: 다른 작업에서 생성된 아티팩트 입력](#workflows-working-artifacts-ex-ref) + [예시: 여러 아티팩트에서 파일 참조](#workflows-working-artifacts-ex-ref-file) + [예시: 단일 아티팩트에서 파일 참조](#workflows-working-artifacts-ex-ref-file-one) + [예시: WorkflowSource가 있을 때 아티팩트의 파일 참조](#workflows-working-artifacts-ex-ref-file-wf-source) + [예시: 작업 그룹이 있을 때 아티팩트의 파일 참조](#workflows-working-artifacts-ex-groups) ## 예시: 아티팩트 출력 다음 예시에서는 두 개의 .jar 파일이 포함된 아티팩트를 출력하는 방법을 보여줍니다. ``` Actions: Build: Identifier: aws/build@v1 Outputs: Artifacts: - Name: ARTIFACT1 Files: - build-output/file1.jar - build-output/file2.jar ``` ## 예시: 다른 작업에서 생성된 아티팩트 입력 다음 예시에서는 `BuildActionA`의 `ARTIFACT4` 아티팩트를 출력하고 `BuildActionB`에 입력하는 방법을 보여줍니다. ``` Actions: BuildActionA: Identifier: aws/build@v1 Outputs: Artifacts: - Name: ARTIFACT4 Files: - build-output/file1.jar - build-output/file2.jar BuildActionB: Identifier: aws/build@v1 Inputs: Artifacts: - ARTIFACT4 Configuration: ``` ## 예시: 여러 아티팩트에서 파일 참조 다음 예시에서는 `BuildActionC`의 `ART5` 및 `ART6`라는 두 개의 아티팩트를 출력한 다음 `BuildActionD`(`Steps` 아래)의 `file5.txt`(`ART5` 아티팩트) 및 `file6.txt`(`ART6` 아티팩트)라는 두 개의 파일을 참조하는 방법을 보여줍니다. **참고** 파일 참조에 대한 자세한 내용은 [아티팩트의 파일 참조](workflows-working-artifacts-refer-files.md) 섹션을 참조하세요. **참고** 예시는 사용 중인 `$CATALYST_SOURCE_DIR_ART5` 접두사를 보여주지만 이를 생략할 수 있습니다. 이는 `ART5`가 *기본 입력*이기 때문입니다. 기본 입력에 대한 자세한 내용은 [아티팩트의 파일 참조](workflows-working-artifacts-refer-files.md) 섹션을 참조하세요. ``` Actions: BuildActionC: Identifier: aws/build@v1 Outputs: Artifacts: - Name: ART5 Files: - build-output/file5.txt - Name: ART6 Files: - build-output/file6.txt BuildActionD: Identifier: aws/build@v1 Inputs: Artifacts: - ART5 - ART6 Configuration: Steps: - run: cd $CATALYST_SOURCE_DIR_ART5/build-output && cat file5.txt - run: cd $CATALYST_SOURCE_DIR_ART6/build-output && cat file6.txt ``` ## 예시: 단일 아티팩트에서 파일 참조 다음 예시에서는 `BuildActionE`의 `ART7` 아티팩트를 출력한 다음 `BuildActionF`(`Steps` 아래)의 `file7.txt`(`ART7` 아티팩트) 파일을 참조하는 방법을 보여줍니다. [예시: 여러 아티팩트에서 파일 참조](#workflows-working-artifacts-ex-ref-file)에서와 같이 참조에 `build-output` 디렉터리 앞에 `$CATALYST_SOURCE_DIR_`*artifact-name* 접두사가 필요하지 않은 것을 확인할 수 있습니다. 이는 `Inputs`에 지정된 항목이 하나뿐이기 때문입니다. **참고** 파일 참조에 대한 자세한 내용은 [아티팩트의 파일 참조](workflows-working-artifacts-refer-files.md) 섹션을 참조하세요. ``` Actions: BuildActionE: Identifier: aws/build@v1 Outputs: Artifacts: - Name: ART7 Files: - build-output/file7.txt BuildActionF: Identifier: aws/build@v1 Inputs: Artifacts: - ART7 Configuration: Steps: - run: cd build-output && cat file7.txt ``` ## 예시: WorkflowSource가 있을 때 아티팩트의 파일 참조 다음 예시에서는 `BuildActionG`의 `ART8` 아티팩트를 출력한 다음 `BuildActionH`(`Steps` 아래)의 `file8.txt`(`ART8` 아티팩트) 파일을 참조하는 방법을 보여줍니다. 참조에 `$CATALYST_SOURCE_DIR_`*artifact-name* 접두사가 [예시: 여러 아티팩트에서 파일 참조](#workflows-working-artifacts-ex-ref-file)에서와 같이 어떻게 필요한지 확인합니다. 이는 `Inputs`(소스 및 아티팩트)에 여러 항목이 지정되어 있기 때문에 파일을 찾을 위치를 나타내는 접두사가 필요합니다. **참고** 파일 참조에 대한 자세한 내용은 [아티팩트의 파일 참조](workflows-working-artifacts-refer-files.md) 섹션을 참조하세요. ``` Actions: BuildActionG: Identifier: aws/build@v1 Outputs: Artifacts: - Name: ART8 Files: - build-output/file8.txt BuildActionH: Identifier: aws/build@v1 Inputs: Sources: - WorkflowSource Artifacts: - ART8 Configuration: Steps: - run: cd $CATALYST_SOURCE_DIR_ART8/build-output && cat file8.txt ``` ## 예시: 작업 그룹이 있을 때 아티팩트의 파일 참조 다음 예시에서는 `ActionGroup1`, `ActionI`의 `ART9` 아티팩트를 출력한 다음 `ActionJ`의 `file9.txt`(`ART9` 아티팩트) 파일을 참조하는 방법을 보여줍니다. 파일 참조에 대한 자세한 내용은 [아티팩트의 파일 참조](workflows-working-artifacts-refer-files.md) 섹션을 참조하세요. ``` Actions: ActionGroup1: Actions: ActionI: Identifier: aws/build@v1 Outputs: Artifacts: - Name: ART9 Files: - build-output/file9.yml ActionJ: Identifier: aws/cfn-deploy@v1 Inputs: Sources: - WorkflowSource Artifacts: - ART9 Configuration: template: /artifacts/ActionGroup1@ActionJ/ART9/build-output/file9.yml ``` # 출력 아티팩트 정의 다음 지침에 따라 Amazon CodeCatalyst 작업이 출력할 아티팩트를 정의합니다. 그러면 이 아티팩트를 다른 작업에서 사용할 수 있게 됩니다. **참고** 모든 작업이 출력 아티팩트를 지원하는 것은 아닙니다. 작업이 이를 지원하는지 확인하려면 다음에 나오는 시각적 편집기 지침을 실행하고 **출력** 탭에서 작업에 **출력 아티팩트** 버튼이 포함되어 있는지 확인합니다. 포함되어 있다면 출력 아티팩트가 지원됩니다. ------ #### [ Visual ] **시각적 편집기를 사용하여 출력 아티팩트 정의** 1. [https://codecatalyst.aws/](https://codecatalyst.aws/)에서 CodeCatalyst 콘솔을 엽니다. 1. 프로젝트를 선택합니다. 1. 탐색 창에서 **CI/CD**를 선택한 다음 **워크플로**를 선택합니다. 1. 워크플로의 이름을 선택합니다. 소스 리포지토리 또는 워크플로가 정의된 브랜치 이름을 기준으로 필터링하거나, 워크플로 이름 또는 상태를 기준으로 필터링할 수 있습니다. 1. **편집**을 선택합니다. 1. **비주얼**을 선택합니다. 1. 워크플로 다이어그램에서 아티팩트를 생성할 작업을 선택합니다. 1. **출력** 탭을 선택합니다. 1. **아티팩트**에서 **아티팩트 추가**를 선택합니다. 1. **아티팩트 추가**를 선택하고 다음과 같이 필드에 정보를 입력합니다. **빌드 아티팩트 이름** 작업에서 생성된 아티팩트의 이름을 지정합니다. 아티팩트 이름은 워크플로 내에서 고유해야 하며 영숫자 문자(a-z, A-Z, 0-9) 및 밑줄(\$1)로 제한됩니다. 공백, 하이픈(-) 및 특수 문자는 허용되지 않습니다. 출력 아티팩트 이름에서 공백, 하이픈 및 기타 특수 문자를 활성화하는 데 따옴표를 사용할 수 없습니다. 예시를 포함해 아티팩트에 대한 자세한 내용은 [작업 간 아티팩트 및 파일 공유](workflows-working-artifacts.md) 섹션을 참조하세요. **빌드로 생성한 파일** CodeCatalyst가 작업으로 출력되는 아티팩트에 포함하는 파일을 지정합니다. 이러한 파일은 실행 시 워크플로 작업에 의해 생성되며 소스 리포지토리에서도 사용할 수 있습니다. 파일 경로는 소스 리포지토리 또는 이전 작업의 아티팩트에 상주할 수 있으며 소스 리포지토리 또는 아티팩트 루트와 관련이 있습니다. glob 패턴을 사용하여 경로를 지정할 수 있습니다. 예시: + 빌드 위치 또는 소스 리포지토리 위치의 루트에 있는 단일 파일을 지정하려면 `my-file.jar`를 사용합니다.. + 하위 디렉터리에 단일 파일을 지정하려면 `directory/my-file.jar` 또는 `directory/subdirectory/my-file.jar`를 사용합니다. + 모든 파일을 지정하려면 `"**/*"`를 사용합니다. `**` glob 패턴은 임의의 수의 하위 디렉터리와 일치함을 나타냅니다. + `directory`라는 디렉터리에 있는 모든 파일 및 디렉터리를 지정하려면 `"directory/**/*"`를 사용합니다. `**` glob 패턴은 임의의 수의 하위 디렉터리와 일치함을 나타냅니다. + `directory`라는 디렉터리의 모든 파일을 지정하되 해당 하위 디렉터리는 지정하지 않으려면 `"directory/*"`를 사용합니다. **참고** 파일 경로에 별표(`*`) 또는 기타 특수 문자가 하나 이상 포함된 경우 경로를 큰따옴표(`""`)로 묶습니다. 특수 문자에 대한 자세한 내용은 [구문 지침 및 규칙](workflow-reference.md#workflow.terms.syntax.conv) 섹션을 참조하세요. 예시를 포함해 아티팩트에 대한 자세한 내용은 [작업 간 아티팩트 및 파일 공유](workflows-working-artifacts.md) 섹션을 참조하세요. **참고** 파일 경로에 접두사를 추가하여 찾을 아티팩트 또는 소스를 나타내야 할 수 있습니다. 자세한 내용은 [소스 리포지토리 파일 참조](workflows-sources-reference-files.md) 및 [아티팩트의 파일 참조](workflows-working-artifacts-refer-files.md) 섹션을 참조하세요. 1. (선택 사항) 커밋하기 전에 워크플로의 YAML 코드를 검증하려면 **검증**을 선택합니다. 1. **커밋**을 선택하고 커밋 메시지를 입력한 다음 **커밋**을 다시 선택합니다. ------ #### [ YAML ] **YAML 편집기를 사용하여 출력 아티팩트 정의** 1. [https://codecatalyst.aws/](https://codecatalyst.aws/)에서 CodeCatalyst 콘솔을 엽니다. 1. 프로젝트를 선택합니다. 1. 탐색 창에서 **CI/CD**를 선택한 다음 **워크플로**를 선택합니다. 1. 워크플로의 이름을 선택합니다. 소스 리포지토리 또는 워크플로가 정의된 브랜치 이름을 기준으로 필터링하거나, 워크플로 이름 또는 상태를 기준으로 필터링할 수 있습니다. 1. **편집**을 선택합니다. 1. **YAML**을 선택합니다. 1. 워크플로 작업에서 다음과 유사한 코드를 추가합니다. ``` action-name: Outputs: Artifacts: - Name: artifact-name Files: - file-path-1 - file-path-2 ``` 더 많은 예시는 [아티팩트 예시](workflows-working-artifacts-ex.md)를 참조합니다. 자세한 내용은 작업에 해당하는 [워크플로 YAML 정의](workflow-reference.md) 섹션을 참조하세요. 1. (선택 사항) 커밋하기 전에 워크플로의 YAML 코드를 검증하려면 **검증**을 선택합니다. 1. **커밋**을 선택하고 커밋 메시지를 입력한 다음 **커밋**을 다시 선택합니다. ------ # 입력 아티팩트 정의 다른 Amazon CodeCatalyst 작업에서 생성된 아티팩트를 사용하려면 현재 작업의 입력으로 지정해야 합니다. 여러 아티팩트를 입력으로 지정할 수 있습니다. 이는 작업에 따라 다릅니다. 자세한 내용은 작업에 해당하는 [워크플로 YAML 정의](workflow-reference.md) 섹션을 참조하세요. **참고** 다른 워크플로의 아티팩트를 참조할 수 없습니다. 다음 지침에 따라 다른 작업의 아티팩트를 현재 작업에 대한 입력으로 지정합니다. **사전 조건** 시작하기 전에 다른 작업에서 아티팩트가 출력되어 있는지 확인하세요. 자세한 내용은 [출력 아티팩트 정의](workflows-working-artifacts-output.md) 섹션을 참조하세요. 아티팩트를 출력하면 다른 작업에서 사용할 수 있습니다. ------ #### [ Visual ] **아티팩트를 작업에 대한 입력으로 지정(시각적 편집기)** 1. [https://codecatalyst.aws/](https://codecatalyst.aws/)에서 CodeCatalyst 콘솔을 엽니다. 1. 프로젝트를 선택합니다. 1. 탐색 창에서 **CI/CD**를 선택한 다음 **워크플로**를 선택합니다. 1. 워크플로의 이름을 선택합니다. 소스 리포지토리 또는 워크플로가 정의된 브랜치 이름을 기준으로 필터링하거나, 워크플로 이름 또는 상태를 기준으로 필터링할 수 있습니다. 1. **편집**을 선택합니다. 1. **비주얼**을 선택합니다. 1. 워크플로 다이어그램에서 아티팩트를 입력으로 지정하려는 작업을 선택합니다. 1. **입력**을 선택합니다. 1. **아티팩트 - 선택 사항**에서 다음을 수행합니다. 이 작업에 대한 입력으로 제공하려는 이전 작업의 아티팩트를 지정합니다. 이러한 아티팩트는 이전 작업에서 출력 아티팩트로 이미 정의되어 있어야 합니다. 입력 아티팩트를 지정하지 않으면 `action-name/Inputs/Sources` 아래에 소스 리포지토리를 하나 이상 지정해야 합니다. 예시를 포함해 아티팩트에 대한 자세한 내용은 [작업 간 아티팩트 및 파일 공유](workflows-working-artifacts.md) 섹션을 참조하세요. **참고** **아티팩트 - 선택적** 드롭다운 목록을 사용할 수 없거나(시각적 편집기) YAML(YAML 편집기)을 검증할 때 오류가 발생하는 경우 작업이 하나의 입력만 지원하기 때문일 수 있습니다. 이 경우 소스 입력을 제거해 보세요. 1. (선택 사항) 커밋하기 전에 워크플로의 YAML 코드를 검증하려면 **검증**을 선택합니다. 1. **커밋**을 선택하고 커밋 메시지를 입력한 다음 **커밋**을 다시 선택합니다. ------ #### [ YAML ] **아티팩트를 작업에 대한 입력으로 지정(YAML 편집기)** 1. [https://codecatalyst.aws/](https://codecatalyst.aws/)에서 CodeCatalyst 콘솔을 엽니다. 1. 프로젝트를 선택합니다. 1. 탐색 창에서 **CI/CD**를 선택한 다음 **워크플로**를 선택합니다. 1. 워크플로의 이름을 선택합니다. 소스 리포지토리 또는 워크플로가 정의된 브랜치 이름을 기준으로 필터링하거나, 워크플로 이름 또는 상태를 기준으로 필터링할 수 있습니다. 1. **편집**을 선택합니다. 1. **YAML**을 선택합니다. 1. 아티팩트를 입력으로 지정하려는 작업에서 다음과 유사한 코드를 추가합니다. ``` action-name: Inputs: Artifacts: - artifact-name ``` 더 많은 예시는 [아티팩트 예시](workflows-working-artifacts-ex.md)를 참조합니다. 1. (선택 사항) 커밋하기 전에 워크플로의 YAML 코드를 검증하려면 **검증**을 선택합니다. 1. **커밋**을 선택하고 커밋 메시지를 입력한 다음 **커밋**을 다시 선택합니다. ------ # 아티팩트의 파일 참조 아티팩트 내에 파일이 있고 Amazon CodeCatalyst 워크플로 작업 중 하나에서 이 파일을 참조해야 하는 경우 다음 절차를 수행하세요. **참고** 또한 [소스 리포지토리 파일 참조](workflows-sources-reference-files.md) 섹션도 참조하세요. ------ #### [ Visual ] *사용할 수 없습니다. YAML을 선택하여 YAML 지침을 봅니다.* ------ #### [ YAML ] **아티팩트의 파일 참조(YAML 편집기)** 1. [https://codecatalyst.aws/](https://codecatalyst.aws/)에서 CodeCatalyst 콘솔을 엽니다. 1. 프로젝트를 선택합니다. 1. 탐색 창에서 **CI/CD**를 선택한 다음 **워크플로**를 선택합니다. 1. 워크플로의 이름을 선택합니다. 소스 리포지토리 또는 워크플로가 정의된 브랜치 이름을 기준으로 필터링하거나, 워크플로 이름 또는 상태를 기준으로 필터링할 수 있습니다. 1. **편집**을 선택합니다. 1. **YAML**을 선택합니다. 1. 파일을 참조하려는 작업에서 다음과 유사한 코드를 추가합니다. ``` Actions: My-action: Inputs: Sources: - WorkflowSource Artifacts: - artifact-name Configuration: template: artifact-path/path/to/file.yml ``` 이전 코드에서 다음을 바꿉니다. + *artifact-name*: 아티팩트 이름으로 바꿉니다. + *artifact-path*: 다음 테이블의 값으로 바꿉니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/codecatalyst/latest/userguide/workflows-working-artifacts-refer-files.html) 예시는 [아티팩트 예시](workflows-working-artifacts-ex.md) 섹션을 참조하세요. **참고** 다음과 같은 경우 *artifact-path*를 생략하고 아티팩트 루트 디렉터리를 기준으로 파일 경로를 지정할 수 있습니다. 참조를 포함하려는 작업이 `Inputs` 아래에 하나의 항목만 포함합니다(예: 입력 아티팩트 하나만 포함되고 소스는 포함되지 않음). 참조하려는 파일은 기본 입력에 있습니다. *기본 입력*은 `WorkflowSource`이거나 `WorkflowSource`가 없는 경우 나열된 첫 번째 입력 아티팩트입니다. 1. (선택 사항) 커밋하기 전에 워크플로의 YAML 코드를 검증하려면 **검증**을 선택합니다. 1. **커밋**을 선택하고 커밋 메시지를 입력한 다음 **커밋**을 다시 선택합니다. ------ # 아티팩트 다운로드 문제 해결을 위해 Amazon CodeCatalyst 워크플로 작업에서 생성된 아티팩트를 다운로드하여 검사할 수 있습니다. 다운로드할 수 있는 아티팩트에는 다음과 같이 두 가지 유형이 있습니다. + **소스 아티팩트** - 실행이 시작될 때 존재했던 소스 리포지토리 콘텐츠의 스냅샷이 포함된 아티팩트입니다. + **워크플로 아티팩트** - 워크플로 구성 파일의 `Outputs` 속성에 정의된 아티팩트입니다. **워크플로에서 아티팩트 출력 다운로드** 1. [https://codecatalyst.aws/](https://codecatalyst.aws/)에서 CodeCatalyst 콘솔을 엽니다. 1. 프로젝트를 선택합니다. 1. 탐색 창에서 **CI/CD**를 선택한 다음 **워크플로**를 선택합니다. 1. 워크플로의 이름을 선택합니다. 소스 리포지토리 또는 워크플로가 정의된 브랜치 이름을 기준으로 필터링하거나, 워크플로 이름 또는 상태를 기준으로 필터링할 수 있습니다. 1. 워크플로 이름에서 **실행**을 선택합니다. 1. **실행 기록**의 **실행 ID** 열에서 실행을 선택합니다. 예를 들어 `Run-95a4d`입니다. 1. 실행 이름에서 **아티팩트**를 선택합니다. 1. 아티팩트 옆에 있는 **다운로드**를 선택합니다. 아카이브 파일이 다운로드됩니다. 파일 이름은 7개의 무작위 문자로 구성됩니다. 1. 원하는 아카이브 추출 유틸리티를 사용하여 아카이브를 추출합니다.