14강 / 20강

배포 — 코드를 서버에 올리기

git clone · 가상환경 · pip, 그리고 순서의 중요성

내 노트북에서는 쇼핑몰이 잘 돌아갑니다. 이제 서버에 올릴 차례예요. "파일을 복사하면 되는 거 아닌가요?" 거의 맞지만, 세 가지 함정이 있습니다.

①코드는 어떻게 옮기나USB? 이메일? → git

②라이브러리는?Flask 가 서버엔 없다 → pip

③다른 앱과 충돌하면?Flask 버전이 서로 다르다 → 가상환경

고등학생코드를 서버에 올리기

1~13강이 준비였다면 여기부터 실전입니다.

내 컴퓨터에서 돌던 코드를 서버에서 돌게 한다

순서가 중요합니다

순서	하는 일
1	계정을 만든다 (13강)
2	코드를 가져온다 (git clone)
3	가상환경을 만든다
4	의존 패키지 설치 (pip)
5	설정을 넣는다
6	실행해 본다

1번을 빠뜨리고 root 로 하는 것이 가장 흔한 실수

왜 git 으로 가져오나

방법	문제
파일을 직접 복사	버전을 모른다 · 되돌릴 수 없다
git clone	버전이 기록된다 ✔

문제가 생기면 이전 버전으로 되돌린다 — 이게 결정적이다

비유 — 이사

방식	결과
짐을 막 싣는다	뭘 가져왔는지 모른다
목록을 적고 싣는다	빠진 것을 안다 ✔

requirements.txt 가 그 목록이다

목록이 없으면 내 컴퓨터에서는 되는데 서버에서 안 되는 일이 생깁니다.

1단계 · 코드 가져오기

git clone 은 저장소의 코드를 통째로 내려받습니다. USB로 옮기는 것과 달리, 나중에 git pull 한 줄로 업데이트할 수 있어요.

코드를 서버로 가져옵니다

bash 내 가상 Ubuntu 서버에서 실행

cd ~
git clone https://github.com/school/newshop.git
ls newshop

2단계 · 가상환경 만들기

서버 한 대에 앱이 여러 개 돌 수 있습니다. A앱은 Flask 2.0, B앱은 Flask 3.1이 필요하다면? 서버 전체에 하나만 깔면 싸움이 납니다.

가상환경(virtual environment)은 프로젝트마다 자기만의 라이브러리 창고를 갖게 해 줍니다. 7강에서 배운 폴더 하나가 통째로 그 창고예요.

.venv 폴더 안에 이 프로젝트 전용 파이썬이 생깁니다

bash 내 가상 Ubuntu 서버에서 실행

cd ~/newshop
python3 -m venv .venv
ls .venv/bin

고등학생.venv 는 그냥 폴더입니다

note 의 이 설명이 가상환경의 신비를 풀어 줍니다.

특별한 마법이 아니다 — 파이썬과 라이브러리가 든 폴더

안에 뭐가 있나

경로	담긴 것
`.venv/bin/python`	파이썬 실행 파일 (링크)
`.venv/bin/pip`	이 환경 전용 pip
`.venv/lib/…`	설치된 라이브러리

지우려면 폴더를 지우면 끝이다 — 흔적이 안 남는다

activate 가 하는 일

이것도 마법이 아닙니다. PATH 를 바꿀 뿐이에요.

전	후
PATH = /usr/bin:…	PATH = .venv/bin:/usr/bin:…

python 을 치면 .venv 것이 먼저 잡힌다 — 11강의 PATH

그래서 activate 없이도 됩니다

.venv/bin/python app.py      # activate 없이 ✔

15강 systemd 에서는 이 방식을 쓴다 — activate 를 못 하니까

비유 — 도시락과 구내식당

	구내식당 (시스템)	도시락 (venv)
메뉴	모두 같다	각자 다르다 ✔
바뀌면	전원 영향	나만
버리면	—	흔적 없다

12강의 apt/pip 충돌이 이 폴더 하나로 해결된다

3단계 · 라이브러리 설치

requirements.txt 는 필요한 라이브러리 목록입니다. 이 파일 하나로 어느 서버에서든 똑같은 환경을 다시 만들 수 있어요.

목록을 보고 한꺼번에 설치

bash 내 가상 Ubuntu 서버에서 실행

