컨테이너화된 Python 웹앱을 로컬로 빌드 및 실행

자습서 시리즈의 이 부분에서는 로컬 컴퓨터에서 컨테이너화된 Django 또는 Flask Python 웹앱을 빌드하고 실행하는 방법을 알아봅니다. 이 앱의 데이터를 저장하려면 로컬 MongoDB 인스턴스 또는 Azure Cosmos DB for MongoDB를 사용할 수 있습니다. 이 문서는 5부로 구성된 자습서 시리즈의 2부입니다. 이 문서를 시작하기 전에 1부 를 완료해야 합니다.

다음 서비스 다이어그램은 이 문서에서 다루는 로컬 구성 요소를 강조 표시합니다. 이 문서에서는 MongoDB의 로컬 인스턴스가 아닌 로컬 Docker 이미지로 MongoDB용 Azure Cosmos DB 사용하는 방법도 알아봅니다.

로컬 부분이 강조 표시된 Azure의 컨테이너화된 Python 앱 자습서 스크린샷

샘플 Python 앱 복제 또는 다운로드

이 섹션에서는 Docker 이미지를 빌드하는 데 사용하는 샘플 Python 앱을 복제하거나 다운로드합니다. Django 또는 Flask Python 웹앱 중에서 선택할 수 있습니다. 고유한 Python 웹앱이 있는 경우 대신 사용하도록 선택할 수 있습니다. 자신의 Python 웹앱을 사용하는 경우, 앱의 루트 폴더에 Dockerfile이 있는지와 MongoDB 데이터베이스에 연결할 수 있는지 확인하세요.

git clone
다운로드

다음 명령 중 하나를 사용하여 Django 또는 Flask 리포지토리를 로컬 폴더에 복제합니다.

Django
플라스크

# Django
git clone https://github.com/Azure-Samples/msdocs-python-django-container-web-app.git

# Flask
git clone https://github.com/Azure-Samples/msdocs-python-flask-container-web-app.git

복제된 리포지토리의 루트 폴더로 이동합니다.

Django
플라스크

# Django
cd msdocs-python-django-container-web-app

# Flask
cd msdocs-python-flask-container-web-app

Docker 이미지 빌드

이 섹션에서는 Visual Studio Code 또는 Azure CLI를 사용하여 Python 웹앱용 Docker 이미지를 빌드합니다. Docker 이미지에는 Python 웹앱, 해당 종속성 및 Python 런타임이 포함됩니다. 이미지의 내용과 동작을 정의하는 Dockerfile에서 Docker 이미지를 빌드합니다. Dockerfile은(는) 복제하거나 다운로드했거나 직접 제공한 샘플 앱의 루트 폴더에 있습니다.

팁 (조언)

Azure CLI에 익숙하지 않다면 Azure CLI 시작하기를 참조하시기 바랍니다. 이 가이드에서는 Azure CLI를 로컬에 다운로드하고 설치하는 방법이나 Azure Cloud Shell에서 Azure CLI 명령을 실행하는 방법을 배울 수 있습니다.

Azure CLI
VS Code

Docker CLI를 사용하여 Docker 이미지를 빌드하려면 Docker가 필요합니다. Docker를 설치한 후 터미널 창을 열고 샘플 폴더로 이동합니다.

비고

이 섹션의 단계에서는 Docker 디먼을 실행해야 합니다. Windows 같은 일부 설치에서는 디먼을 시작하는 Docker Desktop 열어야 계속 진행할 수 있습니다.

샘플 앱의 루트 폴더에서 다음 명령을 실행하여 Docker에 액세스할 수 있는지 확인합니다.
```
docker
```
이 명령을 실행한 후 Docker CLI에 대한 도움말이 표시되면 Docker에 액세스할 수 있습니다. 그렇지 않으면 Docker가 설치되어 있고 셸에서 Docker CLI에 액세스할 수 있는지 확인합니다.
Docker build 명령을 사용하여 Python 웹 앱을 위한 Docker 이미지를 만듭니다.

명령의 일반적인 형식은 docker build --rm --pull --file "<path-to-project-root>/Dockerfile" --label "com.microsoft.created-by=docker-cli" --tag "<container-name>:latest" "<path-to-project-root>".

프로젝트의 루트 폴더에 있는 경우 다음 명령을 사용하여 Docker 이미지를 빌드합니다. 명령의 끝에 있는 점(".")은 명령이 실행되는 현재 디렉터리를 나타냅니다. 강제로 다시 빌드하려면 --no-cache를 추가하십시오.

