GitHub Actions용 빠른 시작

참고: GitHub 호스트 실행기는 현재 GitHub Enterprise Server에서 지원되지 않습니다. GitHub public roadmap에 예정된 향후 지원에 대해 자세히 알아볼 수 있습니다.

소개

GitHub Actions는 빌드, 테스트 및 배포 파이프라인을 자동화할 수 있는 CI/CD(연속 통합 및 지속적인 업데이트) 플랫폼입니다. 리포지토리에 변경 내용을 푸시할 때마다 테스트를 실행하거나 병합된 pull request를 프로덕션에 배포하는 워크플로를 만들 수 있습니다.

이 빠른 시작 가이드에서는 GitHub의 사용자 인터페이스를 사용하여 GitHub Actions의 몇 가지 필수 기능을 보여 주는 워크플로를 추가하는 방법을 보여줍니다.

미리 구성된 워크플로를 시작하려면 actions/starter-workflows 리포지토리의 템플릿 목록을 탐색합니다. 자세한 내용은 "워크플로 템플릿 사용" 항목을 참조하세요.

GitHub Actions 워크플로의 개요는 "워크플로 정보" 항목을 참조하세요. GitHub Actions를 구성하는 다양한 구성 요소에 대해 알아보려면 "GitHub Actions 이해" 항목을 참조하세요.

워크플로 템플릿 사용

GitHub은(는) 미리 구성된 워크플로 템플릿을 제공하며, 이를 그대로 사용하거나 사용자 지정하여 자신만의 워크플로를 만들 수 있습니다. GitHub Enterprise Server은(는) 코드를 분석하여 리포지토리에 유용할 수 있는 워크플로 템플릿을 보여줍니다. 예를 들어 리포지토리에 Node.js 코드가 포함된 경우 Node.js 프로젝트에 대한 제안이 표시됩니다.

이러한 워크플로 템플릿은 빠르게 시작하고 실행할 수 있도록 설계되어 다음과 같은 다양한 구성을 제공합니다.

워크플로 템플릿을 시작 위치로 사용하여 사용자 지정 워크플로를 빌드하거나 있는 그대로 사용할 수 있습니다. actions/starter-workflows 리포지토리에서 워크플로 템플릿의 전체 목록을 찾아볼 수 있습니다. 자세한 내용은 "워크플로 템플릿 사용" 항목을 참조하세요.

필수 조건

이 가이드는 다음을 전제로 합니다.

GitHub 사용 방법에 대한 최소한의 기본 지식이 있습니다. 그렇지 않은 경우 리포지토리와 pull request에 대한 설명서의 일부 문서를 먼저 읽으면 도움이 됩니다. 예를 들어, "리포지토리에 대한 빠른 시작", "분기 정보" 및 "끌어오기 요청 정보"를 참조하세요.
GitHub에 파일을 추가할 수 있는 리포지토리가 있습니다.
GitHub Actions에 액세스할 수 있습니다.

Note

GitHub에서 리포지토리 이름 아래에 작업 탭이 표시되지 않으면 해당 리포지토리에 대해 작업이 사용하지 않도록 설정되어 있기 때문일 수 있습니다. 자세한 내용은 "리포지토리에 대한 GitHub Actions 설정 관리"을(를) 참조하세요.

첫 번째 워크플로 만들기

GitHub 리포지토리의 .github/workflows 디렉터리에 github-actions-demo.yml이라는 워크플로 파일을 생성합니다. 방법:
- .github/workflows 디렉터리가 이미 있는 경우 GitHub에서 해당 디렉터리로 이동하고 파일 추가를 클릭한 다음 새 파일 만들기를 클릭하고 파일 이름을 github-actions-demo.yml로 지정합니다.
- 리포지토리에 .github/workflows 디렉터리가 없는 경우 GitHub에서 리포지토리의 기본 페이지로 이동하고 파일 추가를 클릭한 다음 새 파일 만들기를 클릭하고 파일 이름을 .github/workflows/github-actions-demo.yml로 지정합니다. 이렇게 하면 한 번에 .github 및 workflows 디렉터리와 github-actions-demo.yml 파일이 만들어집니다.
Note

GitHub가 리포지토리에서 GitHub Actions 워크플로를 검색하려면 .github/workflows라는 디렉터리에 워크플로 파일을 저장해야 합니다.

워크플로 파일에 원하는 이름을 지정할 수 있지만 파일 이름 확장명으로 .yml 또는 .yaml을 사용해야 합니다. YAML은 구성 파일에 일반적으로 사용되는 생성 언어입니다.

다음 YAML 콘텐츠를 github-actions-demo.yml 파일에 복사합니다.

YAML

