워크플로 아티팩트 정보
아티팩트를 통해 작업을 완료한 후 데이터를 보관하고 동일한 워크플로의 다른 작업과 공유할 수 있습니다. 아티팩트가 워크플로 실행 중에 생성된 파일 또는 파일 컬렉션입니다. 예를 들어 아티팩트를 사용하여 워크플로 실행이 종료된 후 빌드 및 테스트 출력을 저장할 수 있습니다. 실행 내에서 호출되는 모든 작업 및 워크플로에는 해당 실행의 아티팩트에 대한 쓰기 액세스 권한이 있습니다.
기본적으로 GitHub은(는) 90일 동안 빌드 로그와 아티팩트가 저장되며 이 보존 기간을 사용자 지정할 수 있습니다. 자세한 내용은 "AUTOTITLE"을 참조하세요. 끌어오기 요청에 대한 보존 기간은 누군가가 끌어오기 요청에 새 커밋을 푸시할 때마다 다시 시작됩니다.
다음은 업로드할 수 있는 몇 가지 일반적인 아티팩트입니다.
- 로그 파일 및 코어 덤프
- 테스트 결과, 실패, 스크린샷
- 이진 파일 또는 압축 파일
- 스트레스 테스트 성능 출력 및 코드 검사 결과
아티팩트 저장은 GitHub에 스토리지 공간을 사용합니다. GitHub Actions 사용량은 퍼블릭 리포지토리의 표준 GitHub호스팅된 실행기 및 자체 호스팅 실행기에서 무료입니다. 프라이빗 리포지토리에서 각 GitHub 계정은 계정에서 사용하는 제품에 따라 특정한 양의 남은 시간(분)과 GitHub호스팅 실행기에 사용할 수 있는 스토리지를 받습니다. 포함된 금액을 초과하는 모든 사용량은 지출 한도에 따라 제어됩니다. 자세한 내용은 "GitHub Actions 요금 청구 관리.
아티팩트는 워크플로 실행 중에 업로드되며 UI에서 아티팩트의 이름과 크기를 볼 수 있습니다. GitHub UI를 사용하여 아티팩트를 다운로드하면 아티팩트의 일부로 개별적으로 업로드된 모든 파일이 단일 파일로 압축됩니다. 즉, Zip 파일의 크기가 아닌 업로드된 아티팩트 크기에 따라 청구 금액이 계산됩니다.
GitHub는 빌드 아티팩트 업로드 및 다운로드에 사용할 수 있는 두 가지 작업을 제공합니다. 자세한 내용은 upload-artifact 및 download-artifact actions에 대한 작업을 참조하세요.
작업 간에 데이터를 공유하려면 다음을 수행합니다.
- 파일 업로드: 업로드된 파일에 이름을 지정하고 작업이 끝나기 전에 데이터를 업로드합니다.
- 파일 다운로드: 동일한 워크플로 실행 중에 업로드된 아티팩트만 다운로드할 수 있습니다. 파일을 다운로드할 때 이름으로 참조할 수 있습니다.
작업 단계는 실행기 컴퓨터에서 동일한 환경을 공유하지만 고유한 개별 프로세스에서 실행됩니다. 작업의 단계 간에 데이터를 전달하려면 입력 및 출력을 사용할 수 있습니다. 입력 및 출력에 대한 자세한 내용은 "GitHub Actions에 대한 메타데이터 구문"을 참조하세요.
아티팩트 및 종속성 캐싱 비교
아티팩트 및 캐싱은 GitHub에 파일을 저장할 수 있는 기능을 제공하지만 각 기능은 서로 다른 사용 사례를 제공하므로 서로 바꿔서 사용할 수 없습니다.
- 패키지 관리 시스템의 빌드 종속성 등 작업 또는 워크플로 실행 간에 자주 변경되지 않는 파일을 다시 사용하려는 경우 캐싱을 사용합니다.
- 빌드된 이진 파일 또는 빌드 로그와 같이 워크플로 실행이 종료된 후 볼 작업에서 생성된 파일을 저장하려는 경우 아티팩트를 사용합니다.
종속성 캐싱에 대한 자세한 내용은 "워크플로 속도를 높이기 위한 종속성 캐싱"을 참조하세요.
빌드 및 테스트 아티팩트 업로드
CI(연속 통합) 워크플로를 만들어 코드를 빌드하고 테스트할 수 있습니다. GitHub Actions을(를) 사용하여 CI를 수행하는 방법에 대한 자세한 내용은 "연속 통합 정보.
코드를 빌드하고 테스트하는 출력은 종종 배포할 수 있는 테스트 실패 및 프로덕션 코드를 디버그하는 데 사용할 수 있는 파일을 생성합니다. 리포지토리에 푸시된 코드를 빌드 및 테스트하고 성공 또는 실패 상태를 보고하도록 워크플로를 구성할 수 있습니다. 배포에 사용할 빌드 및 테스트 출력을 업로드하고, 실패한 테스트 또는 크래시를 디버그하고, 테스트 도구 모음 검사를 볼 수 있습니다.
이 upload-artifact
작업을 사용하여 아티팩트를 업로드할 수 있습니다. 아티팩트를 업로드할 때 단일 파일이나 디렉터리 또는 여러 파일이나 디렉터리를 지정할 수 있습니다. 특정 파일 또는 디렉터리를 제외하고 와일드카드 패턴을 사용할 수도 있습니다. 아티팩트 이름을 제공하는 것이 좋지만 이름이 제공되지 않으면 artifact
가 기본 이름으로 사용됩니다. 구문에 대한 자세한 내용은 작업/업로드 아티팩트 작업을(를) 참조하세요.
예제
예를 들어 리포지토리 또는 웹 애플리케이션에는 CSS 및 JavaScript로 변환해야 하는 SASS 및 TypeScript 파일이 포함될 수 있습니다. 빌드 구성이 dist
디렉터리에서 컴파일된 파일을 출력하는 경우 모든 테스트가 성공적으로 완료되면 dist
디렉터리의 파일을 웹 애플리케이션 서버에 배포합니다.
|-- hello-world (repository)
| └── dist
| └── tests
| └── src
| └── sass/app.scss
| └── app.ts
| └── output
| └── test
|
이 예제에서는 src
디렉터리에서 코드를 빌드하고 tests
디렉터리에서 테스트를 실행하는 Node.js 프로젝트에 대한 워크플로를 만드는 방법을 보여 줍니다. npm test
를 실행하면 output/test/
디렉터리에 저장된 code-coverage.html
코드 검사 보고서가 생성된다고 가정할 수 있습니다.
워크플로는 dist
디렉터리에 프로덕션 아티팩트를 업로드하지만 markdown 파일은 제외합니다. 또한 code-coverage.html
보고서를 다른 아티팩트로 업로드합니다.
name: Node CI
on: [push]
jobs:
build_and_test:
runs-on: ubuntu-latest
steps:
- name: Checkout repository
uses: actions/checkout@v3
- name: npm install, build, and test
run: |
npm install
npm run build --if-present
npm test
- name: Archive production artifacts
uses: actions/upload-artifact@v3
with:
name: dist-without-markdown
path: |
dist
!dist/**/*.md
- name: Archive code coverage results
uses: actions/upload-artifact@v3
with:
name: code-coverage-report
path: output/test/code-coverage.html
사용자 지정 아티팩트 보존 기간 구성
워크플로에서 만든 개별 아티팩트에 대한 사용자 지정 보존 기간을 정의할 수 있습니다. 워크플로를 사용하여 새 아티팩트를 만들 때 upload-artifact
작업에 retention-days
를 사용할 수 있습니다. 이 예제에서는 my-artifact
라는 이름의 아티팩트에 대한 사용자 지정 보존 기간을 5일로 설정하는 방법을 보여 줍니다.
- name: 'Upload Artifact'
uses: actions/upload-artifact@v3
with:
name: my-artifact
path: my_file.txt
retention-days: 5
retention-days
값은 리포지토리, 조직 또는 엔터프라이즈에서 설정한 보존 한도를 초과할 수 없습니다.
아티팩트 다운로드 또는 삭제
워크플로를 실행하는 동안 download-artifact
작업을 사용하여 이전에 동일한 워크플로 실행에서 업로드된 아티팩트를 다운로드할 수 있습니다.
워크플로 실행이 완료되면 GitHub에서 또는 REST API를 사용하여 아티팩트를 다운로드 또는 삭제할 수 있습니다. 자세한 내용은 "워크플로 아티팩트 다운로드", "워크플로 아티팩트 제거" 및 "동작"을 참조하세요.
워크플로 실행 중 아티팩트 다운로드
actions/download-artifact
작업은 워크플로 실행 중 이전에 업로드한 아티팩트 다운로드에 사용할 수 있습니다.
참고: 동일한 워크플로 실행 중에 업로드된 워크플로 내 아티팩트만 다운로드할 수 있습니다.
아티팩트의 이름을 지정하여 개별 아티팩트를 다운로드합니다. 이름을 지정하지 않고 아티팩트를 업로드한 경우 기본 이름은 artifact
입니다.
- name: Download a single artifact
uses: actions/download-artifact@v3
with:
name: my-artifact
이름을 지정하지 않고 워크플로 실행의 모든 아티팩트를 다운로드할 수도 있습니다. 이 기능은 많은 아티팩트로 작업하는 경우에 유용할 수 있습니다.
- name: Download all workflow run artifacts
uses: actions/download-artifact@v3
모든 워크플로 실행의 아티팩트가 다운로드되면 각 아티팩트의 디렉터리가 해당 이름을 사용하여 만들어집니다.
구문에 대한 자세한 내용은 작업/다운로드 아티팩트 작업을(를) 참조하세요.
워크플로의 작업 간 데이터 전달
upload-artifact
및 download-artifact
작업을 사용하여 워크플로의 작업 간에 데이터를 공유할 수 있습니다. 이 예제 워크플로에서는 동일한 워크플로의 작업 간에 데이터를 전달하는 방법을 보여 줍니다. 자세한 내용은 actions/upload-artifact and download-artifact actions{% else %} actions/upload-artifact
및 download-artifact
GitHub.com에 대한 작업을 참조하세요.
이전 작업의 아티팩트에 종속된 작업은 종속 작업이 성공적으로 완료될 때까지 기다려야 합니다. 이 워크플로는 needs
키워드를 사용하여 job_1
, job_2
, job_3
가 순차적으로 실행되도록 합니다. 예를 들어 job_2
에는 needs: job_1
구문을 사용하는 job_1
이 필요합니다.
작업 1은 다음 단계를 수행합니다.
- 수학 계산을 수행하고 결과를
math-homework.txt
라는 텍스트 파일에 저장합니다. upload-artifact
작업을 사용하여math-homework.txt
파일을homework
아티팩트 이름으로 업로드합니다.
작업 2는 이전 작업의 결과를 사용합니다.
- 이전 작업에서 업로드된
homework
아티팩트를 다운로드합니다. 기본적으로download-artifact
작업은 단계가 실행 중인 작업 영역 디렉터리에 아티팩트 다운로드합니다.path
입력 매개 변수를 사용하여 다른 다운로드 디렉터리를 지정할 수 있습니다. math-homework.txt
파일의 값을 읽고, 수학 계산을 수행하고, 결과를math-homework.txt
에 다시 저장하여 내용을 덮어씁니다.math-homework.txt
파일을 업로드합니다. 업로드는 동일한 이름을 공유하기 때문에 이전에 업로드한 아티팩트를 덮어씁니다.
작업 3는 이전 작업에 업로드된 결과를 표시합니다.
homework
아티팩트를 다운로드합니다.- 수학 수식의 결과를 로그에 출력합니다.
이 워크플로 예제에서 수행되는 전체 수학 연산은 (3 + 7) x 9 = 90
입니다.
name: Share data between jobs
on: [push]
jobs:
job_1:
name: Add 3 and 7
runs-on: ubuntu-latest
steps:
- shell: bash
run: |
expr 3 + 7 > math-homework.txt
- name: Upload math result for job 1
uses: actions/upload-artifact@v3
with:
name: homework
path: math-homework.txt
job_2:
name: Multiply by 9
needs: job_1
runs-on: windows-latest
steps:
- name: Download math result for job 1
uses: actions/download-artifact@v3
with:
name: homework
- shell: bash
run: |
value=`cat math-homework.txt`
expr $value \* 9 > math-homework.txt
- name: Upload math result for job 2
uses: actions/upload-artifact@v3
with:
name: homework
path: math-homework.txt
job_3:
name: Display results
needs: job_2
runs-on: macOS-latest
steps:
- name: Download math result for job 2
uses: actions/download-artifact@v3
with:
name: homework
- name: Print the final result
shell: bash
run: |
value=`cat math-homework.txt`
echo The result is $value
워크플로 실행은 생성한 모든 아티팩트를 보관합니다. 보관된 아티팩트 다운로드에 대한 자세한 내용은 "워크플로 아티팩트 다운로드"을 참조하세요.