비고

샘플 리포지토리는 Python 3.8을 사용합니다. 고유한 Dockerfile을 만드는 경우 3.12 또는 3.13과 같은 지원되는 Python 버전을 사용합니다. 현재 지원되는 버전은 Python 버전 지원을 참조하세요.
- 배쉬
- PowerShell
```
#!/bin/bash
docker build --rm --pull \
  --file "Dockerfile" \
  --label "com.microsoft.created-by=docker-cli" \
  --tag "msdocspythoncontainerwebapp:latest" \
    .
```
```
# PowerShell syntax
docker build --rm --pull `
  --file "Dockerfile" `
  --label "com.microsoft.created-by=docker-cli" `
  --tag "msdocspythoncontainerwebapp:latest" `
    .
```
Docker 이미지 명령을 사용하여 이미지가 성공적으로 빌드되었는지 확인하십시오.
```
docker images
```
이 명령은 다른 이미지 특성 중에서 REPOSITORY 이름, TAG 및 CREATED 날짜별로 이미지 목록을 반환합니다.

Visual Studio Code 사용하여 Docker 이미지를 로컬로 빌드하려면 Visual Studio Code 및 Docker 확장 필요합니다. 계속하기 전에 Visual Studio Code 및 Docker 확장을 설치합니다. Visual Studio Code 및 Docker 확장을 설치한 후 복제하거나 다운로드한 샘플 폴더로 이동하여 명령 code . 사용하여 VS Code를 엽니다.

비고

이 섹션의 단계에서는 Docker 디먼을 실행해야 합니다. Windows 같은 일부 설치에서는 계속하기 전에 디먼을 시작하려면 Docker Desktop을 열어야 합니다.

Visual Studio Code 및 Docker 확장을 설치한 후 복제하거나 다운로드한 샘플 폴더로 이동하여 명령 code . 사용하여 VS Code를 엽니다.
VS Code에서 Docker 확장을 연 다음 활동 바에서 Docker 확장을 선택합니다.

Visual Studio Code에서 Docker 확장을 여는 방법을 보여주는 스크린샷.

Docker 확장에서 "연결 실패" 오류를 보고하는 경우 Docker가 설치되고 실행 중인지 확인하세요.
Docker 이미지를 빌드하려면 Dockerfile을 마우스 오른쪽 버튼으로 클릭한 다음 이미지 빌드...를 선택합니다.

Dockerfile 구문에 대한 자세한 내용은 Dockerfile 참조 문서를 확인하세요.
이미지가 빌드되었는지 확인을 위해 IMAGES 섹션을 확장하고 최근에 빌드된 이미지를 찾습니다. 이 컨테이너 이미지의 이름은 "msdocspythoncontainerwebapp"입니다(이 값은 .vscode/tasks.json 파일에 설정됨).

Visual Studio Code에서 빌드된 이미지를 확인하는 방법을 보여주는 스크린샷

이 시점에서 "msdocspythoncontainerwebapp"이라는 로컬 Docker 이미지에 "latest" 태그가 있습니다. 태그는 버전 세부 정보, 의도된 사용, 안정성 및 기타 관련 정보를 정의하는 데 도움이 됩니다. 자세한 내용은 컨테이너 이미지 태그 지정 및 버전 관리에 대한 권장 사항을 참조하세요.

비고

VS Code에서 빌드하거나 Docker Desktop 애플리케이션을 사용하여 Docker CLI를 직접 사용하여 빌드하는 이미지를 볼 수도 있습니다.

MongoDB 설정

Python 웹앱에는 데이터를 저장하려면 MongoDB 데이터베이스와 restaurants_reviews이라는 컬렉션이 필요합니다. 이 자습서에서는 MongoDB의 로컬 설치와 MongoDB용 Azure Cosmos DB 인스턴스를 모두 사용하여 데이터베이스 및 컬렉션을 만들고 액세스합니다.

중요합니다

프로덕션 환경에서 사용하는 MongoDB 데이터베이스를 사용하지 마세요. 이 자습서에서는 이러한 MongoDB 인스턴스 중 하나의 MongoDB 연결 문자열을 환경 변수에 저장합니다. docker inspect 사용 등 컨테이너를 검사할 수 있는 모든 사용자는 이 연결 문자열 볼 수 있습니다.

