39일차. IT 개념 정리

 

---

깃허브 액션(GitHub Actions)에서 사용되는 용어인 액션(Action), 스테이지(Stage), **태스크(Task)**는 소프트웨어 개발 라이프사이클을 자동화하는 워크플로우(Workflow)의 구성 요소를 나타냅니다.

다만, GitHub Actions의 공식 문서에서는 주로 워크플로우(Workflow), 작업(Job), 단계(Step), **액션(Action)**이라는 용어를 사용하며, **스테이지(Stage)**나 **태스크(Task)**는 **작업(Job)**이나 **단계(Step)**와 같은 다른 구성 요소를 설명하기 위해 더 일반적으로 사용되는 용어입니다.

⚙️ 주요 구성 요소 설명

1. 액션 (Action)

• 재사용 가능한 코드 단위입니다.
• 워크플로우의 **단계(Step)**에서 실행할 수 있는 가장 작은 단위의 작업입니다.
• 자체적으로 코드를 작성하거나, GitHub Marketplace에서 다른 사람이 만든 액션을 가져와 사용할 수 있습니다.
• 예시: 코드를 체크아웃하는 actions/checkout, Node.js 환경을 설정하는 actions/setup-node.

2. 작업 (Job)

• **워크플로우 내에서 실행되는 일련의 단계(Steps)**입니다.
• 하나의 **러너(Runner)**에서 실행되며, 러너는 가상 환경(VM) 또는 컨테이너일 수 있습니다.
• 기본적으로 **병렬(Parallel)**로 실행되지만, needs 키워드를 사용하여 **순차적(Sequential)**으로 실행되도록 종속성을 설정할 수 있습니다.
• 일반적으로 빌드, 테스트, 배포와 같은 큰 태스크 또는 스테이지를 나타냅니다.

3. 단계 (Step)

• 작업(Job) 내에서 순서대로 실행되는 개별 명령입니다.
• 단계는 다음 두 가지 중 하나를 수행할 수 있습니다.
  1. 스크립트 실행(run): 셸 명령(예: npm install, npm test)을 직접 실행합니다.
  2. 액션 사용(uses): 위에서 설명한 **액션(Action)**을 실행합니다.
• 단계는 작업 내에서 정보를 공유할 수 있습니다.

---

🏗️ 스테이지와 태스크

GitHub Actions의 공식적인 용어는 아니지만, CI/CD(지속적 통합/지속적 배포) 맥락에서 다음과 같이 이해할 수 있습니다.

스테이지 (Stage)

• 일반적인 CI/CD 파이프라인에서 Build(빌드), Test(테스트), **Deploy(배포)**와 같이, 전체 프로세스를 논리적으로 구분하는 큰 단위를 의미합니다.
• GitHub Actions에서는 이러한 스테이지의 개념이 보통 작업(Job) 단위로 구현됩니다. 즉, '빌드' 스테이지는 하나의 작업으로, '테스트' 스테이지는 다른 작업으로 정의될 수 있습니다.

태스크 (Task)

• 일반적으로 수행해야 하는 구체적인 활동을 의미합니다.
• GitHub Actions에서는 작업(Job) 자체가 하나의 주요 태스크로 간주되거나, **단계(Step)**가 개별적인 태스크로 간주될 수 있습니다.
• 예: "의존성 설치", "코드 컴파일", "단위 테스트 실행" 등은 모두 단계(Step)로 구현되는 태스크입니다.

요약

용어	GitHub Actions 구성 요소	설명
스테이지 (Stage)	작업 (Job)	빌드, 테스트, 배포와 같은 프로세스의 주요 논리적 단계입니다.
태스크 (Task)	작업 (Job) 또는 단계 (Step)	수행해야 하는 구체적인 활동을 나타냅니다.
액션 (Action)	액션 (Action)	단계 내에서 사용되는 재사용 가능한 코드 단위입니다.

 

---

FastAPI의 데코레이터(Decorator) vs Spring의 어노테이션(Annotation) 차이점

