🌱 환경 변수 (Environment Variables)

FastAPI와 같은 백엔드 애플리케이션을 만들 때 반드시 함께 이해해야 하는 개념이 있다.

바로 환경 변수(Environment Variables)다.

---

🤔 환경 변수란?

단어부터 차근히 풀어보자.

• Environment → 프로그램이 실행되는 주변 환경
• Variable → 값을 담는 변수

즉, 환경 변수란

👉 운영체제(OS)에 저장되어 있고, 프로그램이 읽어올 수 있는 값

중요한 점은 이 값이

• Python 코드 밖에 존재하고
• 프로그램 실행 시 필요할 때 읽어온다

---

🏠 비유로 이해하기

환경 변수는 집 앞에 붙어 있는 주소판과 같다.

• 집 안(코드)에는 없음
• 집 밖(운영체제)에 붙어 있음
• 집을 고쳐도 주소판은 그대로 유지됨

👉 코드를 수정하지 않고도 설정 값을 바꿀 수 있게 해주는 장치다

---

💡 환경 변수가 중요한 이유

이유	설명
보안	비밀번호, API 키를 코드에 직접 쓰지 않아도 됨
환경 분리	개발 / 테스트 / 운영 환경을 쉽게 구분 가능
유연성	같은 코드로 다른 설정을 사용 가능
표준	현대 웹 서비스의 기본 설정 방식

👉 FastAPI, Docker, AWS, Kubernetes 모두 환경 변수 기반 설정을 기본 전제로 한다

---

🖥️ 터미널에서 환경 변수 설정하기

Linux / macOS / Git Bash

# 환경 변수 설정
export MY_NAME="철수"

# 환경 변수 사용
echo "안녕하세요 $MY_NAME"

출력 결과:

안녕하세요 철수

Windows (PowerShell)

$Env:MY_NAME = "철수"
echo "안녕하세요 $Env:MY_NAME"

---

🐍 Python에서 환경 변수 읽기

운영체제에 설정된 환경 변수는 Python 코드에서 os.getenv로 읽을 수 있다.

예제: main.py

import os

# 환경 변수 읽기 (없으면 기본값 사용)
name = os.getenv("MY_NAME", "World")

print(f"Hello {name} from Python")

환경 변수가 없으면 기본값 "World"가 사용된다.

---

🔁 실행 흐름 정리

• 터미널에서 환경 변수를 설정한다
• Python 프로그램을 실행한다
• Python은 운영체제에 요청해서 값을 읽는다

👉 Python은 환경 변수를 저장하지 않는다
단지 요청해서 읽어올 뿐이다

---

⚠️ 중요한 규칙: 환경 변수는 항상 문자열

환경 변수는 운영체제 레벨에 존재하기 때문에 항상 문자열(str)로 전달된다.

import os

port_str = os.getenv("PORT", "8000")
print(type(port_str))  # <class 'str'>

# 숫자가 필요하면 직접 변환
port = int(port_str)
print(type(port))      # <class 'int'>

👉 타입 변환은 개발자의 책임이다

---

⏱️ 일회성 환경 변수 설정

특정 명령어를 실행할 때만 환경 변수를 쓰고 싶을 수도 있다.

MY_NAME="영희" python main.py

• 이 명령어가 실행되는 동안만 적용되고
• 프로그램이 종료되면 사라진다

---

🧭 PATH 환경 변수

PATH는 운영체제가 실행할 프로그램을 찾는 경로 목록이다.

터미널에서 python을 입력하면,

• PATH에 등록된 디렉토리를 순서대로 검색하고
• 가장 먼저 발견된 python을 실행한다

예시 (Linux / macOS)

/usr/local/bin:/usr/bin:/bin

앞에서 배운 가상 환경이 동작하는 이유도 바로 이 PATH 때문이다.

---

📌 Twelve-Factor App과 환경 변수

환경 변수 기반 설정은 Twelve-Factor App이라는 현대 애플리케이션 설계 원칙의 핵심이다.

👉 설정은 코드에 넣지 말고 환경에 둬라

---

✅ 핵심 요약

• 환경 변수는 운영체제에 저장된 설정 값이다
• 코드 밖에 존재하며, 실행 시 읽어온다
• 항상 문자열로 전달된다
• 보안과 환경 분리를 위해 필수적이다
• FastAPI 프로젝트에서는 반드시 사용하게 된다