로컬 MongoDB

Azure CLI 사용하여 MongoDB의 로컬 인스턴스를 만듭니다.

아직 설치되지 않은 경우 MongoDB 를 설치합니다.

MongoDB가 설치되어 있는지 확인하려면 MongoDB 셸(mongosh)을 사용합니다. 다음 명령이 작동하지 않는 경우 mongosh를 명시적으로 설치하거나 MongoDB 서버에 mongosh를 연결해야 할 수 있습니다.
- 다음 명령을 사용하여 MongoDB 셸을 열고 MongoDB 셸과 MongoDB 서버의 버전을 모두 가져옵니다.
```
mongosh
```
  팁 (조언)
  
  시스템에 설치된 MongoDB 서버의 버전만 반환하려면 MongoDB 셸을 닫았다가 다시 열고 다음 명령을 사용합니다. mongosh --quiet --exec 'db.version()'
  
  일부 설정에서는 bash 셸에서 Mongo 디먼을 직접 호출할 수도 있습니다.
```
mongod --version
```
폴더의 \MongoDB\Server\8.0\bin 파일을 수정하고 컴퓨터의 로컬 IP 주소를 bindIP 키에 추가합니다.

비고

구성 파일 경로는 운영 체제 및 MongoDB 버전에 따라 다릅니다. macOS에서는 /usr/local/etc/mongod.conf 또는 /opt/homebrew/etc/mongod.conf 찾으세요. Linux에서는 /etc/mongod.conf를 확인합니다.

MongoD 구성 파일의 bindip 키는 MongoDB가 클라이언트 연결을 수신 대기하는 호스트 이름 및 IP 주소를 정의합니다. 로컬 개발 컴퓨터의 현재 IP를 추가합니다. Docker 컨테이너에서 로컬로 실행되는 샘플 Python 웹앱은 이 주소를 사용하여 호스트 컴퓨터와 통신합니다.

예를 들어 구성 파일의 일부는 다음과 같습니다.
```
net:
  port: 27017
  bindIp: 127.0.0.1,<local-ip-address>
```
이 구성 파일에 변경 내용을 저장합니다.

중요합니다

이 구성 파일에 대한 변경 내용을 저장하려면 관리 권한이 필요합니다.
MongoDB를 다시 시작하여 구성 파일의 변경 내용을 선택합니다.
MongoDB 셸을 열고 다음 명령을 실행하여 데이터베이스 이름을 "restaurants_reviews"로 설정하고 컬렉션 이름을 "restaurants_reviews"로 설정합니다. VS Code MongoDB 확장이나 다른 MongoDB 관련 도구를 사용하여 데이터베이스와 컬렉션을 만들 수도 있습니다.
```
> help
> use restaurants_reviews
> db.restaurants_reviews.insertOne({})
> show dbs
> exit
```

이전 단계를 완료한 후 로컬 MongoDB 연결 문자열은 "mongodb://127.0.0.1:27017/"이고, 데이터베이스 이름은 "restaurants_reviews"이고, 컬렉션 이름은 "restaurants_reviews"입니다.

Azure Cosmos DB MongoDB용

이제 Azure CLI 사용하여 MongoDB 인스턴스에 대한 Azure Cosmos DB 만듭니다.

비고

이 자습서 시리즈의 4부에서는 Azure Cosmos DB for MongoDB 인스턴스를 사용하여 Azure App Service에서 웹앱을 실행합니다.

다음 스크립트를 실행하기 전에 위치, 리소스 그룹 및 Azure Cosmos DB for MongoDB 계정 이름을 적절한 값(선택 사항)으로 바꿉니다. 이 자습서에서 만든 모든 Azure 리소스에 대해 동일한 리소스 그룹을 사용하여 완료하면 더 쉽게 삭제할 수 있습니다.

이 스크립트를 실행하는 데 몇 분 정도 걸립니다.

배쉬
PowerShell

#!/bin/bash
# LOCATION: The Azure region. Use the "az account list-locations -o table" command to find a region near you.
LOCATION='westus'
# RESOURCE_GROUP_NAME: The resource group name, which can contain underscores, hyphens, periods, parenthesis, letters, and numbers.
RESOURCE_GROUP_NAME='msdocs-web-app-rg'
# ACCOUNT_NAME: The Azure Cosmos DB for MongDB account name, which can contain lowercase letters, hyphens, and numbers.
ACCOUNT_NAME='msdocs-cosmos-db-account-name'

