Stream

Lesson 12 of 12 · published

워크플로 파일 이름과 조직

~9 min · organization, naming, convention

Level 0견습생

0 XP0/101 lessons0/10 achievements

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

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

Actions UI는 .github/workflows 디렉토리 안에서 파일명 알파벳 순으로 워크플로를 정렬해. name:은 UI에 표시되고, 파일명은 URL과 grep에 표시돼. 둘이 일치해야 해.

따라할 컨벤션

ci.yml — 품질 검사: lint, type-check, 테스트.
release.yml — 태그 푸시 시 도는 거, 아티팩트 빌드 & 게시.
deploy-staging.yml, deploy-prod.yml — 환경 배포, 분리된 게이트를 위해 파일을 분리.
nightly.yml — 예약된 작업.
dependabot-auto-merge.yml — 작은 관리 자동화.
codeql.yml — 보안 스캔.
docs.yml — 문서 빌드 / 배포.

하지 말 것

모든 걸 main.yml에 쏟지 마. 검색과 재실행이 끔찍해져.
날짜로 이름 붙이지 마 (v2-2026-04-ci.yml) — 버전 관리는 git의 일이야.
공백이나 특수 문자 쓰지 마; 소문자 + 하이픈을 고수해.
같은 name:인 워크플로 여러 개 만들지 마 — 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

관리하는 저장소의 워크플로 파일을 나열해. 각각 파일명이 목적을 묘사하는지 판단해. 안 하는 거는 이름을 바꿔 (단일 PR이면 충분해). 외부에서 참조하는 URL은 사용자 리다이렉트 없이 이름 바꾸지 마.

Progress

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

← Previous워크플로 실행 Next →퀴즈 · 5 questions

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

댓글 0

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

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

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