본문으로 건너뛰기
CI/CD 시각화

GitHub Actions 시각화 도구

GitHub Actions 워크플로 YAML을 붙여넣으면 job 사이의 의존 관계(needs)를 읽어 Mermaid 플로차트로 만듭니다. job은 상자, needs는 화살표로 그려지므로 어떤 job이 병렬로 돌고 어떤 job이 앞선 job을 기다리는지 한눈에 보여 CI가 느린 원인을 찾는 데 도움이 됩니다. needs에 적은 job 이름이 없으면 빨간 점선으로 표시해 실행 전에 오타를 찾을 수 있습니다. 출력은 GitHub의 README·이슈·PR에 그대로 붙일 수 있는 Mermaid 문법이며, job 이름과 의존 관계를 입력해 needs가 들어간 YAML 템플릿을 만들 수도 있습니다. step·matrix·if 조건은 상세 표시를 켜면 상자 안에 나옵니다. 모든 처리는 브라우저 안에서 이루어지며 YAML은 전송되지 않습니다.

입력한 YAML과 표시 옵션은 이 브라우저에 자동으로 저장됩니다(서버로 보내지 않습니다). 다음에 열어도 이어서 쓸 수 있습니다.

graph TD A[Start] --> B[Input YAML] B --> C[Visualize]

워크플로 보안 검사

위 YAML에서 흔한 보안·유지보수 문제를 찾습니다(고정되지 않은 action, 넓은 토큰 권한, 스크립트 인젝션, pull_request_target 등). 텍스트만 읽으며 실행이나 전송은 하지 않습니다.

    실행 횟수와 비용 추정

    각 job의 matrix(include·exclude 포함)를 펼쳐 실행 횟수를 세고, 과금되는 분을 추정합니다. 등록해야 할 secrets와 변수도 나열합니다. 위의 YAML만 읽습니다.

    가이드

    사용 방법 및 특징

    • GitHub Actions YAML을 "워크플로 YAML 입력"란에 붙여넣습니다.
    • "시각화하기" 버튼을 클릭하면 오른쪽에 다이어그램이 렌더링됩니다.
    • 작업 간의 의존성(needs)은 화살표(-->)로 그려집니다.
    • "Mermaid 코드 복사"를 클릭하여 GitHub Markdown 등 Mermaid를 지원하는 도구에서 사용할 수 있는 코드를 가져옵니다.
    샘플

    입출력 예시

    기본적인 작업 의존성

    입력 예시
    jobs:
      build:
        runs-on: ubuntu-latest
      test:
        needs: build
        runs-on: ubuntu-latest
      deploy:
        needs: test
        runs-on: ubuntu-latest
    출력 예시
    graph TD
      build
      test
      build --> test
      deploy
      test --> deploy
    FAQ

    자주 묻는 질문

    • 큰 워크플로도 시각화할 수 있나요?

      네, 가능하지만 작업 수가 매우 많은 경우(수십 개 이상) 다이어그램이 너무 커져 읽기 어려울 수 있습니다. 이럴 때는 워크플로를 논리적인 단위로 나누어 시각화하는 것을 권장합니다.
    • "needs" 외의 의존성도 지원하나요?

      현재 이 도구는 "needs" 속성으로 정의된 작업 수준의 의존성만 시각화합니다. 작업 내부의 개별 단계(steps)는 시각화되지 않습니다.
    • 입력한 YAML 데이터는 안전한가요?

      네, 모든 처리는 브라우저에서 로컬로 실행됩니다. 데이터가 서버로 전송되지 않으므로 비공개 또는 기업용 워크플로 설정도 안심하고 사용할 수 있습니다.
    활용

    주요 활용 사례

    • `needs` 연결과 실행 순서를 한눈에 확인

      워크플로 YAML을 붙여넣으면 job은 상자, `needs`는 화살표로 그려집니다. 어떤 job이 병렬로 돌고 어떤 job이 앞선 job을 기다리는지 보여서, CI가 느린 원인(직렬로 이어진 job)을 찾기 쉬워집니다.
    • `needs` 오타 찾기

      `needs`에 적은 job 이름이 존재하지 않으면 그 job은 빨간 점선으로 그려집니다. `build`를 `biuld`로 쓴 것 같은 오타를 워크플로를 실행하기 전에 알 수 있습니다.
    • README·설계 문서에 워크플로 도표 넣기

      출력은 Mermaid 문법입니다. GitHub의 README, 이슈, PR에 그대로 붙이면 도표로 렌더링됩니다. YAML을 고친 뒤 다시 붙여넣기만 하면 도표를 최신으로 유지할 수 있습니다.
    • 새 워크플로의 뼈대 만들기

      job 이름·`runs-on`·의존 관계를 입력하면 `needs`가 들어간 YAML 템플릿도 만들 수 있습니다. 빌드→테스트→배포 같은 흐름을 먼저 도표로 확인한 뒤 작성할 수 있습니다.
    주의

    주의 사항·제한

    • job 사이의 `needs`만 그립니다

      step의 내용, `matrix`, `if` 조건, 트리거(`on`), 재사용 워크플로(`uses`)의 전개는 도표에 나오지 않습니다. 실제 실행 순서는 이러한 조건에 따라 달라질 수 있습니다.
    • 워크플로의 올바름은 검증하지 않습니다

      YAML로 읽히고 `jobs`가 있으면 도표로 그립니다. GitHub 스키마에 맞는지, `runs-on`이나 `uses` 값이 유효한지, `needs`가 순환하지 않는지는 확인하지 않습니다. 검증은 GitHub에서의 실행이나 `actionlint`로 하세요.
    • 표시 이름은 `name`, 없으면 job ID입니다

      job에 `name`이 있으면 그것이, 없으면 job ID가 상자에 표시됩니다. Mermaid 예약어나 기호가 들어간 ID는 도표 안에서 안전한 내부 이름으로 바뀌어 그려지지만, 표시되는 글자는 달라지지 않습니다.
    • 생성되는 YAML은 템플릿입니다

      `push`로 동작하고 각 job이 `echo`만 실행하는 최소한의 YAML을 만듭니다. 실제 step, `on` 트리거, `secrets` 등은 직접 추가하세요. 시크릿 값은 YAML에 쓰거나 붙여넣지 마세요(입력은 브라우저 안에서 처리되며 전송되지 않습니다).
    소개

    이 도구에 대하여

    GitHub Actions 시각화 도구

    GitHub Actions workflow의 jobs, dependencies, needs 관계를 시각적으로 확인합니다. 복잡한 CI/CD pipeline을 이해하고 병목이나 잘못된 dependency를 찾는 데 도움을 줍니다.

    활용 예시

    • CI/CD 흐름 검토: job 실행 순서를 이해합니다.
    • Dependency 디버깅: needs 관계가 의도와 맞는지 확인합니다.
    • Pipeline 문서화: workflow 구조를 팀에 공유합니다.

    중요한 workflow를 수정할 때는 permissions, secrets, trigger 조건도 함께 검토하세요.

    이 도구의 관련 기사

    최신 아티클