# Create a resource group
echo "Creating resource group $RESOURCE_GROUP_NAME in $LOCATION..."
az group create --name $RESOURCE_GROUP_NAME --location $LOCATION

# Create a Cosmos account for MongoDB API
echo "Creating $ACCOUNT_NAME. This command may take a while to complete."
az cosmosdb create --name $ACCOUNT_NAME --resource-group $RESOURCE_GROUP_NAME --kind MongoDB

# Create a MongoDB API database
echo "Creating database restaurants_reviews"
az cosmosdb mongodb database create --account-name $ACCOUNT_NAME --resource-group $RESOURCE_GROUP_NAME --name restaurants_reviews

# Create a MongoDB API collection
echo "Creating collection restaurants_reviews"
az cosmosdb mongodb collection create --account-name $ACCOUNT_NAME --resource-group $RESOURCE_GROUP_NAME --database-name restaurants_reviews --name restaurants_reviews

# Get the connection string for the MongoDB database
echo "Get the connection string for the MongoDB account"
az cosmosdb keys list --name $ACCOUNT_NAME --resource-group $RESOURCE_GROUP_NAME --type connection-strings

echo "Copy the Primary MongoDB Connection String from the list above"

# PowerShell syntax
# LOCATION: The Azure region. Use "az account list-locations -o table" to find a region near you.
# RESOURCE_GROUP_NAME: The resource group name, which can contain underscores, hyphens, periods, parenthesis, letters, and numbers.
# ACCOUNT_NAME: The Azure Cosmos DB for MongoDB account name, which can contain lowercase letters, hyphens, and numbers.

$LOCATION = "westus"
$RESOURCE_GROUP_NAME = "msdocs-web-app-rg"
$ACCOUNT_NAME = "msdocs-cosmos-db-account-name"

# Create a resource group
Write-Output "Creating resource group $RESOURCE_GROUP_NAME in $LOCATION..."
az group create --name $RESOURCE_GROUP_NAME --location $LOCATION

# Create a Cosmos account for MongoDB API
Write-Output "Creating $ACCOUNT_NAME. This command may take a while to complete."
az cosmosdb create --name $ACCOUNT_NAME --resource-group $RESOURCE_GROUP_NAME --kind MongoDB

# Create a MongoDB API database
Write-Output "Creating database restaurants_reviews"
az cosmosdb mongodb database create --account-name $ACCOUNT_NAME --resource-group $RESOURCE_GROUP_NAME --name "restaurants_reviews"

# Create a MongoDB API collection
Write-Output "Creating collection restaurants_reviews"
az cosmosdb mongodb collection create --account-name $ACCOUNT_NAME --resource-group $RESOURCE_GROUP_NAME --database-name "restaurants_reviews" --name "restaurants_reviews"

# Get the connection string for the MongoDB database
Write-Output "Getting the connection string for the MongoDB account..."
az cosmosdb keys list --name $ACCOUNT_NAME --resource-group $RESOURCE_GROUP_NAME --type connection-strings

Write-Output "Copy the Primary MongoDB Connection String from the list above."

스크립트가 완료되면 마지막 명령의 출력에서 클립보드 또는 다른 위치로 기본 MongoDB 연결 문자열 을 복사합니다.

{
  "connectionStrings": [
    {
      "connectionString": ""mongodb://msdocs-cosmos-db:pnaMGVtGIRAZHUjsg4GJBCZMBJ0trV4eg2IcZf1TqV...5oONz0WX14Ph0Ha5IeYACDbuVrBPA==@msdocs-cosmos-db.mongo.cosmos.azure.com:10255/?ssl=true&replicaSet=globaldb&retrywrites=false&maxIdleTimeMS=120000&appName=@msdocs-cosmos-db@"",
      "description": "Primary MongoDB Connection String",
      "keyKind": "Primary",
      "type": "MongoDB"
    },

    ...
  ]
}

이전 단계를 완료한 후, mongodb://<server-name>:<password>@<server-name>.mongo.cosmos.azure.com:10255/?ssl=true&<other-parameters> 형태의 Azure Cosmos DB for MongoDB 연결 문자열, restaurants_reviews라는 데이터베이스, restaurants_reviews라는 컬렉션이 있습니다.

