GitHub Actions용 빠른 시작

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

소개

GitHub Actions 워크플로를 만들고 실행하려면 GitHub 리포지토리만 있으면 됩니다. 이 가이드에서는 GitHub Actions의 몇 가지 필수 기능을 보여 주는 워크플로를 추가합니다.

다음 예제에서는 GitHub Actions 작업을 자동으로 트리거할 수 있는 방법, 작업 실행 위치 및 리포지토리에서 작업이 코드와 상호 작용하는 방법을 보여 줍니다.

첫 번째 워크플로 만들기

.github/workflows 디렉터리가 아직 없는 경우 GitHub의 리포지토리에 이 디렉터리를 만듭니다. GitHub이(가) 포함된 GitHub Actions 워크플로를 검색하려면 디렉터리에 정확한 이름이 있어야 합니다.
.github/workflows 디렉터리에서 .yml 또는 .yaml 익스텐션을 사용하여 파일을 만듭니다. 이 자습서에서는 파일 이름으로 github-actions-demo.yml을(를) 사용합니다. 자세한 내용은 "새 파일 만들기"을(를) 참조하세요.

다음 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 }}."

페이지 아래쪽으로 스크롤하여 이 커밋에 대한 새 분기 만들기를 선택하고 끌어오기 요청을 시작합니다를 선택합니다. 그런 다음 끌어오기 요청을 만들기 위해 새 파일 제안을 클릭합니다.

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

워크플로 결과 보기

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

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

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

GitHub은 사용자 지정하여 고유한 연속 통합 워크플로를 만들 수 있는 미리 구성된 시작 워크플로를 제공합니다. GitHub Enterprise Server은 코드를 분석하고 리포지토리에 유용할 수 있는 CI 시작 워크플로를 보여 줍니다. 예를 들어 리포지토리에 Node.js 코드가 포함된 경우 Node.js 프로젝트에 대한 제안이 표시됩니다. 시작 워크플로를 시작 위치로 사용하여 사용자 지정 워크플로를 빌드하거나 있는 그대로 사용할 수 있습니다.

GitHub Enterprise Server 인스턴스의 actions/starter-workflows 리포지토리에서 시작 워크플로의 전체 목록을 찾아볼 수 있습니다.

다음 단계

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

GitHub Actions 워크플로를 빠르게 만드는 방법은 "시작 워크플로 사용"을 참조하세요.
코드를 빌드하고 테스트하는 연속 통합(CI) 워크플로는 "빌드 및 테스트 자동화"을 참조하세요.
패키지를 빌드하고 게시하려면 "패키지 게시"을 참조하세요.
프로젝트를 배포하려면 "배포"을 참조하세요.
GitHub에서 작업 및 프로세스를 자동화하려면 "문제 및 끌어오기 요청 관리"을 참조하세요.
위의 많은 사용 예시를 포함한 GitHub Actions의 더 복잡한 기능의 예제는 "예제"을 참조하세요. 실행기에서 코드를 테스트하고, GitHub CLI에 액세스하고, 동시성 및 테스트 매트릭스와 같은 고급 기능을 사용하는 방법을 설명하는 자세한 예제를 볼 수 있습니다.

이 문서의 내용

소개

첫 번째 워크플로 만들기

워크플로 결과 보기

추가 시작 워크플로

다음 단계