자습서: Azure Database for PostgreSQL - 유연한 서버를 사용하여 AKS에 Django 앱 배포

아티클
08/15/2024

적용 대상: Azure Database for PostgreSQL - 유연한 서버

이 빠른 시작에서는 Azure CLI를 통해 Azure Database for PostgreSQL 유연한 서버를 사용하여 AKS(Azure Kubernetes Service) 클러스터에 Django 애플리케이션을 배포합니다.

AKS는 클러스터를 빠르게 배포하고 관리할 수 있는 관리형 Kubernetes 서비스입니다. Azure Database for PostgreSQL 유연한 서버는 데이터베이스 관리 기능 및 구성 설정에 대한 보다 세부적인 제어와 유연성을 제공하도록 설계된 완전 관리형 데이터베이스 서비스입니다.

참고 항목

이 빠른 시작에서는 Kubernetes 개념, Django 및 PostgreSQL에 대한 기본 지식이 있다고 가정합니다.

필수 구성 요소

Azure를 구독하고 있지 않다면 시작하기 전에 Azure 체험 계정을 만듭니다.

새 브라우저 창에서 Azure Cloud Shell을 시작합니다. 로컬 머신에도 Azure CLI를 설치할 수 있습니다. local install을 사용하는 경우 az login 명령을 사용하여 Azure CLI에 로그인합니다. 인증 프로세스를 완료하려면 터미널에 표시되는 단계를 수행합니다.
az version을 실행하여 설치된 버전과 종속 라이브러리를 찾습니다. 최신 버전으로 업그레이드하려면 az upgrade를 실행합니다. 이 문서에는 최신 버전의 Azure CLI가 필요합니다. Azure Cloud Shell을 사용하는 경우 최신 버전이 이미 설치되어 있습니다.

리소스 그룹 만들기

Azure 리소스 그룹은 Azure 리소스가 배포되고 관리되는 논리 그룹입니다. eastus 위치에서 az-group-create 명령을 사용하여 django-project 리소스 그룹을 만들어 봅시다.

az group create --name django-project --location eastus

참고 항목

리소스 그룹의 위치는 리소스 그룹 메타데이터가 저장되는 위치입니다. 또한 리소스를 만드는 동안 다른 지역을 지정하지 않은 경우 리소스가 Azure에서 실행되는 위치이기도 합니다.

다음 예제 출력에서는 성공적으로 만들어진 리소스 그룹이 나와 있습니다.

{
  "id": "/subscriptions/<guid>/resourceGroups/django-project",
  "location": "eastus",
  "managedBy": null,
  
  "name": "django-project",
  "properties": {
    "provisioningState": "Succeeded"
  },
  "tags": null
}

AKS 클러스터 만들기

az aks create 명령을 사용하여 AKS 클러스터를 만듭니다. 다음 예제에서는 하나의 노드가 있는 djangoappcluster라는 클러스터를 만듭니다. 이 작업을 완료하는 데는 몇 분 정도 걸립니다.

az aks create --resource-group django-project --name djangoappcluster --node-count 1 --generate-ssh-keys

몇 분 후 명령이 완료되면 클러스터에 대한 JSON 형식 정보가 반환됩니다.

참고 항목

AKS 클러스터를 만들 때 AKS 리소스를 저장하기 위해 두 번째 리소스 그룹이 자동으로 만들어집니다. AKS를 통해 두 개의 리소스 그룹이 만들어지는 이유는 무엇인가요?를 참조하세요.

클러스터에 연결

Kubernetes 클러스터를 관리하려면 Kubernetes 명령줄 클라이언트인 kubectl을 사용합니다. Azure Cloud Shell을 사용하는 경우 kubectl이 이미 설치되어 있습니다.

참고 항목

Azure CLI를 로컬로 실행하는 경우 az aks install-cli 명령을 실행하여 kubectl을 설치합니다.

Kubernetes 클러스터에 연결하도록 kubectl을 구성하려면 az aks get-credentials 명령을 사용합니다. 이 명령은 자격 증명을 다운로드하고 Kubernetes CLI가 해당 자격 증명을 사용하도록 구성합니다.

az aks get-credentials --resource-group django-project --name djangoappcluster

클러스터에 대한 연결을 확인하려면 kubectl get 명령을 사용하여 클러스터 노드 목록을 반환합니다.

