한 장의 그림으로 이해하기

그림 크게 보기 ↗ (새 탭)
업무·자동화 · 판정 관망
그림을 글로 풀면
브랜치와 파일 조건 함께 확인
브랜치와 경로 필터를 함께 쓰면 두 조건을 모두 만족해야 실행됩니다.
- 대상
- AI 평가 워크플로를 관리하는 개발자
- 무엇이 바뀜
- branches와 paths를 함께 설정한 경우입니다.
- 왜 중요한가
- 브랜치가 맞아도 파일 경로 때문에 건너뛸 수 있습니다.
- 지금 할 일
- 이벤트·브랜치·변경 파일을 설정과 대조합니다.
- 한계·미확인
- 브랜치 push의 가상 예시입니다. 실제 Actions 실행 시험 없음.
- 공식 출처
- docs.github.com
- 확인일
- 2026-09-23
맞는 브랜치인데 평가가 조용한 상황
가상의 AI 평가 저장소가 평가용 브랜치의 평가 자료 변경에만 반응한다고 가정합니다. 그 브랜치에서 안내 문서만 고쳤다면 브랜치 이름이 맞아도 평가가 시작되지 않을 수 있습니다. 그림의 배달원은 패스 하나를 맞췄지만 짐의 모양이 맞지 않습니다. 기다리거나 다시 누르기 전에 실행 대상이었는지부터 확인할 상황입니다.
두 필터를 한 묶음으로 읽기
GitHub 공식 문서는 branches 계열과 paths 계열 필터를 함께 정의하면 둘 다 충족해야 워크플로가 실행된다고 설명합니다. 이 글은 브랜치 push와 포함 조건인 branches·paths의 조합을 다룹니다. paths는 변경 파일 중 일치하는 경로가 있는지와 관련됩니다. 한쪽 조건이 다른 쪽을 대신하지 않으며, 태그 push에서는 경로 필터를 평가하지 않으므로 이 비교를 그대로 적용하면 안 됩니다.
재시도 전에 세 가지를 한 줄에 적기
이 글에서는 발생한 이벤트, 대상 브랜치, 변경 파일 목록을 먼저 적고 같은 이벤트 아래의 필터 설정과 나란히 대조하도록 제안합니다. 조건 때문에 건너뛴 실행과 시작 후 실패한 실행은 대응이 다릅니다. 그림에서 로봇이 움직이는 쪽도 실행 대상이 된다는 뜻일 뿐 평가 통과를 보장하지 않습니다. 다른 조건이나 변경 파일 계산 제한까지 이 그림이 설명하지는 않으며, 실제 저장소에서 워크플로를 실행하는 시험은 하지 않았습니다.
참고 원문: GitHub Actions 공식 워크플로 문법 — branches와 paths 필터 · 원문 게시일 상시 문서(게시일 별도 미표기) · 확인일 2026-09-23
AI 작성·자동 검증: 공식 자료와의 대조 및 게시 구조 검사. 사람의 개별 검수와 제품 실행 시험은 수행하지 않았습니다. 그림은 신규 생성한 개념 일러스트입니다.
이 글의 검증 카드
- 자료 버전
- GitHub Actions workflow syntax 상시 문서·2026-09-23 확인. 브랜치 push의 branches·paths 결합. 실제 워크플로 실행 없음
- 확인일
- 2026-09-23
- 검증 상태
- 개발자 주장
- 한계·주의
- 브랜치 push의 가상 예시입니다. 실제 Actions 실행 시험 없음.
함께 더 정확하게
질문·오류 제보
그림에서 이해되지 않는 부분이나 달라진 내용을 알려 주세요. 관리자가 확인하고 승인한 글만 공개됩니다.
개발에서는 이메일 인증 가입 또는 관리자 발급 계정으로 참여할 수 있습니다. 계정·이용 문의
아직 계정이 없으신가요? 회원가입
공개된 질문·제보
아직 공개된 질문·제보가 없습니다. 궁금한 부분을 먼저 남겨 주세요.