Azure CLI를 사용하여 Cosmos DB for MongoDB 계정을 만들고 데이터베이스 및 컬렉션을 만드는 방법에 대한 자세한 내용은 Azure CLI를 사용하여 Azure Cosmos DB용 MongoDB용 데이터베이스 및 컬렉션 만들기를 참조하세요. PowerShell, VS Code Azure Databases 확장, 그리고 Azure 포털도 사용할 수 있습니다.

팁 (조언)

VS Code Azure Databases 확장에서 MongoDB 서버를 마우스 오른쪽 단추로 클릭하고 연결 문자열을 가져올 수 있습니다.

컨테이너에서 로컬로 이미지 실행

이제 로컬 MongoDB 인스턴스 또는 Cosmos DB for MongoDB 인스턴스를 사용하여 Docker 컨테이너를 로컬로 실행할 준비가 되었습니다. 자습서의 이 섹션에서는 VS Code 또는 Azure CLI 사용하여 이미지를 로컬로 실행하는 방법을 알아봅니다. 샘플 앱은 환경 변수를 사용하여 MongoDB 연결 정보를 전달할 것으로 예상합니다. 환경 변수를 컨테이너에 로컬로 전달하는 몇 가지 방법이 있습니다. 각 방법에는 보안 측면에서 장점과 단점이 있습니다. 컨테이너 내 코드에 민감한 정보를 커밋하거나 남겨 두지 마세요.

비고

Azure 웹앱을 배포하는 경우 웹앱은 App Service 구성 설정으로 설정된 환경 값에서 연결 정보를 가져옵니다. 로컬 개발 환경 시나리오에 대한 수정 사항은 적용되지 않습니다.

Azure CLI
VS Code

MongoDB 로컬

MongoDB의 로컬 인스턴스와 함께 다음 명령을 사용하여 Docker 이미지를 로컬로 실행합니다.

최신 버전의 이미지를 실행합니다.

배쉬
PowerShell

#!/bin/bash

# Define variables
# Set the port number based on the framework being used:
# 8000 for Django, 5000 for Flask
export PORT=<port-number>  # Replace with actual port (e.g., 8000 or 5000)

# Set your computer''s IP address (replace with actual IP)
export YOUR_IP_ADDRESS=<your-computer-ip-address>  # Replace with actual IP address

# Run the Docker container with the required environment variables
docker run --rm -it \
  --publish "$PORT:$PORT" \
  --add-host "mongoservice:$YOUR_IP_ADDRESS" \
  --env CONNECTION_STRING=mongodb://mongoservice:27017 \
  --env DB_NAME=restaurants_reviews \
  --env COLLECTION_NAME=restaurants_reviews \
  --env SECRET_KEY="supersecretkeythatispassedtopythonapp" \
  msdocspythoncontainerwebapp:latest

# PowerShell syntax
# Define variables
# Set the port number based on the framework being used:
# 8000 for Django, 5000 for Flask
$PORT = "your_port_number"  # Replace with your actual port number
$YOUR_IP_ADDRESS = "your_ip_address"  # Replace with your actual IP address