kubectl get nodes

다음 예제 출력은 이전 단계에서 만든 단일 노드를 보여줍니다. 노드 상태가 준비인지 확인합니다.

NAME                       STATUS   ROLES   AGE     VERSION
aks-nodepool1-31718369-0   Ready    agent   6m44s   v1.12.8

Azure Database for PostgreSQL 유연한 서버 인스턴스 만들기

az postgreSQL flexible-server create 명령을 사용하여 Azure Database for PostgreSQL 유연한 서버 인스턴스를 만듭니다. 다음 명령은 Azure CLI의 로컬 컨텍스트에 있는 서비스 기본값 및 값을 사용하여 서버를 만듭니다.

az postgres flexible-server create --public-access all

생성된 서버에는 다음과 같은 특성이 있습니다.

새 빈 데이터베이스(postgres): 서버를 처음 프로비저닝하면 이 데이터베이스가 만들어집니다. 이 빠른 시작에서는 이 데이터베이스를 사용합니다.
자동 생성된 서버 이름, 관리 사용자 이름, 관리자 암호, 리소스 그룹 이름(로컬 컨텍스트에서 아직 지정되지 않은 경우) 및 리소스 그룹과 동일한 위치에 있습니다.
public-access 인수를 사용하면 올바른 사용자 이름과 암호를 사용하여 모든 클라이언트에 대한 퍼블릭 액세스가 가능한 서버를 만들 수 있습니다.
명령에서 로컬 컨텍스트를 사용하므로 django-project 리소스 그룹 및 eastus 지역에 서버를 만듭니다.

Django docker 이미지 빌드

새 Django 애플리케이션을 만들거나 기존 Django 프로젝트를 사용합니다. 코드가 이 폴더 구조에 있는지 확인합니다.

└───my-djangoapp
    └───views.py
    └───models.py
    └───forms.py
    ├───templates
          . . . . . . .
    ├───static
         . . . . . . .
└───my-django-project
    └───settings.py
    └───urls.py
    └───wsgi.py
        . . . . . . .
    └─── Dockerfile
    └─── requirements.txt
    └─── manage.py

Django 애플리케이션에서 kubernetes 앱에 할당된 외부 IP를 사용하도록 settings.py에서 ALLOWED_HOSTS를 업데이트합니다.

ALLOWED_HOSTS = ['*']

settings.py 파일의 DATABASES={ } 섹션을 업데이트합니다. 아래 코드 조각은 Kubernetes 매니페스트 파일에서 데이터베이스 호스트, 사용자 이름 및 암호를 읽습니다.

DATABASES={
   'default':{
      'ENGINE':'django.db.backends.postgresql_psycopg2',
      'NAME':os.getenv('DATABASE_NAME'),
      'USER':os.getenv('DATABASE_USER'),
      'PASSWORD':os.getenv('DATABASE_PASSWORD'),
      'HOST':os.getenv('DATABASE_HOST'),
      'PORT':'5432',
      'OPTIONS': {'sslmode': 'require'}
   }
}

requirements.txt 파일 생성

Django 애플리케이션에 대한 종속성을 나열하는 requirements.txt 파일을 만듭니다. requirements.txt 파일의 예는 다음과 같습니다. pip freeze > requirements.txt를 사용하여 기존 애플리케이션에 대한 requirements.txt 파일을 생성할 수 있습니다.

Django==2.2.17
postgres==3.0.0
psycopg2-binary==2.8.6
psycopg2-pool==1.1
pytz==2020.4

Dockerfile 만들기

Dockerfile이라는 새 파일을 만들고, 아래 코드 조각을 복사합니다. 이 Dockerfile 파일은 Python 3.8을 설정하고 requirements.txt 파일에 나열된 모든 요구 사항을 설치합니다.

# Use the official Python image from the Docker Hub

FROM python:3.8.2

# Make a new directory to put our code in.

RUN mkdir /code

# Change the working directory.

WORKDIR /code

# Copy to code folder

COPY . /code/

# Install the requirements.

RUN pip install -r requirements.txt

# Run the application:

CMD python manage.py runserver 0.0.0.0:8000

이미지 빌드

cd 명령을 사용하여 터미널의 my-django-app 디렉터리에 있는지 확인합니다. 다음 명령을 실행하여 게시판 이미지를 빌드합니다.