name: GitHub Actions Demo
run-name: ${{ github.actor }} is testing out GitHub Actions 🚀
on: [push]
jobs:
  Explore-GitHub-Actions:
    runs-on: ubuntu-latest
    steps:
      - run: echo "🎉 The job was automatically triggered by a ${{ github.event_name }} event."
      - run: echo "🐧 This job is now running on a ${{ runner.os }} server hosted by GitHub!"
      - run: echo "🔎 The name of your branch is ${{ github.ref }} and your repository is ${{ github.repository }}."
      - name: Check out repository code
        uses: actions/checkout@v4
      - run: echo "💡 The ${{ github.repository }} repository has been cloned to the runner."
      - run: echo "🖥️ The workflow is now ready to test your code on the runner."
      - name: List files in the repository
        run: |
          ls ${{ github.workspace }}
      - run: echo "🍏 This job's status is ${{ job.status }}."

name: GitHub Actions Demo
run-name: ${{ github.actor }} is testing out GitHub Actions 🚀
on: [push]
jobs:
  Explore-GitHub-Actions:
    runs-on: ubuntu-latest
    steps:
      - run: echo "🎉 The job was automatically triggered by a ${{ github.event_name }} event."
      - run: echo "🐧 This job is now running on a ${{ runner.os }} server hosted by GitHub!"
      - run: echo "🔎 The name of your branch is ${{ github.ref }} and your repository is ${{ github.repository }}."
      - name: Check out repository code
        uses: actions/checkout@v4
      - run: echo "💡 The ${{ github.repository }} repository has been cloned to the runner."
      - run: echo "🖥️ The workflow is now ready to test your code on the runner."
      - name: List files in the repository
        run: |
          ls ${{ github.workspace }}
      - run: echo "🍏 This job's status is ${{ job.status }}."

이 단계에서는 이 워크플로의 세부 정보를 이해할 필요가 없습니다. 지금은 내용을 복사하여 파일에 붙여넣기만 하면 됩니다. 이 빠른 시작 가이드를 완료한 후에는 "워크플로 정보"에서 워크플로 파일의 구문에 대해 알아볼 수 있으며, ${{ github.actor }}, ${{ github.event_name }} 등의 GitHub Actions 컨텍스트에 대한 설명은 "워크플로 실행에 대한 컨텍스트 정보에 액세스"를 참조하세요.

변경 내용 커밋을 클릭합니다.
"변경 내용 제안" 대화 상자에서 기본 분기를 커밋하는 옵션이나 새 분기를 생성하고 pull request를 시작하는 옵션을 선택합니다. 그런 다음 변경 내용 커밋 또는 변경 내용 제안을 클릭합니다.

리포지토리의 분기로 워크플로 파일을 커밋하면 push 이벤트가 트리거되고 워크플로가 실행됩니다.

pull request를 시작하도록 선택한 경우 계속하여 pull request를 만들 수 있지만 커밋이 여전히 분기에 대해 이루어지고 새 워크플로를 트리거하므로 이 빠른 시작의 목적에는 이 작업이 필요하지 않습니다.

워크플로 결과 보기

GitHub에서 리포지토리의 기본 페이지로 이동합니다.
리포지토리 이름 아래에서 작업을 클릭합니다.
왼쪽 사이드바에서 표시하려는 워크플로를 클릭합니다. 이 예시에서는 "GitHub Actions 데모"입니다.
워크플로 실행 목록에서 보려는 실행의 이름을 클릭합니다. 이 예시에서는 "USERNAME이 GitHub Actions를 테스트하고 있습니다."입니다.
워크플로 실행 페이지의 왼쪽 사이드바 작업 아래에서 Explore-GitHub-Actions 작업을 클릭합니다.
로그는 각 단계가 처리된 방법을 보여 줍니다. 단계를 확장하면 세부 정보를 볼 수 있습니다.

예를 들어 리포지토리에서 파일 목록을 볼 수 있습니다.

방금 추가한 예시 워크플로는 코드가 분기에 푸시될 때마다 트리거되며 GitHub Actions이(가) 리포지토리의 콘텐츠로 작동하는 방법을 보여줍니다. 자세한 자습서는 "GitHub Actions 이해" 항목을 참조하세요.

다음 단계

GitHub Actions은(는) 애플리케이션 개발 프로세스의 거의 모든 측면을 자동화하는 데 도움이 될 수 있습니다. 시작할 준비가 되셨나요? GitHub Actions을(를) 사용하여 다음 단계를 수행하는 데 유용한 리소스는 다음과 같습니다.

GitHub Actions 워크플로를 만드는 방법은 "워크플로 템플릿 사용"을 참조하세요.
연속 통합(CI, continuous integration) 워크플로는 "AUTOTITLE"을 참조하세요.
패키지를 빌드하고 게시하려면 "패키지 게시"을 참조하세요.
프로젝트를 배포하려면 "사용 사례 및 예제"을 참조하세요.
GitHub에서 작업 및 프로세스를 자동화하려면 "프로젝트 관리"을 참조하세요.
GitHub Actions의 더 복잡한 기능을 보여 주는 예제는 “사용 사례 및 예제”을 참조하세요. 이러한 예제를 통해 실행기에서 코드를 테스트하고, GitHub CLI에 액세스하고, 동시성 및 테스트 매트릭스와 같은 고급 기능을 사용하는 방법을 볼 수 있습니다.