cd ~/newshop
cat requirements.txt
.venv/bin/pip install -r requirements.txt

🎮 배포 실험실

배포 단계를 순서를 바꿔서 해 보세요. 순서가 틀리면 어디서 무엇이 깨지는지 알려 줍니다.

고등학생환경 변수와 비밀 관리

배포에서 가장 자주 사고가 나는 부분입니다.

비밀번호를 코드에 적지 않는다

왜 안 되나

위험	설명
git 에 올라간다	지워도 이력에 남는다 ⚠
공개 저장소면	몇 분 안에 봇이 찾는다
환경마다 다르다	개발·운영이 같은 코드여야

git 이력은 지워도 남는다 — 커밋을 지워도 복구된다

그래서 환경 변수로

DB_PASSWORD=비밀 python app.py

코드에서는 os.environ["DB_PASSWORD"] 로 읽습니다.

환경	같은 코드 · 다른 값
개발	개발 DB
운영	운영 DB

코드는 하나, 설정은 환경마다 — 12요소 앱 원칙

.env 파일을 쓸 때

반드시	왜
`.gitignore` 에 넣는다	올라가지 않게
권한 600	7강 — 나만 읽게
예시 파일을 따로	`.env.example` 로 키 이름만

3강의 "숨김 파일은 보호가 아니다" — 권한으로 막는다

비유 — 열쇠를 문 앞 매트 밑에

편하지만 도둑도 아는 곳입니다.

보관	안전한가
코드에 적기	매트 밑 ⚠
환경 변수 · 600 파일	금고 ✔

15강에서 systemd 의 EnvironmentFile 로 넣는다

4단계 · 자리 잡기

앱이 놓일 자리와 권한을 정해야 합니다. 여기서 7강의 지식이 쓰입니다.

코드644실행할 필요 없음. 읽기만

폴더755들어가려면 x 가 필요합니다

스크립트755실행 권한 필요

비밀 파일600DB 비밀번호·API 키

우리 쇼핑몰의 권한 상태 점검

bash 내 가상 Ubuntu 서버에서 실행

cd ~/shop
ls -l
ls -ld data

진짜로 돌려 보기 전 마지막 확인

배포한 앱이 진짜 도는지 보려면? 직접 실행해 봅니다.

healthz 는 '살아 있니?'를 묻는 관례적인 주소입니다

bash 내 가상 Ubuntu 서버에서 실행

cd ~/shop
cat README.md
curl http://127.0.0.1:8000/healthz

고등학생healthz — 살아 있는지 묻는 주소

note 가 소개하는 헬스 체크가 운영의 기본입니다.

앱이 스스로 "나 괜찮아요" 라고 답하는 주소

왜 필요한가

확인 방법	알 수 있는 것
프로세스가 살아 있나	죽지는 않았다 — 그뿐
healthz 응답	일을 할 수 있나 ✔

살아 있는데 일을 못 하는 상태가 있다 — 좀비

그런 상태의 예

상황	프로세스는
DB 연결이 끊김	살아 있다
스레드가 전부 멈춤	살아 있다
메모리가 꽉 참	살아 있다

"떠 있다" 와 "된다" 는 다른 말이다

비유 — 병문안

확인	알 수 있는 것
숨은 쉬나	살아 있다
말을 걸어 본다	의식이 있나 ✔

대답이 와야 정말 괜찮은 것이다

두 종류의 체크

종류	묻는 것	실패하면
liveness	살아 있나	재시작
readiness	요청 받을 준비가 됐나	트래픽을 안 준다

시작 중인 앱에 요청을 보내면 다 실패한다 — 그래서 둘을 나눈다

왜 이름이 healthz 인가

구글 관례입니다. 끝에 z 를 붙여 사람이 쓰는 주소와 구별했어요.

/health 는 진짜 페이지일 수 있지만 /healthz 는 아니다

🤔 확인 문제

파이썬 프로젝트마다 가상환경(.venv)을 따로 만드는 이유는?

🤔 확인 문제

requirements.txt 가 하는 일은?

해설 pip install -r requirements.txt 한 줄로 목록 전체가 설치됩니다. "내 컴퓨터에선 됐는데" 문제를 막는 가장 기본적인 장치입니다.

🤔 확인 문제

웹 앱을 root 계정으로 실행하면 안 되는 이유는?