Workflow 파일 이름과 조직

~9 min · organization, naming, convention

Level 0Apprentice

0 XP0/101 lessons0/10 achievements

0/120 XP to next level120 XP to go0% complete

지루한 파일명이 몇 년 동안 임대료를 벌어

Actions UI 는 .github/workflows 디렉토리 안에서 파일명 알파벳 순으로 workflow 정렬. name: 은 UI 에 표시; 파일명은 URL 과 grep 에 표시. 둘이 일치해야 해.

따라할 컨벤션

ci.yml — 품질 검사: lint, type-check, test.
release.yml — tag push 시 도는 거, artifact 빌드 & 게시.
deploy-staging.yml, deploy-prod.yml — environment deploy, 분리된 gate 위해 분리된 파일.
nightly.yml — 예약 job.
dependabot-auto-merge.yml — 작은 admin 자동화.
codeql.yml — 보안 스캔.
docs.yml — docs build / deploy.

하지 말 것

모든 걸 main.yml 에 쏟지 마. 검색과 re-run 이 끔찍해져.
날짜로 이름 붙이지 마 (v2-2026-04-ci.yml) — versioning 은 git 의 일.
공백이나 특수 문자 쓰지 마; 소문자 + 하이픈 고수.
같은 name: 인 workflow 여러 개 만들지 마 — UI 빨리 혼란.

Code

전형적인 실제 .github/workflows 디렉토리·bash

ls .github/workflows/
# ci.yml
# release.yml
# deploy-staging.yml
# deploy-prod.yml
# nightly.yml
# codeql.yml
# dependabot-auto-merge.yml

# Each file declares one purpose. The set, read top-to-bottom, is
# the entire CI/CD story for the repo.

External links

GitHub — Workflow file location

Exercise

관리하는 repo 의 workflow 파일 나열. 각각 파일명이 목적을 묘사하는지 판단. 안 하는 거 이름 바꿔 (단일 PR 충분). 외부에서 참조하는 URL 은 consumer redirect 없이 이름 바꾸지 마.

Progress

Progress is local-only — sign in to sync across devices.

← PreviousWorkflow run Next →퀴즈 · 5 questions

이 페이지에서 버그를 발견하셨거나 피드백이 있으세요?문제 신고

🔔 답글 알림 (로그인 필요)

로그인 — 댓글을 남기려면 로그인해 주세요.

아직 댓글이 없어요. 첫 댓글을 남겨보세요.