AI 개발 · 실무
AI와 함께 만드는 웹 서비스 - 설계도에서 배포·운영까지
서버와 배포 구조 - 리버스 프록시·애플리케이션·DB
요청이 서버에 닿기까지(DNS·TLS·리버스 프록시·애플리케이션·DB), 설정을 환경별로 나누기, 상태 확인 주소(healthz), 배포 전 점검표, 순차 교체와 되돌리기, 완성 코드는 설정 파일 묶음을 검사해 빠진 값·위험한 값을 보고하는 배포 전 점검기
개발자KR · 원고 갱신
이 장에서 배우는 것
앞 장에서 모임 공지와 참가 신청의 동작을 테스트했다. 이제 같은 프로그램을 서버에 올릴 때 무엇을 연결하고 무엇을 확인할지 정한다. 참가 신청 테스트가 통과해도 도메인이 엉뚱한 서버를 가리키거나 운영 설정에 개발용 값이 남아 있으면 주민은 사이트를 이용할 수 없다. 이 장에서는 브라우저에서 데이터베이스까지 요청이 지나는 경로를 그리고, 배포에 쓸 설정 파일을 읽어 누락과 위험을 보고하는 점검기를 만든다.
- 이름 조회, 암호화 연결, 요청 전달, 데이터 저장을 각각 어느 구성 요소가 맡는지 설명한다.
- 개발과 운영의 설정을 파일로 나누고, 선택한 환경의 값만 읽는다.
- 상태 확인 주소의 응답으로 새 인스턴스에 요청을 전달해도 될지 판단한다.
- 인스턴스를 순서대로 교체할 때 멈출 조건과 이전 버전으로 되돌릴 조건을 정한다.
- 설정 점검기의 정상·실패 사례를 실행하고, 인공지능이 제안한 검사 조건을 변경 내역과 대조한다.
문제 상황
동네 소모임 사이트에 다음 주 산책 모임을 올렸다. 새 버전에서는 공지 화면에 신청 마감 여부를 표시한다. 개발 환경에서 공지를 열고 참가 신청을 저장하는 테스트는 모두 통과했다. 그런데 배포 직전 설정을 열어 보니 운영 파일에 개발용 디버그 설정이 남아 있다. 서버가 시작됐다는 메시지는 보이지만, 새 인스턴스를 거친 참가 신청이 어느 데이터베이스에 저장될지 확인한 사람은 없다.
운영 중인 인스턴스가 두 개라면 한쪽을 교체하는 동안 다른 쪽에서 요청을 받을 수 있다. 여기서 인스턴스란 같은 애플리케이션을 실행하는 개별 단위다. 새 인스턴스에 요청을 전달하기 전에 데이터베이스를 읽을 수 있는지 확인하고, 실제 참가 신청을 처리할 준비가 되었는지도 살펴야 한다. 두 인스턴스를 모두 교체한 뒤에야 문제를 발견하면 기존 버전이 요청을 받아 줄 기회가 줄어든다. 배포 담당자는 파일만 봐도 걸러낼 수 있는 실수부터 자동으로 찾고, 실제 서버에서 확인할 항목은 별도로 기록하기로 했다.
브라우저에서 데이터베이스까지
주민이 브라우저에 https://meet.example/meetings를 입력한다. 도메인 이름 시스템(DNS)은 meet.example에 연결할 주소를 찾는 데 쓰인다. 브라우저는 찾은 주소에 연결하고 전송 계층 보안(TLS) 절차로 인증서가 요청한 이름에 유효한지 확인한 뒤 통신을 암호화한다. 이 예에서 meet.example은 설명용 이름이다. 이름 조회나 인증서 확인을 실습에서 실행할 필요는 없다.
이 배포 구조에서는 리버스 프록시(reverse proxy)가 브라우저의 암호화 연결을 받는다. 프록시는 요청을 읽고 전달 규칙에 따라 애플리케이션 인스턴스 하나를 고른다. 브라우저가 보는 공개 주소는 그대로 두고, 프록시가 요청을 보내는 내부 대상을 바꿀 수 있다. 브라우저와 프록시 사이, 프록시와 애플리케이션 사이는 서로 다른 연결이다. 운영에서 두 구성 요소를 서로 다른 호스트에 둔다면 내부 연결을 암호화할지와 어떤 네트워크에서 접근을 허용할지를 따로 정한다.
애플리케이션은 공지 목록을 요청받으면 데이터베이스(DB)에서 모임을 읽고 응답을 만든다. 참가 신청을 받으면 마감 여부 등 서비스 규칙을 확인하고 신청을 저장한다. 저장이 성공한 뒤에야 신청 완료 응답을 보낼 수 있다. 애플리케이션이 만든 응답은 프록시를 거쳐 브라우저로 돌아간다. 이름 조회가 실패하면 브라우저는 연결할 주소를 얻지 못한다. 반면 프록시까지 연결한 뒤 오류가 발생하면 프록시의 전달 대상, 애플리케이션의 응답, 데이터베이스 연결 순으로 확인할 수 있다.
환경을 나누고 상태 확인 주소를 만들기
배포할 환경을 먼저 선택한다
개발과 운영에서 같은 코드를 실행하고, 환경에 따라 달라지는 값은 설정에 둔다. 이 실습에서는 development.ini와 production.ini를 사용한다. [app]에는 실행 환경과 디버그 여부, [proxy]에는 공개 주소와 암호화 연결을 받는 지점, [database]에는 SQLite 파일 경로를 기록한다. 배포 작업이 먼저 의도한 환경을 정하고 파일 안의 환경 값과 비교한다. 운영 배포에 개발 파일이 들어왔는데 파일의 environment = development에 맞춰 개발 기준을 적용하면 배포 대상을 잘못 골랐다는 사실을 놓친다.
점검기에서 public_origin은 사용자가 접속하는 기준 주소다. 스킴과 호스트, 필요하면 포트까지 적는다. 모임 목록의 /meetings 같은 경로는 화면에 접근할 때 덧붙인다. 이 장의 운영 배포안에서는 프록시가 암호화 연결을 받기로 했으므로 공개 주소는 https, tls_termination은 proxy여야 한다. 이 값들은 파일에 적은 배포 의도를 보여 준다. 실제 연결에서 어떤 인증서가 제공되고 프록시가 어디로 요청을 넘기는지는 배포 대상에서 확인한다.
이 실습의 운영용 SQLite는 절대 경로의 파일을 사용한다. 상대 경로는 실행 작업 디렉터리가 달라지면 다른 파일을 가리킬 수 있다. 실제 배포에서는 같은 호스트의 인스턴스가 서비스 계정으로 같은 영속 파일을 열 수 있는지 확인한다. 이 설명의 순차 교체 예도 같은 호스트를 전제로 한다. 서로 다른 호스트에 같은 경로 문자열을 적으면 각 호스트의 로컬 파일을 가리킨다. 실습 코드는 임시 디렉터리에만 파일을 만들고, 운영 설정 파일에 적힌 경로로 파일을 열지는 않는다.
상태 확인 응답의 의미를 정한다
프록시나 배포 담당자가 GET /healthz로 새 인스턴스의 요청 수신 준비 상태를 확인한다고 가정한다. 이 장에서는 모임 테이블을 대상으로 가벼운 읽기 질의가 성공하면 200과 ok를 돌려준다. 데이터베이스 오류가 나면 503과 unavailable을 돌려준다. 예외에 들어 있는 파일 경로나 질의 내용은 응답에 넣지 않는다. 모임이 아직 하나도 없는 서비스에서도 빈 결과를 정상으로 처리한다.
이 확인으로 애플리케이션이 모임 테이블을 읽을 수 있다는 점을 알 수 있다. 참가 신청의 쓰기 권한, 로그인 동작, 데이터 변경 전후의 호환성은 각각의 확인이 필요하다. 애플리케이션에 직접 상태 확인 요청을 보내 성공해도 공개 주소에서 이름 조회와 암호화 연결이 성공한다는 보장은 없다. 실행 예에서는 처리 함수를 직접 호출하며, 실제 배포에서는 내부 대상과 공개 경로에서 각각 응답을 확인한다.
배포 전 점검과 순차 교체
설정 파일 검사에 실패하면 인스턴스 교체를 시작하지 않는다. 파일 검사를 통과하면 공개 경로, 데이터 경로, 이전 버전의 가용성을 확인한다. 아래 표에서 자동으로 확인하는 항목은 이 장의 프로그램에 들어 있다. 실제 환경에서 확인하는 항목은 배포 담당자가 결과와 확인 위치를 남긴다.
| 확인 대상 | 자동 검사 | 실제 환경에서 확인할 것 |
|---|---|---|
| 환경과 디버그 | 필수 값, 환경 일치, 운영의 false | 새 프로세스가 승인한 운영 파일을 읽는지 확인한다. |
| 공개 주소와 프록시 | 주소 형식, 운영의 https와 proxy | 이름 조회 결과, 인증서의 이름과 유효 기간, 프록시 전달 대상을 확인한다. |
| 데이터베이스 | 운영 파일 경로가 절대 경로인지 확인 | 서비스 계정으로 같은 파일을 읽고 쓸 수 있는지, 백업을 복원할 수 있는지 확인한다. |
| 요청 수신 준비 | 상태 확인 함수의 200과 503을 실습에서 검증 | 새 인스턴스의 내부 주소에서 응답을 확인하고, 연결 후 공개 경로에서 공지를 연다. |
| 이전 버전 | 해당 없음 | 이전 실행 파일과 설정을 확보하고 현재 데이터 구조로 실행할 수 있는지 확인한다. |
인스턴스 A와 B가 요청을 받고 있다고 하자. 먼저 B만으로 예상되는 요청을 처리할 수 있는지 확인한다. 프록시가 A에 새 요청을 배정하지 않도록 하고 A가 이미 받은 요청을 마치면 A를 새 버전으로 바꾼다. 배포 작업에서 정한 제한 시간 안에 A의 /healthz가 성공하면 A를 전달 대상에 다시 넣는다. 공개 경로의 공지 응답을 확인하고, 준비해 둔 시험용 모임에서 신청 저장을 점검한다. 이 과정을 통과한 뒤 B를 교체한다. 각 인스턴스가 어떤 버전인지와 프록시에서 요청을 받고 있는지를 함께 기록하면 어느 시점에 멈췄는지 알 수 있다.
A에서 상태 확인이 실패하면 B 교체를 시작하지 않는다. 이미 A를 프록시에 연결한 뒤 문제가 발견됐다면 먼저 A에 새 요청을 배정하지 않도록 한다. 진행 중인 요청이 끝나면 A의 실행 파일과 설정을 이전 버전으로 되돌리고, 상태 확인을 다시 통과한 뒤 연결한다. 이전 버전을 실행할 수 있어도 새 버전이 데이터 구조를 바꿨다면 이전 코드가 그 구조를 읽거나 쓸 수 있는지 확인해야 한다. 배포 중 두 버전이 함께 실행될 수 있으므로 양쪽에서 쓸 수 있는 구조를 먼저 적용하고, 이전 버전이 쓰던 구조를 제거하는 작업은 호환성이 필요 없어진 뒤로 미룬다. 백업 시점 이후에 받은 참가 신청도 있으므로 코드 교체와 데이터 복원은 각각의 영향 범위를 확인해 결정한다.
인공지능(AI) 코딩 도구에는 검사 범위와 실패 조건을 명시한다. 받은 답변의 변경 내역(diff)을 읽을 때에는 어떤 값이 오류에서 정상으로 바뀌는지 추적하고, 그 차이를 드러내는 입력으로 확인한다. 다음 표는 이 장에서 재현할 요청과 검토 예다.
| 보낸 요청문 | 받은 결과 | 사람이 고친 부분 | 확인한 방법 |
|---|---|---|---|
| 운영 파일을 검사하고 필수 값이 빠지면 위치를 보고해 줘. 배포 환경은 호출자가 지정해. | 파일에 적힌 환경을 읽어 검사 기준을 결정했다. | 호출자가 준 환경으로 검사하고 파일과 다르면 오류를 추가했다. | 변경 내역에서 운영 분기의 기준 값을 확인하고 개발 파일을 운영 기준으로 검사했다. |
운영 디버그는 false만 허용해 줘. 오타도 보고해. | true일 때만 운영 오류를 냈다. | 허용 문자열을 먼저 검사해 flase도 오류로 잡았다. | 허용값 검사가 운영 정책 검사보다 앞에 있는지 읽고 오타 입력으로 확인했다. |
상태 확인에서 모임 테이블을 읽고 실패하면 503을 돌려줘. | 테이블을 읽은 뒤 행이 있는지 검사했다. | 빈 결과도 허용하고 질의를 수행할 수 있는지를 기준으로 삼았다. | 같은 연결에서 빈 테이블을 만들기 전후의 응답을 각각 확인했다. |
완성 코드
main.py
기본 실행은 임시 설정 묶음을 만들고 정상과 실패 사례를 차례대로 출력한 뒤 끝난다. 경로를 인자로 주면 해당 디렉터리에서 development.ini와 production.ini를 검사한다. 이 모드의 종료 코드는 통과하면 0, 문제가 있으면 1이다. 인자를 두 개 이상 주면 사용법을 출력하고 2로 끝난다. 상태 확인 예제는 기본 실행에서만 메모리 데이터베이스로 확인한다.
import configparser
from contextlib import closing
from pathlib import Path
import sqlite3
import sys
from tempfile import TemporaryDirectory
from urllib.parse import urlsplit
REQUIRED = {
"app": ("environment", "debug"),
"proxy": ("public_origin", "tls_termination"),
"database": ("path",),
}
ENVIRONMENTS = ("development", "production")
def read_origin_scheme(origin):
if any(character.isspace() for character in origin):
return None
if any(mark in origin for mark in ("?", "#", "\\")):
return None
try:
parts = urlsplit(origin)
host = parts.hostname
port = parts.port
except ValueError:
return None
if (
parts.scheme not in {"http", "https"}
or not host
or parts.username is not None
or parts.netloc.endswith(":")
or parts.path not in {"", "/"}
or (port is not None and port == 0)
):
return None
return parts.scheme
def check_file(path, expected_environment):
config = configparser.ConfigParser(interpolation=None)
try:
with path.open(encoding="utf-8") as source:
config.read_file(source)
except FileNotFoundError:
return ["설정 파일이 없다."]
except (OSError, UnicodeError, configparser.Error):
return ["설정 파일을 읽거나 해석할 수 없다."]
if config.defaults():
return ["[DEFAULT]에 값을 둘 수 없다."]
issues = []
values = {}
for section, keys in REQUIRED.items():
for key in keys:
label = f"{section}.{key}"
value = config.get(section, key, fallback="").strip()
if value:
values[label] = value
else:
issues.append(f"{label} 값이 빠졌다.")
environment = values.get("app.environment")
if environment and environment != expected_environment:
issues.append(f"app.environment는 {expected_environment}이어야 한다.")
production = expected_environment == "production"
debug = values.get("app.debug")
if debug:
if debug not in {"true", "false"}:
issues.append("app.debug는 true 또는 false여야 한다.")
elif production and debug == "true":
issues.append("운영에서는 app.debug를 false로 설정해야 한다.")
origin = values.get("proxy.public_origin")
if origin:
scheme = read_origin_scheme(origin)
if scheme is None:
issues.append("proxy.public_origin에 공개 기준 주소를 적어야 한다.")
elif production and scheme != "https":
issues.append("운영 공개 주소는 https여야 한다.")
termination = values.get("proxy.tls_termination")
if termination:
if termination not in {"proxy", "none"}:
issues.append("proxy.tls_termination은 proxy 또는 none이어야 한다.")
elif production and termination != "proxy":
issues.append("운영에서는 프록시가 TLS 연결을 받아야 한다.")
database = values.get("database.path")
if production and database and not Path(database).is_absolute():
issues.append("운영 DB는 절대 경로의 파일을 사용해야 한다.")
return issues
def report_bundle(directory):
failed = False
for environment in ENVIRONMENTS:
filename = f"{environment}.ini"
issues = check_file(directory / filename, environment)
if issues:
failed = True
print(f"{filename} - 문제 {len(issues)}건")
for issue in issues:
print(f" - {issue}")
else:
print(f"{filename} - 통과")
return int(failed)
def handle_request(method, path, database):
if path != "/healthz":
return 404, "not found"
if method != "GET":
return 405, "method not allowed"
try:
database.execute("SELECT id FROM meetings LIMIT 1").fetchone()
except sqlite3.Error:
return 503, "unavailable"
return 200, "ok"
def demo():
development = """[app]
environment = development
debug = true
[proxy]
public_origin = http://localhost:8000
tls_termination = none
[database]
path = :memory:
"""
production = """[app]
environment = production
debug = false
[proxy]
public_origin = https://meet.example
tls_termination = proxy
[database]
path = {database}
"""
with TemporaryDirectory() as temporary:
directory = Path(temporary).resolve()
development_file = directory / "development.ini"
production_file = directory / "production.ini"
development_file.write_text(development, encoding="utf-8")
production_file.write_text(
production.format(database=directory / "meetings.sqlite3"),
encoding="utf-8",
)
print("정상 설정 묶음")
if report_bundle(directory) != 0:
raise RuntimeError("정상 설정 검사가 실패했다.")
production_file.write_text(
development.replace("path = :memory:\n", "path =\n"),
encoding="utf-8",
)
print("\n잘못된 설정 묶음")
if report_bundle(directory) != 1:
raise RuntimeError("잘못된 설정을 통과시켰다.")
if len(check_file(production_file, "production")) != 5:
raise RuntimeError("예상한 설정 문제 수와 다르다.")
production_file.write_text(
production.format(database="meetings.sqlite3").replace(
"debug = false", "debug = flase"
),
encoding="utf-8",
)
expected = [
"app.debug는 true 또는 false여야 한다.",
"운영 DB는 절대 경로의 파일을 사용해야 한다.",
]
if check_file(production_file, "production") != expected:
raise RuntimeError("디버그 오타 또는 DB 경로 검사를 확인해야 한다.")
print("\n상태 확인")
with closing(sqlite3.connect(":memory:")) as database:
before = handle_request("GET", "/healthz", database)
database.execute("CREATE TABLE meetings (id INTEGER PRIMARY KEY)")
after = handle_request("GET", "/healthz", database)
if (before, after) != ((503, "unavailable"), (200, "ok")):
raise RuntimeError("상태 확인 응답이 예상과 다르다.")
print(f"테이블 생성 전 - {before[0]} {before[1]}")
print(f"테이블 생성 후 - {after[0]} {after[1]}")
return 0
def main(arguments):
if len(arguments) == 0:
return demo()
if len(arguments) == 1:
return report_bundle(Path(arguments[0]))
print("사용법 python3 main.py [설정_디렉터리]", file=sys.stderr)
return 2
if __name__ == "__main__":
raise SystemExit(main(sys.argv[1:]))
줄별 해설
REQUIRED는 검사할 구역과 키를 선언한다. 예를 들어proxy.public_origin은[proxy]구역의public_origin을 뜻한다. 딕셔너리의 삽입 순서대로 누락을 확인하므로 여러 값이 빠져도 보고 순서가 일정하다. 파일 이름도ENVIRONMENTS로 순서를 고정한다.read_origin_scheme()은 문자열을 주소 구성 요소로 나눈다.parts.port를 읽는 줄에서 숫자가 아니거나 허용 범위를 넘는 포트가 오류로 드러난다. 경로는 없거나/만 허용하고, 사용자 정보나 질의 문자열이 있으면 거부한다. 이 함수는 공개 주소의 형식을 가볍게 확인한다. 호스트 이름이 실제로 등록되어 있는지와 어떤 주소로 해석되는지는 별도의 확인 사항이다.check_file()은 값을 그대로 읽도록 INI의 문자열 치환을 끈다. 파일 누락, 읽기 오류, INI 문법 오류를 검사 결과로 바꾼다. 오류 메시지에 행 원문을 덧붙이지 않으므로 설정 값이 출력으로 새어 나갈 가능성을 줄인다.[DEFAULT]에 값이 있으면 필수 키에 기본값이 상속될 수 있으므로 이 실습의 파일 형식에서는 이를 오류로 처리한다.config.get()의 기본값은 빈 문자열이다. 구역이나 키가 없을 때도 누락으로 처리하고,strip()으로 앞뒤 공백을 제거한 뒤 빈 값인지 확인한다. 이후의 정책 검사는 값이 있을 때 수행한다. 예를 들어 운영 DB 경로가 비었으면 누락 한 건만 출력한다. 값이 상대 경로라면 절대 경로를 사용해야 한다는 메시지가 나온다.production = expected_environment == "production"은 운영 정책을 적용할 기준을 정한다. 운영 파일 안에 개발 환경이 적혀 있어도 운영 디버그, 공개 주소, 프록시 설정 검사를 그대로 적용한다.Path.is_absolute()는 경로 문자열을 검사한다. 파일 생성, 접근 권한 확인, 데이터베이스 연결은 이 줄에서 일어나지 않는다.report_bundle()은 첫 파일에서 문제가 나와도 다음 파일을 읽는다. 배포 담당자는 한 번 실행해 두 파일의 문제를 볼 수 있다.failed가 참이면 반환값은1이다. 실제 배포 스크립트는 이 반환값을 프로세스 종료 코드로 받아 교체를 시작할지 결정할 수 있다.handle_request()의 인자는 요청 메서드, 경로, 데이터베이스 연결이다.SELECT id FROM meetings LIMIT 1은 모임 테이블과 필요한 열을 읽을 수 있는지 확인한다. 결과가 없으면fetchone()은None을 반환하고, 질의가 성공했으므로 함수는200을 돌려준다. 실제 HTTP 응답으로 옮길 때405에는 허용하는 메서드를Allow헤더에 적는다. 이 함수는 상태 코드와 본문을 직접 비교할 수 있도록 두 값만 반환한다.demo()는 임시 디렉터리에서 두 설정 파일을 만들고 운영 파일만 차례로 바꿔 검사한다. 첫 실패 사례는 개발용 값이 운영 파일에 들어간 상황이다. 두 번째 실패 사례는 디버그 오타와 상대 경로를 함께 검사하고 예상 메시지와 비교한다. 마지막으로 메모리 데이터베이스에서 모임 테이블을 만들기 전과 만든 직후를 비교한다.closing()은 이 확인이 끝나면 연결을 닫고, 임시 디렉터리의 설정 파일은 해당 블록을 벗어날 때 정리된다.
실행 결과
파일을 main.py로 저장한다. 아래 명령 중 첫 줄은 경고를 오류로 처리하도록 설정한 상태에서 컴파일하고, 성공하면 출력 없이 끝난다. 컴파일 결과는 __pycache__에 저장된다. 두 번째 줄은 예제의 설정 검사와 상태 확인 검사를 실행한다.
python3 -W error -m py_compile main.py
python3 main.py
두 번째 명령의 예상 출력은 다음과 같다. 임시 경로는 실행할 때마다 달라질 수 있으므로 보고서에 경로 값을 출력하지 않는다. 기본 실행에는 의도적으로 잘못된 설정이 들어 있으며, 예상대로 문제를 찾아내면 기본 실행 자체는 성공으로 끝난다.
정상 설정 묶음
development.ini - 통과
production.ini - 통과
잘못된 설정 묶음
development.ini - 통과
production.ini - 문제 5건
- database.path 값이 빠졌다.
- app.environment는 production이어야 한다.
- 운영에서는 app.debug를 false로 설정해야 한다.
- 운영 공개 주소는 https여야 한다.
- 운영에서는 프록시가 TLS 연결을 받아야 한다.
상태 확인
테이블 생성 전 - 503 unavailable
테이블 생성 후 - 200 ok
자신이 만든 설정 묶음을 검사할 때는 두 INI 파일을 넣어 둔 디렉터리를 넘긴다. 아래 명령은 현재 디렉터리의 설정 묶음을 검사한다. 파일이 없으면 이름별로 누락을 보고한다.
python3 main.py .
실무에서 자주 틀리는 것
디버그 문자열을 바로 불리언으로 바꾼다
bool()은 문자열이 비어 있는지 확인한다. 비어 있지 않은 "false"도 참이므로 디버그가 켜진다. 다음 코드는 두 판정의 차이를 실행해 보여 준다.
raw_debug = "false"
wrong_debug = bool(raw_debug)
print(wrong_debug)
if raw_debug not in {"true", "false"}:
raise ValueError("디버그 설정을 확인한다.")
fixed_debug = raw_debug == "true"
print(fixed_debug)
첫 줄에는 True, 둘째 줄에는 False가 나온다. 허용값 검사를 먼저 두면 flase 같은 오타도 설정 오류로 드러난다.
파일 안의 환경 이름으로 검사 기준을 정한다
파일 이름을 바꾸는 과정에서 개발용 값이 운영 파일에 남을 수 있다. 첫 분기는 파일 내용을 기준으로 삼으므로 이 상황에서 운영 디버그를 허용한다. 둘째 분기는 배포 작업이 선택한 환경으로 판단한다.
expected_environment = "production"
file_environment = "development"
debug_enabled = True
wrong_reject = file_environment == "production" and debug_enabled
print(wrong_reject)
fixed_reject = expected_environment == "production" and debug_enabled
print(fixed_reject)
첫 결과는 False, 둘째 결과는 True다. 완성 코드에서는 환경 이름의 불일치도 별도 메시지로 보고한다.
프로세스가 실행 중이면 요청을 받을 준비가 됐다고 본다
첫 응답은 데이터베이스에 모임 테이블이 없어도 성공이다. 둘째 응답은 완성 코드의 함수를 호출한다. 아래 코드는 main.py와 같은 디렉터리에서 별도 Python 파일로 실행할 수 있다.
from contextlib import closing
import sqlite3
from main import handle_request
with closing(sqlite3.connect(":memory:")) as database:
wrong_response = (200, "ok")
print(wrong_response)
print(handle_request("GET", "/healthz", database))
둘째 응답은 (503, 'unavailable')이다. 프록시가 이 상태의 인스턴스로 새 요청을 보내면 공지 읽기가 실패할 수 있으므로, 배포 과정에서 전달 대상에 넣기 전에 상태 확인 결과를 사용한다.
한눈에 보기
| 구성 요소 또는 작업 | 맡은 일 | 확인할 결과 |
|---|---|---|
| 이름 조회와 암호화 연결 | 공개 이름에서 접속 주소를 찾고 암호화된 통신을 연다. | 의도한 주소에 도달하고 인증서가 공개 이름에 유효하다. |
| 프록시 | 요청을 받을 인스턴스를 선택한다. | 전달 대상에 준비된 인스턴스가 등록되어 있다. |
| 애플리케이션과 DB | 모임 공지를 읽고 참가 신청을 처리한다. | 같은 서비스 데이터를 사용하며 조회와 저장이 성공한다. |
| 환경별 설정 점검 | 필수 값과 운영 정책을 검사한다. | 두 파일이 통과하고 점검기가 0으로 끝난다. |
| 상태 확인과 순차 교체 | 새 인스턴스를 확인한 뒤 다음 교체를 결정한다. | 성공하면 연결하고, 실패하면 교체를 멈추고 복구한다. |
이 장에서는 배포를 진행할지 판단하는 지점을 만들었다. 다음에는 배포 후에도 공지와 참가 신청이 제대로 처리되는지 로그와 지표로 확인하고, 이상이 생겼을 때 어느 경로부터 살필지 다룬다.
연습 문제
- 운영 설정에서
public_origin = https://meet.example/meetings로 바꾼다. 다른 값이 모두 올바를 때 점검기의 메시지와 종료 코드를 예상한다. - 올바른 운영 설정에서
[database]구역의path를 지운 뒤, 같은 값을[DEFAULT]에 적는다. 어떤 메시지가 먼저 나오며, 왜 이 형식을 사용하지 않는지 설명한다. - 완성 코드에서 빈 모임 테이블을 만든 뒤 데이터베이스 연결을 닫고
handle_request("GET", "/healthz", database)를 호출한다. 상태 코드와 본문을 예상하고, 빈 테이블을 읽었을 때와 다른 이유를 설명한다. - A를 새 버전으로 교체한 직후
/healthz는 성공했지만 시험용 참가 신청 저장에 실패했다. B는 이전 버전으로 요청을 받고 있다. 다음 교체를 시작할지 결정하고, A를 되돌리기 전에 확인할 데이터 조건을 하나 적는다.
정답과 해설
proxy.public_origin에 공개 기준 주소를 적어야 한다.가 나오고 종료 코드는1이다./meetings는 모임 목록을 요청하는 경로다. 기준 주소에는https://meet.example을 적는다.[DEFAULT]에 값을 둘 수 없다.가 먼저 나온다. 파서는 기본값을 다른 구역에 상속할 수 있다. 이 실습은 환경별 파일에서 필수 값의 위치를 직접 확인할 수 있도록 기본값을 쓰는 파일을 처음에 반환한다.응답은
503 unavailable이다. 닫힌 연결에서 질의를 실행하면 SQLite 오류가 발생한다. 연결이 열린 상태에서 빈 테이블을 읽으면 질의에 성공하고 결과의 행 수가 없으므로200 ok가 나온다.B를 교체하지 않는다. A가 새 요청을 받지 않게 하고 진행 중인 요청이 끝나기를 기다린다. A의 이전 버전이 현재 데이터 구조에서 참가 신청을 읽고 쓸 수 있는지 확인한다. 되돌린 A를 다시 연결하기 전에 상태 확인과 시험용 신청을 확인한다. 상태 확인의 읽기 질의가 통과해도 신청에 필요한 쓰기 과정은 실패할 수 있다.
READER FEEDBACK
질문·의견
내용에 관한 질문이나 더 나은 설명을 위한 의견을 남겨 주세요. 오탈자는 위의 제보 양식이 더 빨리 반영됩니다. 이 댓글은 원래 게시글과 같은 자리에 쌓입니다.
댓글 0
아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.