docker build --tag myblog:latest .

이미지를 Docker 허브 또는 Azure Container Registry에 배포합니다.

Important

ACR(Azure Container Registry)을 사용하는 경우 az aks update 명령을 실행하여 AKS 클러스터와 ACR 계정을 연결합니다.

az aks update --name djangoappcluster --resource-group django-project --attach-acr <your-acr-name>

Kubernetes 매니페스트 파일 만들기

Kubernetes 매니페스트 파일은 어떤 컨테이너 이미지가 실행되는지 등과 같은 클러스터에 대해 원하는 상태를 정의합니다. djangoapp.yaml이라는 매니페스트 파일을 만들고, 다음 YAML 정의에 복사해 보겠습니다.

Important

Azure Database for PostgreSQL 유연한 서버 인스턴스의 SERVERNAME, YOUR-DATABASE-USERNAME, YOUR-DATABASE-PASSWORD로 아래 env 섹션을 업데이트합니다.

apiVersion: apps/v1
kind: Deployment
metadata:
  name: django-app
spec:
  replicas: 1
  selector:
    matchLabels:
      app: django-app
  template:
    metadata:
      labels:
        app: django-app
    spec:
      containers:
      - name: django-app
        image: [DOCKER-HUB-USER-OR-ACR-ACCOUNT]/[YOUR-IMAGE-NAME]:[TAG]
        ports:
        - containerPort: 8000
        env:
        - name: DATABASE_HOST
          value: "SERVERNAME.postgres.database.azure.com"
        - name: DATABASE_USER
          value: "YOUR-DATABASE-USERNAME"
        - name: DATABASE_PASSWORD
          value: "YOUR-DATABASE-PASSWORD"
        - name: DATABASE_NAME
          value: "postgres"
      affinity:
        podAntiAffinity:
          requiredDuringSchedulingIgnoredDuringExecution:
            - labelSelector:
                matchExpressions:
                  - key: "app"
                    operator: In
                    values:
                    - django-app
              topologyKey: "kubernetes.io/hostname"
---
apiVersion: v1
kind: Service
metadata:
  name: python-svc
spec:
  type: LoadBalancer
  ports:
    - protocol: TCP
      port: 80
      targetPort: 8000
  selector:
    app: django-app

AKS 클러스터에 Django 배포

kubectl apply 명령을 사용하여 애플리케이션을 배포하고 YAML 매니페스트의 이름을 지정합니다.

kubectl apply -f djangoapp.yaml

다음 예제 출력에는 성공적으로 만들어진 배포 및 서비스가 나와 있습니다.

deployment "django-app" created
service "python-svc" created

django-app 배포를 사용하면 앱에 사용할 이미지, Pod 수 및 Pod 구성과 같은 배포의 세부 정보를 설명할 수 있습니다. 외부 IP를 통해 애플리케이션을 공개하는 python-svc 서비스가 만들어집니다.

애플리케이션 테스트

애플리케이션이 실행되면 애플리케이션 프런트 엔드를 인터넷에 공개하는 Kubernetes 서비스가 만들어집니다. 이 프로세스를 완료하는 데 몇 분이 걸릴 수 있습니다.

진행 상태를 모니터링하려면 --watch 인수와 함께 kubectl get service 명령을 사용합니다.

kubectl get service python-svc --watch

처음에는 django-app 서비스에 대한 EXTERNAL-IP가 보류 중으로 표시됩니다.

NAME               TYPE           CLUSTER-IP   EXTERNAL-IP   PORT(S)        AGE
django-app   LoadBalancer   10.0.37.27   <pending>     80:30572/TCP   6s

EXTERNAL-IP 주소가 보류 중에서 실제 공용 IP 주소로 변경되면 CTRL-C를 사용하여 kubectl 조사식 프로세스를 중지합니다. 다음 예제 출력은 서비스에 할당된 유효한 공용 IP 주소를 보여줍니다.

django-app  LoadBalancer   10.0.37.27   52.179.23.131   80:30572/TCP   2m