FastAPI의 “데코레이터”와 Spring의 “어노테이션”은 겉으로 보면 역할이 비슷해 보이지만, 동작 방식과 철학이 완전히 다릅니다.
아래에서 한국 개발자 관점에서 가장 이해하기 쉽게 비교해 드릴게요.

---

h2️⃣ 1. 핵심 차이 요약

구분FastAPI (Python)Spring (Java/Kotlin)

개념	함수 위에 붙이는 데코레이터 문법	클래스/메서드에 붙이는 메타데이터 기반 어노테이션
동작 방식	함수를 다른 함수로 감싸서 기능을 확장	리플렉션(Reflection) 기반으로 프레임워크가 동작을 해석
실행 시점	코드 실행 시 즉시 적용(런타임)	주로 컴파일·런타임에서 프레임워크가 읽어 처리
주요 사용 목적	라우트 등록, 미들웨어, 검증 등	의존성 주입, AOP, 설정, 라우팅 등 프레임워크 구성 요소
언어 특성 반영	Python의 고차 함수, 데코레이터 문법 활용	Java/Kotlin의 정적 타입 + 리플렉션 기반 메타데이터 시스템

---

h2️⃣ 2. FastAPI의 데코레이터

FastAPI에서 사용하는 데코레이터는 순수 Python 문법입니다.

✔ 특징

• 함수에 기능을 “감싸서” 추가하는 패턴
• FastAPI는 이 문법을 이용해 라우팅을 처리함
• 데코레이터가 함수 객체 자체를 조작함

✔ 예시

 

@app.get("/users") def get_users(): return {"users": []}

여기서 @app.get()은
→ get_users 함수를 FastAPI 라우터에 직접 등록하는 함수입니다.

즉,

데코레이터 = “함수에 기능을 추가하는 Python 기능”

---

h2️⃣ 3. Spring의 어노테이션(Annotation)

Spring의 어노테이션은 Java/Kotlin의 메타데이터 시스템입니다.

✔ 특징

• 주석처럼 보이지만 실제로는 클래스/메서드의 의미를 정의하는 메타데이터
• Spring이 런타임에서 리플렉션으로 읽고 동작을 구성함
• 의존성 주입(DI), AOP, 트랜잭션, 미들웨어 구성 등 프레임워크 전반을 제어

✔ 예시

 

@GetMapping("/users") public List<User> getUsers() { ... }

여기서 @GetMapping은
→ 이 메서드가 "HTTP GET 요청을 처리하는 핸들러"라는 메타데이터입니다.
이 정보를 Spring이 읽어서 내부적으로 DispatcherServlet 라우팅을 설정합니다.

즉,

어노테이션 = “프레임워크가 읽어서 동작을 구성하는 메타데이터”

---

h2️⃣ 4. 동작 구조 비교 (쉽게 설명)

🔹 FastAPI

• @데코레이터가 함수 자체를 감싸서 새로운 기능을 주입
  → 함수형 프로그래밍 기반

🔹 Spring

• @어노테이션은 단지 “표식”
  → 실제 동작은 Spring 프레임워크가 리플렉션으로 읽어서 처리
  → 메타데이터 기반 프레임워크 구성 방식

---

h2️⃣ 5. 쉽게 이해하는 한국식 비유

• FastAPI 데코레이터
  → 함수에 직접 양념을 바르는 느낌 (함수 자체가 변함)
• Spring 어노테이션
  → 벤치에 “유료 자리” 스티커를 붙여두면
  관리자가 나중에 그걸 보고 요금을 매기는 것
  (실제 행동은 스프링이 한다)

---

h2️⃣ 6. 결론

관점FastAPI 데코레이터Spring 어노테이션

본질	함수 변환기	메타데이터
실행 방식	함수 래핑(wrap)	리플렉션을 통한 프레임워크 제어
역할	라우터 등록 중심	DI, AOP, 라우팅, 설정 등 전 영역
범위	로직 단위	애플리케이션 전체 구조 단위

즉, FastAPI는 Python의 문법을 활용하고,
Spring은 프레임워크가 중심이 되어 어노테이션을 해석하는 구조라는 차이입니다.

 

 

---

 

 

dataclass