[Terraform 튜토리얼 1-1] 여러 번 눌러도 괜찮아! 멱등성(Idempotence)이라는 개념

[Terraform 튜토리얼 1-1] 여러 번 눌러도 괜찮아! 멱등성(Idempotence)이라는 개념

인프라 자동화나 Terraform 같은 Infrastructure as Code(IaC)를 접하다 보면 Idempotence라는 단어를 종종 마주하게 되는데요. 처음 들으면 뭔가 굉장히 있어 보이는 용어지만, 사실 우리가 일상 속에서도 자주 겪는 개념입니다.


✅ Idempotence란?

같은 작업을 여러 번 수행해도, 결과가 변하지 않는 성질을 말합니다.

즉, 특정 명령이나 실행을 여러 번 반복해도 결과(시스템 상태)가 동일하게 유지된다면, 그 프로세스는 Idempotent(멱등적)하다고 부를 수 있습니다.


🚦 예시: 횡단보도의 보행 버튼

일본 같은 경우 횡단보도를 건널 때, 보행자 버튼이 있어 클릭 시 일정 시간 후 빨간불이 파란불로 바뀌게 됩니다.

  • 이 버튼을 한 번 누르면 일정 시간이 지난 후 신호가 바뀝니다.
  • 열 번 눌러도, 결과는 같습니다. 신호는 제시간에 바뀔 뿐, 더 빨라지거나 바뀌지 않죠.

이 버튼은 idempotent 하다고 할 수 있습니다.


💸 반례: 은행에 돈 입금하기

반대로, 은행 창구에 가서 만 원을 입금하는 상황을 봅시다.

  • 첫 번째 입금: 잔액이 +만 원
  • 두 번째 입금: 잔액이 +2만 원...

즉, 같은 행위를 반복할 때마다 결과가 누적되므로 비-idempotent 한 행동입니다.
(당연히 돈 입금이 idempotent 하면 안 되겠죠!)


🛠️ Terraform은 왜 Idempotent 할까?

Terraform에서 terraform apply를 실행하면, 코드에 정의된 목표 상태(desired state)에 따라 인프라를 구성합니다.

  • 처음 실행: 정의된 리소스를 생성
  • 두 번째 실행: 이미 존재하므로 아무 작업도 하지 않음
  • 세 번째 실행: 역시 상태가 같으면 변경사항 없음 (No changes)

즉, Terraform은 “이미 원하는 상태에 도달했다면 더 이상 손대지 않는다”는 철학을 따릅니다.

이는 마치 신호등 보행 버튼처럼, “원하는 상태가 정의되어 있고, 이미 도달했다면 그대로 유지”해주는 성질입니다.


💡 왜 중요한가?

멱등성(Idempotence)은 IaC 도구 사용에 있어 매우 중요한 특성입니다.

  • 예측 가능성: 같은 코드를 여러 번 실행해도 결과가 달라지지 않음
  • 자동화 신뢰성: CI/CD 파이프라인 등 반복 작업에 안심하고 쓸 수 있음
  • 불필요한 리소스 재생성 방지: 운영 환경을 안정적으로 유지

📌 정리하자면

Idempotence = 같은 입력 → 같은 결과, 반복해도 변하지 않음
Terraform은 이 멱등성 덕분에 인프라를 신뢰성 있게 자동화할 수 있습니다.

🔜 다음 글 예고

다음 글에서는 immutability(불변성)에 대해 다뤄보겠습니다.
IaC와 DevOps에서 멱등성과 불변성은 늘 짝꿍처럼 붙어 다니거든요!

[Terraform 튜토리얼 1-2] 누가 내 설정 바꿨지? 그래서 필요한 불변 인프라
Immutable Infrastructure(불변 인프라) — 최근 클라우드와 DevOps, IaC(코드형 인프라)에서 자주 등장하는 멋진 용어지만, 실제로 어떤 의미일까요? 그리고 Terraform과 같은 도구에서는 어떻게 활용될까요? 이번 글에서는 Immutability(불변성)이라는 개념이 인프라에서 왜 중요한지, 실무에서는 어떻게 적용되는지에 대해 다뤄보겠습니다. ✅ Immutability vs. Mutability Immutability(불변성)이란, 한 번 생성된 대상은 변경하지 않고,

Read more

Lumen - AI Agent를 위한 지속 가능한 두뇌

Lumen - AI Agent를 위한 지속 가능한 두뇌

왜 만들었는가 AI 에이전트는 모든 대화를 기억상실증 상태에서 시작합니다. Claude Code, Cursor, Codex, Mastra 하네스, LangChain 파이프라인 — 이 도구들은 세상을 알지만 당신의 세상은 전혀 모릅니다. 당신이 읽은 200편의 논문, 당신이 출시하는 코드베이스, 지난 분기에 내린 아키텍처 결정, 새벽 2시에 그 버그를 잡아냈을 때 마침내 통했던 트래젝토리. 모든 세션이 같은 컨텍스트를

By Sardor Madaminov

200 OK, 텅 빈 body — Starlette Race Condition 장애 분석기

발생일: 2026-04-23 / 해결일: 2026-04-27 영향 범위: report-dev.machine365.ai 전체 API 들어가며 API가 200 OK를 반환하는데 body가 비어있다. 프론트엔드에는 아무것도 안 뜨고, Swagger UI(/docs)도 빈 화면. 그런데 로컬에서 돌리면 멀쩡하다. 배경은 이랬다. 미터링(Metering) 기능을 만들면서 API 호출 로그를 수집할 미들웨어를 작성했다. Spring Boot 백엔드에 먼저 적용하고, Python

By Jeonggil