이제 서비스의 외부 IP 주소(http://<service-external-ip-address>)에 대한 웹 브라우저를 열고 Django 애플리케이션을 봅니다.

참고 항목

Django 사이트는 현재 HTTPS를 사용하지 않습니다. HTTPS의 상세 정보와 AKS에 대한 애플리케이션 라우팅을 구성하는 방법에 관한 자세한 내용은 애플리케이션 라우팅 추가 기능으로 Managed NGINX 수신을 참조하세요.

데이터베이스 마이그레이션 실행

django 애플리케이션의 경우 데이터베이스 마이그레이션을 실행하거나 정적 파일을 수집해야 합니다. $ kubectl exec <pod-name> -- [COMMAND]를 사용하여 이러한 django 셸 명령을 실행할 수 있습니다. 명령을 실행하기 전에 kubectl get pods를 사용하여 Pod 이름을 찾아야 합니다.

$ kubectl get pods

다음과 같은 출력이 표시됩니다.

NAME                             READY   STATUS          RESTARTS   AGE
django-app-5d9cd6cd8-l6x4b     1/1     Running              0       2m

Pod 이름을 찾았으면 $ kubectl exec <pod-name> -- [COMMAND] 명령을 사용하여 django 데이터베이스 마이그레이션을 실행할 수 있습니다. /code/는 위의 Dockerfile에 정의된 프로젝트에 대한 작업 디렉터리입니다.

$ kubectl exec django-app-5d9cd6cd8-l6x4b -- python /code/manage.py migrate

출력은 다음과 같습니다.

Operations to perform:
  Apply all migrations: admin, auth, contenttypes, sessions
Running migrations:
  Applying contenttypes.0001_initial... OK
  Applying auth.0001_initial... OK
  Applying admin.0001_initial... OK
  Applying admin.0002_logentry_remove_auto_add... OK
  Applying admin.0003_logentry_add_action_flag_choices... OK
  . . . . . .

문제가 발생하면 kubectl logs <pod-name>을 실행하여 애플리케이션에서 throw하는 예외를 확인합니다. 애플리케이션이 정상적으로 작동하는 경우 kubectl logs를 실행하면 다음과 같은 출력이 표시됩니다.

Watching for file changes with StatReloader
Performing system checks...

System check identified no issues (0 silenced).

You have 17 unapplied migration(s). Your project may not work properly until you apply the migrations for app(s): admin, auth, contenttypes, sessions.
Run 'python manage.py migrate' to apply them.
December 08, 2020 - 23:24:14
Django version 2.2.17, using settings 'django_postgres_app.settings'
Starting development server at http://0.0.0.0:8000/
Quit the server with CONTROL-C.

리소스 정리

Azure 요금을 방지하려면 불필요한 리소스를 정리해야 합니다. 클러스터가 더 이상 필요하지 않은 경우 az group delete 명령을 사용하여 리소스 그룹, 컨테이너 서비스 및 모든 관련 리소스를 제거합니다.

az group delete --name django-project --yes --no-wait

참고 항목

클러스터를 삭제해도 AKS 클러스터에서 사용하는 Microsoft Entra 서비스 주체는 제거되지 않습니다. 서비스 주체를 제거하는 방법에 대한 단계는 AKS 서비스 주체 고려 사항 및 삭제를 참조하세요. 관리 ID를 사용하는 경우 ID는 플랫폼에 의해 관리되며 제거할 필요가 없습니다.

다음 단계

AKS 클러스터에 대한 Kubernetes 웹 대시보드에 액세스하는 방법 알아보기
지속적인 배포를 사용하도록 설정하는 방법 알아보기
클러스터 크기를 조정하는 방법 알아보기
Azure Database for PostgreSQL 유연한 서버 인스턴스를 관리하는 방법을 알아봅니다.
데이터베이스 서버에 대한 서버 매개 변수를 구성하는 방법 알아보기

다음을 통해 공유

자습서: Azure Database for PostgreSQL - 유연한 서버를 사용하여 AKS에 Django 앱 배포

필수 구성 요소

리소스 그룹 만들기

AKS 클러스터 만들기

클러스터에 연결

Azure Database for PostgreSQL 유연한 서버 인스턴스 만들기

Django docker 이미지 빌드

requirements.txt 파일 생성

Dockerfile 만들기

이미지 빌드

Kubernetes 매니페스트 파일 만들기

AKS 클러스터에 Django 배포

애플리케이션 테스트

데이터베이스 마이그레이션 실행

리소스 정리

다음 단계

피드백

추가 리소스