# Run the Docker container with the required environment variables
docker run --rm -it `
    --publish "${PORT}:${PORT}" `
    --add-host "mongoservice:$YOUR_IP_ADDRESS" `
    --env CONNECTION_STRING="mongodb://mongoservice:27017" `
    --env DB_NAME="restaurants_reviews" `
    --env COLLECTION_NAME="restaurants_reviews" `
    --env SECRET_KEY="supersecretkeythatispassedtopythonapp" `
    msdocspythoncontainerwebapp:latest

컨테이너가 실행 중인지 확인합니다. 다른 콘솔 창에서 docker 컨테이너 ls 명령을 실행합니다.
```
docker container ls
```
목록에 컨테이너 msdocspythoncontainerwebapp:latest 가 표시됩니다. 출력의 NAMES 열과 PORTS 열을 주목하세요. 컨테이너 이름을 사용하여 컨테이너를 중지합니다.
웹앱을 테스트합니다.

Django는 http://127.0.0.1:8000, Flask는 http://127.0.0.1:5000/로 이동하세요.
컨테이너를 종료합니다.
```
docker container stop <container-name>
```

Azure Cosmos DB MongoDB용

Azure Cosmos DB for MongoDB 인스턴스와 함께 다음 명령을 사용하여 Azure에서 Docker 이미지를 실행합니다.

최신 버전의 이미지를 실행합니다.

배쉬
PowerShell

#!/bin/bash
# PORT=8000 for Django and 5000 for Flask
export PORT=<port-number>
export CONNECTION_STRING="<connection-string>"

docker run --rm -it \
  --publish $PORT:$PORT/tcp \
  --env CONNECTION_STRING=$CONNECTION_STRING \
  --env DB_NAME=restaurants_reviews \
  --env COLLECTION_NAME=restaurants_reviews \
  --env SECRET_KEY=supersecretkeythatyougenerate \
  msdocspythoncontainerwebapp:latest

# PowerShell syntax
# PORT=8000 for Django and 5000 for Flask
$PORT=<port-number>
$CONNECTION_STRING="<connection-string>"

docker run --rm -it `
  --publish ${PORT}:${PORT}/tcp `
  --env CONNECTION_STRING=$CONNECTION_STRING `
  --env DB_NAME=restaurants_reviews `
  --env COLLECTION_NAME=restaurants_reviews `
  --env SECRET_KEY=supersecretkeythatyougenerate `
  msdocspythoncontainerwebapp:latest

데모용으로, 이 예제에서는 중요한 정보를 전달하는 방법을 보여 있습니다. docker 컨테이너 검사 명령을 사용하여 컨테이너를 검사하여 연결 문자열 정보를 볼 수 있습니다. 비밀을 처리하는 또 다른 방법은 Docker의 BuildKit 기능을 사용하는 것입니다.

새 콘솔 창을 열고 다음 docker 컨테이너 ls 명령을 실행하여 컨테이너가 실행 중인지 확인합니다.
```
docker container ls
```
목록에 컨테이너 msdocspythoncontainerwebapp:latest 가 표시됩니다. 출력의 NAMES 열과 PORTS 열을 주목하세요. 컨테이너 이름을 사용하여 컨테이너를 중지합니다.
웹앱을 테스트합니다.

Django는 http://127.0.0.1:8000, Flask는 http://127.0.0.1:5000/로 이동하세요.
컨테이너를 종료합니다.
```
docker container stop <container-name>
```

자습서의 이 섹션에서는 Visual Studio Code Docker 확장을 사용하여 컨테이너를 실행합니다. VS Code 내에서 로컬 MongoDB 인스턴스 또는 MongoDB용 Cosmos DB 인스턴스에 대한 연결 문자열을 사용할 수 있습니다.

샘플 앱의 .vscode 폴더에서 settings.json 파일은 Docker 확장을 사용하고 태그의 상황에 맞는 메뉴에서 대화형실행 또는 실행을 선택할 때 발생하는 작업을 정의합니다. settings.json 파일에는 (MongoDB local) 및 (MongoDB Azure) 시나리오 각각에 대해 두 개의 템플릿이 포함되어 있습니다.

로컬 MongoDB 데이터베이스를 사용하는 경우:
- <YOUR_IP_ADDRESS> 두 개를 모두 IP 주소로 대체합니다.
- <CONNECTION_STRING> 두 인스턴스를 MongoDB 데이터베이스의 연결 문자열로 교체합니다.
- "docker.commands.run" 및 "docker.commands.runInteractive" 코드 블록 모두에 대한 MongoDB 로컬 템플릿에 대한 Docker 실행 명령에 전달된 변수 문자열에 다음 환경 변수를 추가합니다.
```
-e 'SECRET_KEY=supersecretkeythatispassedtopythonapp'
```
Azure Cosmos DB for MongoDB 데이터베이스를 사용하는 경우:
- <CONNECTION_STRING>의 두 인스턴스를 Azure Cosmos DB for MongoDB 연결 문자열로 바꿉니다.
- "docker.commands.run" 및 "docker.commands.runInteractive" 코드 블록 모두에 대해 MongoDB용 Azure Cosmos DB 템플릿에 대한 Docker 실행 명령에 전달된 변수 문자열에 다음 환경 변수를 추가합니다.
```
-e 'SECRET_KEY=supersecretkeythatispassedtopythonapp'
```
템플릿에서 사용하는 docker.dockerPath 구성 설정을 설정합니다. 설정 docker.dockerPath하려면 VS Code 명령 팔레트 (Ctrl+Shift+P)를 열고 "기본 설정: 작업 영역 설정 열기"를 입력한 다음 검색 설정 상자에 "docker.dockerPath"를 입력합니다. 설정 값에 "docker"(따옴표 없음)를 입력합니다.

비고

데이터베이스 이름과 컬렉션 이름은 모두 restaurants_reviews으로 간주됩니다.
이미지를 실행합니다.
1. Docker 확장의 IMAGES 섹션에서 빌드된 이미지를 찾아보세요.
2. 이미지를 확장하여 최신 태그를 찾고 마우스 오른쪽 버튼을 클릭한 다음 대화형 실행을 선택합니다.
3. 시나리오에 적합한 작업인 "대화형 실행 구성(MongoDB 로컬)" 또는 "대화형 실행 구성(MongoDB Azure)"을 선택하라는 메시지가 표시됩니다.
대화형 실행을 사용하면 코드에 인쇄 문이 표시되므로 디버깅에 유용할 수 있습니다. 실행을 선택할 수도 있는데, 이는 비대화형이며 표준 입력을 열어 두지 않습니다.

중요합니다

기본 터미널 프로필이 (Windows) 명령 프롬프트로 설정된 경우 이 단계가 실패합니다. 기본 프로필을 변경하려면 VS Code 명령 팔레트(Ctrl+Shift+P)를 열고 "터미널: 기본 프로필 선택"을 입력한 다음 드롭다운 메뉴에서 Git Bash 또는 PowerShell 같은 다른 프로필을 선택합니다.
Docker 컨테이너가 실행 중인지 확인합니다.
1. Docker 확장의 CONTAINERS 섹션에서 컨테이너를 찾으세요.
2. 개별 컨테이너 노드를 펼치고 "msdocspythoncontainerwebapp" 컨테이너가 실행 중인지 확인합니다. 컨테이너 이름 옆에 있는 녹색 삼각형 기호를 찾습니다.
Visual Studio Code에서 Docker 컨테이너가 실행 중인지 확인하는 방법을 보여주는 스크린샷입니다.
컨테이너 이름을 마우스 오른쪽 단추로 클릭하고 브라우저에서 열기를 선택하여 웹앱을 테스트합니다.

Visual Studio Code에서 Docker 컨테이너의 엔드포인트를 탐색하는 방법을 보여주는 스크린샷

브라우저가 기본 브라우저로 "http://127.0.0.1:8000""로 열리며, Django의 경우 또는 "http://127.0.0.1:5000/""로, Flask의 경우.

비고

시간 제한 오류가 발생하면 MongoDB 서비스가 실행 중인지 확인합니다. 그렇지 않은 경우 VS Code에서 Docker 컨테이너를 중지하고 MongoDB 서비스를 다시 시작합니다. 그런 다음 Docker 컨테이너를 다시 시작하고 브라우저에서 웹앱에 액세스합니다.
컨테이너를 중지합니다.
1. Docker 확장의 CONTAINERS 섹션에서 실행 중인 컨테이너를 찾으십시오.
2. 컨테이너를 마우스 오른쪽 버튼으로 클릭하고 중지를 선택합니다.
Visual Studio Code에서 실행 중인 Docker 컨테이너를 중지하는 방법을 보여 주는 스크린샷.

팁 (조언)

실행 또는 디버그 구성을 선택하여 컨테이너를 실행할 수도 있습니다. 실행하거나 디버그하면 tasks.json Docker 확장 작업이 호출됩니다. 호출되는 작업은 선택한 시작 구성에 따라 달라집니다. "Docker: Python (MongoDB 로컬)" 작업의 경우 <YOUR-IP-ADDRESS>를 지정합니다. "Docker: Python(MongoDB Azure)" 작업의 경우 <CONNECTION-STRING>을(를) 지정합니다.

또한 이미지에서 컨테이너를 시작하고 Docker Desktop 애플리케이션을 사용하여 컨테이너를 중지할 수도 있습니다.

다음 단계

Azure에서 컨테이너 이미지 빌드

피드백

이 페이지가 도움이 되었나요?

Last updated on 2025-05-21

컨테이너화된 Python 웹앱을 로컬로 빌드 및 실행

샘플 Python 앱 복제 또는 다운로드

Docker 이미지 빌드

MongoDB 설정

로컬 MongoDB

Azure Cosmos DB MongoDB용

컨테이너에서 로컬로 이미지 실행

MongoDB 로컬

Azure Cosmos DB MongoDB용

다음 단계

피드백

추가 리소스