django-deploy-probes

이 문서는 문서 홈의 한국어 번역본입니다.

Django deployment probe endpoint를 제공합니다.

설치

pip install django-deploy-probes

선택적으로 Redis와 Celery readiness check를 extras로 설치할 수 있습니다.

pip install "django-deploy-probes[redis]"
pip install "django-deploy-probes[celery]"
pip install "django-deploy-probes[all]"

빠른 시작

Include 방식 URL 설정

from django.urls import include, path

urlpatterns = [
    path("", include("django_deploy_probes.urls")),
]

Import 방식 URL 설정

from django.urls import path
from django_deploy_probes.views import healthz, readyz, startupz, version

urlpatterns = [
    path("healthz/", healthz),
    path("readyz/", readyz),
    path("startupz/", startupz),
    path("version/", version),
]

/readyz의 사용자 정의 check 메시지는 기본적으로 숨겨집니다. EXPOSE_CHECK_MESSAGES=True를 사용하는 경우 메시지에 secret이나 민감한 값을 포함하지 마세요.

Security check는 기본적으로 REMOTE_ADDR을 사용합니다. Trusted reverse proxy 뒤에서 probe에 접근하는 경우 TRUSTED_PROXY_NETWORKS와 CLIENT_IP_HEADER를 설정해 원래 client IP를 안전하게 판별하세요.

빌드 및 배포

빌드

uv build

생성된 distribution은 dist/에 기록됩니다.

생성 파일:

• dist/django_deploy_probes-0.3.1.tar.gz
• dist/django_deploy_probes-0.3.1-py3-none-any.whl

설치 테스트

빌드 후 clean environment에서 wheel을 설치해 확인합니다.

python -m venv /tmp/django-deploy-probes-install-test
source /tmp/django-deploy-probes-install-test/bin/activate
pip install dist/django_deploy_probes-0.3.1-py3-none-any.whl
python -c "import django_deploy_probes; print(django_deploy_probes.__version__)"

PyPI 배포

GitHub Release를 발행하면 .github/workflows/publish.yml이 PyPI Trusted Publishing으로 배포합니다.

영어 문서 홈으로 돌아가기