경로 필터링 및 선택적 빌드
모노레포와 여러 저장소 환경에서 경로 필터, 변경 감지, 조건부 행렬을 사용해 변경의 영향을 받은 워크플로와 작업만 실행되도록 해 보세요.
경로 필터링 및 선택적 빌드은(는) CoddyKit의 무료 CI/CD with GitHub Actions & DevOps Pipelines 강의입니다. 이것은 4개 중 4번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 CI/CD with GitHub Actions & DevOps Pipelines 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. CI/CD with GitHub Actions & DevOps Pipelines 강의에는 총 4개의 강의가 포함되어 있습니다.
낭비되는 빌드 문제
모노레포에서 문서가 변경되었다고 해서 백엔드, 프런트엔드, 모바일 앱을 모두 다시 빌드하고 배포할 필요는 없습니다.
선택적 빌드는 변경의 영향을 받는 파이프라인 부분만 실행하여 시간과 실행기 사용 시간을 절약합니다.
트리거의 경로 필터
가장 간단한 방법은 트리거의 paths 필터를 사용하는 것입니다. 패턴과 일치하는 파일이 변경될 때만 워크플로가 실행됩니다.
on:
push:
paths:
- 'services/api/**'경로 무시
paths-ignore를 사용하여 반대로 설정할 수도 있습니다. 나열된 경로를 제외한 모든 경우에 워크플로를 실행합니다.
문서만 변경되었을 때 CI를 건너뛰는 데 유용합니다.
on:
push:
paths-ignore:
- 'docs/**'
- '**.md'트리거 필터의 한계
트리거 수준의 필터는 전체 워크플로를 실행할지 결정합니다. 하지만 모노레포에서는 어떤 작업을 실행할지 결정하는 하나의 워크플로를 원하는 경우가 많습니다.
이 경우 워크플로 내부에서 변경 사항을 감지하고 그 결과에 따라 분기합니다.
변경 감지 작업
dorny/paths-filter 작업은 diff를 검사하고 이름이 지정된 각 경로 그룹에 대해 불리언 값을 출력합니다.
이후 작업은 해당 출력을 읽고 실행 여부를 결정합니다.
- uses: dorny/paths-filter@v3
id: changes
with:
filters: |
api:
- 'services/api/**'
web:
- 'services/web/**'감지된 변경 사항에 따른 작업 실행 제어
감지 작업은 출력을 제공하고, 후속 작업은 needs 컨텍스트와 함께 if를 사용하여 조건부로 실행됩니다.
build-api:
needs: detect
if: needs.detect.outputs.api == 'true'
runs-on: ubuntu-latest
steps:
- run: ./build-api.sh출력 연결
다른 작업이 읽을 수 있도록 감지 작업에서 필터 결과를 전달하는 outputs를 선언해야 합니다.
detect:
runs-on: ubuntu-latest
outputs:
api: ${{ steps.changes.outputs.api }}
web: ${{ steps.changes.outputs.web }}동적 매트릭스
여러 서비스가 있는 경우 변경된 경로에서 매트릭스를 동적으로 만들 수 있으므로 변경된 서비스만 매트릭스에 포함됩니다.
한 작업에서 JSON 목록을 생성하고 다음 작업의 매트릭스에 전달합니다.
strategy:
matrix:
service: ${{ fromJSON(needs.detect.outputs.list) }}감지를 위한 Git diff
원시 git으로도 변경 사항을 감지할 수 있습니다. 현재 커밋과 기준 커밋을 비교하여 변경된 디렉터리를 나열합니다.
git diff --name-only origin/main...HEAD | cut -d/ -f1-2 | sort -u필수 검사와 건너뛰기
주의하세요. 변경 사항이 없어 필수 상태 검사를 건너뛰면 브랜치 보호가 해당 검사를 기다리며 병합을 차단할 수 있습니다.
해결책은 항상 성공하고 유일한 필수 검사가 되며 조건부 작업의 결과를 요약하는 최종 게이트 작업을 추가하는 것입니다.
gate:
needs: [build-api, build-web]
if: always()
runs-on: ubuntu-latest
steps:
- run: echo 'all required jobs resolved'패키지별 캐시
선택적 빌드는 패키지별 캐시와 잘 맞습니다. 각 서비스의 잠금 파일을 기준으로 캐시 키를 설정하면 관련 없는 변경으로 인해 캐시가 무효화되지 않습니다.
두 가지를 함께 사용하면 저장소가 커져도 모노레포 파이프라인을 빠르게 유지할 수 있습니다.
빠른 확인
선택적 빌드를 어떻게 사용하는지 이해했는지 테스트해 보세요.
요약
변경된 부분만 빌드하는 방법을 배웠습니다.
paths와paths-ignore는 전체 워크플로의 실행을 제어합니다.- 변경 감지 작업은 경로별 불리언 값을 출력합니다.
- 작업은
if와needs를 사용하여 조건부로 실행되며, 매트릭스도 동적으로 만들 수 있습니다. - 필수 검사와의 호환성을 위해
always()게이트 작업을 추가합니다.
선택적 빌드는 모노레포 CI/CD를 빠르고 경제적으로 유지합니다.
AI 튜터와 함께 CI/CD with GitHub Actions & DevOps Pipelines을(를) 배우세요 — 무료
브라우저에서 실제 코드를 작성하고 실행하며, 24/7 AI 튜터로부터 즉각적인 도움을 받고, 웹이나 앱에서 중단한 부분부터 계속 학습하세요.
- 코스
- 12
- 레슨
- 48
자주 묻는 질문
“경로 필터링 및 선택적 빌드” 강의는 무료인가요?
네 — “경로 필터링 및 선택적 빌드” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 CI/CD with GitHub Actions & DevOps Pipelines 강의 전체를 잠금 해제할 수 있습니다. CI/CD with GitHub Actions & DevOps Pipelines 강의에는 총 4개의 강의가 포함되어 있습니다.
“경로 필터링 및 선택적 빌드”에서 뭘 배우나요?
모노레포와 여러 저장소 환경에서 경로 필터, 변경 감지, 조건부 행렬을 사용해 변경의 영향을 받은 워크플로와 작업만 실행되도록 해 보세요. 브라우저에서 직접 실행하는 실습 코드로 CI/CD with GitHub Actions & DevOps Pipelines을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
CI/CD with GitHub Actions & DevOps Pipelines을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 CI/CD with GitHub Actions & DevOps Pipelines은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 4번째 강의입니다.
“경로 필터링 및 선택적 빌드” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 CI/CD with GitHub Actions & DevOps Pipelines 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 CI/CD with GitHub Actions & DevOps Pipelines 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.
이 강의의 모든 강의
- 모노레포를 위한 CI/CD
- 저장소 간 워크플로
- 중앙 집중식 워크플로 관리
- 경로 필터링 및 선택적 빌드