[Github Action] main.yml 안에 uses: actions/checkout@v2 의미!!

main.yml 같은 GitHub Actions 워크플로우 파일 안에서

uses: actions/checkout@v2

라고 적혀 있는 부분은 GitHub에서 공식 제공하는 actions/checkout 액션을 불러와서 실행하겠다는 의미입니다.

---

1. actions/checkout 액션이 하는 일

• GitHub Actions에서 워크플로우가 실행되면, 기본적으로는 저장소 소스 코드가 runner(실행 환경)에 복제되지 않습니다.

• 그래서 빌드, 테스트, 배포 같은 작업을 하기 전에 레포지토리 코드를 runner에 체크아웃(=git clone) 해야 하는데, 이 작업을 자동으로 해주는 것이 바로 actions/checkout입니다.

즉, uses: actions/checkout@v2를 적어두면

• 현재 실행 중인 workflow에서 해당 저장소의 코드가 가져와집니다.

• 가져온 코드를 runner의 작업 디렉토리($GITHUB_WORKSPACE)에 배치해줍니다.

---

2. @v2의 의미

• @v2는 버전 태그를 의미합니다.

• actions/checkout 액션에는 여러 버전이 있는데, v2는 안정적으로 많이 쓰이는 메이저 버전이에요.

• 현재는 v3도 존재합니다. (uses: actions/checkout@v3)

  • v2와 기능은 거의 동일하지만, 보안성과 퍼포먼스가 개선된 최신 버전이라 보통은 v3 사용이 권장됩니다.

---

3. 간단 예시

name: CI

on: [push]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2   # 내 레포지토리 코드 가져오기
      - name: Run build
        run: |
          npm install
          npm run build

➡ 여기서 actions/checkout@v2가 없다면, runner에는 코드가 없는 상태라 npm install이나 npm run build를 실행할 수 없습니다.

---

👉 정리하면,
uses: actions/checkout@v2 = GitHub 공식 checkout 액션을 불러와서 워크플로우 실행 환경에 내 저장소 코드를 다운로드하는 단계예요.