Inicio rápido: Implementación de una aplicación web de Python (Django, Flask o FastAPI) en Azure App Service

mkdir flask-quickstart
cd flask-quickstart
azd init --template https://github.com/Azure-Samples/msdocs-python-flask-webapp-quickstart
azd up

mkdir django-quickstart
cd django-quickstart
azd init --template https://github.com/Azure-Samples/msdocs-python-django-webapp-quickstart
azd up

mkdir fastapi-quickstart
cd fastapi-quickstart
azd init --template https://github.com/Azure-Samples/msdocs-python-fastapi-webapp-quickstart
azd up

git clone https://github.com/Azure-Samples/msdocs-python-flask-webapp-quickstart

git clone https://github.com/Azure-Samples/msdocs-python-django-webapp-quickstart

git clone https://github.com/Azure-Samples/msdocs-python-fastapi-webapp-quickstart.git

1. Vaya a la carpeta de la aplicación:

   cd msdocs-python-flask-webapp-quickstart
   

2. Cree un entorno virtual para la aplicación:

   • Windows
   • macOS y Linux

   py -m venv .venv
   .venv\scripts\activate
   

3. Instale las dependencias:

   pip install -r requirements.txt
   

4. Ejecute la aplicación:

   flask run
   

5. Vaya a la aplicación de ejemplo en http://localhost:5000, en un explorador web.

   

¿Tiene problemas? Póngase en contacto con nosotros.

1. Vaya a la carpeta de la aplicación:

   cd msdocs-python-django-webapp-quickstart
   

2. Cree un entorno virtual para la aplicación:

   • Windows
   • macOS y Linux

   py -m venv .venv
   .venv\scripts\activate
   

3. Instale las dependencias:

   pip install -r requirements.txt
   

4. Ejecute la aplicación:

   python manage.py runserver
   

5. Vaya a la aplicación de ejemplo en http://localhost:8000, en un explorador web.

   

¿Tiene problemas? Póngase en contacto con nosotros.

1. Vaya a la carpeta de la aplicación:

   cd msdocs-python-fastapi-webapp-quickstart
   

2. Cree un entorno virtual para la aplicación:

   • Windows
   • macOS y Linux

   py -m venv .venv
   .venv\scripts\activate
   

3. Instale las dependencias:

   pip install -r requirements.txt
   

4. Ejecute la aplicación:

   uvicorn main:app --reload
   

5. Vaya a la aplicación de ejemplo en http://localhost:8000, en un explorador web.

   

¿Tiene problemas? Póngase en contacto con nosotros.

Los comandos de la CLI de Azure pueden ejecutarse en un equipo que tenga instalada la CLI de Azure.

Crea los recursos de Azure y luego despliega tu aplicación usando comandos de CLI de Azure separados.

Si es necesario, inicie sesión en Azure mediante az login.

az login

Sustituye <app-name> por un nombre único a nivel global. Crea un grupo de recursos y un plan de App Service, y luego crea la aplicación web usando az webapp create.

az group create --name myResourceGroup --location eastus
az appservice plan create --name myAppServicePlan --resource-group myResourceGroup --sku P0v3 --is-linux
az webapp create --name <app-name> --resource-group myResourceGroup --plan myAppServicePlan --runtime "PYTHON:3.14"
az webapp config appsettings set --name <app-name> --resource-group myResourceGroup --settings SCM_DO_BUILD_DURING_DEPLOYMENT=true

• Usa el parámetro --runtime para especificar la versión de Python con la que se ejecuta tu aplicación. Este ejemplo utiliza Python 3.14. Para listar los entornos de ejecución de Python compatibles, utiliza az webapp list-runtimes --os-type linux --runtime python --output table.
• Utiliza el parámetro --sku para definir el tamaño (CPU y memoria) y el coste del plan de App Service. Este ejemplo utiliza el plan de servicio P0v3 (Premium v3), que implica un coste en tu suscripción a Azure. Para obtener una lista completa de los planes de App Service, consulte Precios de App Service.
• Sustituye eastus por tu región preferida. Para listar las regiones disponibles, ejecuta az account list-locations con --output table.
• La SCM_DO_BUILD_DURING_DEPLOYMENT opción permite la compilación de Oryx, incluyendo la instalación de las dependencias en requirements.txt, cuando despliegas el archivo fuente.

Crea un archivo ZIP con los archivos de la aplicación, incluyendo requirements.txt, en la raíz del archivo ZIP. Excluye archivos locales como .venv, .git y .env. Para instrucciones específicas de la plataforma, consulta Crear un archivo ZIP de tu aplicación en la pestaña Implementar mediante un archivo ZIP. Luego despliega el archivo usando az webapp deploy:

az webapp deploy --name <app-name> --resource-group myResourceGroup --src-path <zip-file-path> --type zip

El despliegue puede durar unos minutos. Navega a https://<app-name>.azurewebsites.net para ver tu app. Para transmitir logs, actívalos ejecutando az webapp log config --name <app-name> --resource-group myResourceGroup --docker-container-logging filesystem, y luego ejecutando az webapp log tail --name <app-name> --resource-group myResourceGroup.

Para crear recursos de Azure en VS Code, debe tener instalado el paquete de la extensión de herramientas de Azure y haber iniciado sesión en Azure desde VS Code.

En la carpeta de la aplicación, abra VS Code:

code .

Instructions	Instantánea
Busque el icono de Azure en la barra de herramientas de la izquierda. Selecciónelo para abrir la extensión de Azure Tools para VS Code. Si no ve el icono de Azure Tools, asegúrese de que tiene instalada la extensión de Azure Tools para VS Code.
En la extensión Azure Tools para VS Code: Localice la sección RECURSOS y seleccione su suscripción. Seleccione + (Crear recurso...).
Elija la opción Crear aplicación web de App Service...
Escriba el nombre msdocs-python-webapp-quickstart-XYZ para esta aplicación web, donde XYZ pueden ser tres caracteres únicos cualquiera. Cuando se implementa, este nombre se usa como nombre de la aplicación.
Seleccione la pila en ejecución para la aplicación. En este ejemplo, seleccione Python 3.14.
Seleccione el plan de App Service (plan de tarifa) para esta aplicación web. El plan de App Service controla cuántos recursos (CPU/memoria) están disponibles para la aplicación y cuánto tiene que pagar. En este ejemplo, seleccione el plan de tarifa Básico (B1). Este plan supone un pequeño cargo en la cuenta de Azure, pero se recomienda al ofrecer un mejor rendimiento que el nivel Gratis (F1).
Seleccione el botón Implementar en la notificación "Nueva aplicación web creada".
Seleccione la carpeta de inicio rápido en la que está trabajando para implementarla.
Responda Sí para actualizar la configuración de compilación y mejorar el rendimiento de la implementación.
Una vez completada la implementación, aparecerá una notificación en la esquina inferior derecha de VS Code. Puede usar esta notificación para ir a la aplicación web.

Inicie sesión en Azure Portal y siga estos pasos para crear los recursos de Azure App Service.

Instructions	Instantánea
En Azure Portal: Escriba app services en la barra de búsqueda de la parte superior de Azure Portal. Seleccione el elemento con la etiqueta App Services bajo el encabezado Servicios en el menú que aparece bajo la barra de búsqueda.
En la página App Services, seleccione + Crear y, a continuación, seleccione + de aplicación web en el menú desplegable.
En la página Crear aplicación web, rellene el formulario así. Grupo de recursos → seleccione Crear nuevo y use un nombre de msdocs-python-webapp-quickstart. Nombre → msdocs-python-webapp-quickstart-XYZ, con XYZ pudiendo ser tres caracteres aleatorios. Este nombre debe ser único en Azure. Pila en tiempo de ejecución → Python 3.14. Región → Cualquier región de Azure cercana. Plan de App Service → En Plan de precios, seleccione Explorar planes de precios para seleccionar un plan de App Service diferente.
El plan de App Service controla la cantidad de recursos (CPU/memoria) que están disponibles para la aplicación y el costo de esos recursos. En este ejemplo, en desarrollo y pruebas, seleccione el plan de básico B1. El plan Básico B1 incurrirá en un pequeño cargo en su cuenta de Azure, pero se recomienda para mejorar el rendimiento con respecto al plan F1 gratuito. Cuando termine, seleccione Seleccione para aplicar los cambios.
En la página principal Crear aplicación web, seleccione Revisar y crear, en la parte inferior de la pantalla. Esto le lleva a la página Revisar. Seleccione Crear para crear la instancia de App Service.

Los comandos de CLI de Azure en el paso anterior crearon los recursos y desplegaron tu aplicación. Puedes pasar al siguiente paso.

Dado que el paso anterior creó los recursos necesarios e implementó la aplicación en un solo paso, puede pasar al siguiente paso.

Las aplicaciones se pueden implementar en Azure mediante la creación de un archivo ZIP del código de la aplicación y su carga en Azure. Los archivos ZIP se pueden cargar en Azure mediante la CLI de Azure o con un cliente HTTP como cURL.

Habilitación de la automatización de compilaciones

Al implementar un archivo ZIP del código Python, debe establecer una marca para habilitar la automatización de compilación de Azure. La automatización de compilación instalará los requisitos necesarios y empaquetará la aplicación para que se ejecute en Azure.

La automatización de compilaciones en Azure se habilita estableciendo la configuración de la aplicación SCM_DO_BUILD_DURING_DEPLOYMENT en Azure Portal o en la CLI de Azure.

• Azure Portal
• CLI de Azure

Instructions	Instantánea
En la página de la aplicación web de Azure Portal: Seleccione Configuración en el encabezado Configuración de la barra de herramientas izquierda para abrir la configuración de la aplicación. En configuración de la aplicación, seleccione nueva configuración de aplicación.
Con el cuadro de diálogo, escriba una nueva configuración con: Nombre → SCM_DO_BUILD_DURING_DEPLOYMENT Valor → true
Seleccione Guardar para guardar la configuración.

Creación de un archivo ZIP de la aplicación

Después, cree un archivo ZIP de la aplicación. Solo necesita incluir componentes de la propia aplicación. No es necesario incluir ningún archivo o directorio que comience con un punto (.), como .venv, .gitignore, .github, o .vscode.

zip -r <file-name>.zip . -x '.??*'

Carga del archivo ZIP en Azure

Una vez que tenga un archivo ZIP, este se puede cargar en Azure mediante la CLI de Azure o un cliente HTTP como cURL.

# Change these values to the ones used to create the App Service.
RESOURCE_GROUP_NAME='msdocs-python-webapp-quickstart'
APP_SERVICE_NAME='msdocs-python-webapp-quickstart-123'

az webapp deploy \
    --name $APP_SERVICE_NAME \
    --resource-group $RESOURCE_GROUP_NAME \
    --src-path <zip-file-path>

# Change these values to the ones used to create the App Service.
$resourceGroupName='msdocs-python-webapp-quickstart'
$appServiceName='msdocs-python-webapp-quickstart-123'

az webapp deploy `
    --name $appServiceName `
    --resource-group $resourceGroupName `
    --src-path <zip-file-path>

curl -X POST \
    -H 'Content-Type: application/zip' \
    -u '<deployment-user>' \
    -T <zip-file-name> \
    <URL>

curl -X POST `
    -H 'Content-Type: application/zip' `
    -u '<deployment-user>' `
    -T <zip-file-name> `
    <URL>

App Service detecta automáticamente la presencia de una aplicación de Flask. No se necesita ninguna configuración adicional para este inicio rápido.

App Service detecta automáticamente la presencia de una aplicación de Django. No se necesita ninguna configuración adicional para este inicio rápido.

Si usas Python 3.14 o posterior, App Service detecta y ejecuta automáticamente tu aplicación FastAPI. No se necesita ninguna configuración adicional para este inicio rápido.

Si usas Python 3.13 o anterior, debes configurar un comando de inicio personalizado para que App Service ejecute tu aplicación. El siguiente comando inicia Gunicorn con dos procesos de trabajo de Uvicorn: gunicorn -w 2 -k uvicorn.workers.UvicornWorker -b 0.0.0.0:8000 main:app.

En primer lugar, configure el comando de inicio mediante el comando az webapp config set.

az webapp config set \
    --startup-file "gunicorn -w 2 -k uvicorn.workers.UvicornWorker -b 0.0.0.0:8000 main:app" \
    --name $APP_SERVICE_NAME \
    --resource-group $RESOURCE_GROUP_NAME

A continuación, reinicie la aplicación web mediante el comando az webapp restart.

az webapp restart \
    --name $APP_SERVICE_NAME \
    --resource-group $RESOURCE_GROUP_NAME

App Service detecta automáticamente la presencia de una aplicación de Flask. No se necesita ninguna configuración adicional para este inicio rápido.

App Service detecta automáticamente la presencia de una aplicación de Django. No se necesita ninguna configuración adicional para este inicio rápido.

Si usas Python 3.13 o anterior, utiliza CLI de Azure o el portal de Azure para configurar el comando de inicio.

App Service detecta automáticamente la presencia de una aplicación de Flask. No se necesita ninguna configuración adicional para este inicio rápido.

App Service detecta automáticamente la presencia de una aplicación de Django. No se necesita ninguna configuración adicional para este inicio rápido.

Si usas Python 3.14 o posterior, App Service detecta y ejecuta automáticamente tu aplicación FastAPI. No necesitas ninguna configuración extra para este inicio rápido.

Si usas Python 3.13 o anterior, debes configurar un comando de inicio personalizado para que App Service ejecute tu aplicación. El siguiente comando inicia Gunicorn con dos procesos de trabajo de Uvicorn: gunicorn -w 2 -k uvicorn.workers.UvicornWorker -b 0.0.0.0:8000 main:app.

Instructions	Instantánea
Si usas Python 3.13 o anterior, configura el comando de inicio en Azure App Service. Ve a la instancia de App Service en el portal de Azure. Seleccione Configuración en el encabezado Configuración en el menú del lado izquierdo de la página. Asegúrese de que la pestaña Configuración general está seleccionada. En el campo Comando de inicio, escriba gunicorn -w 2 -k uvicorn.workers.UvicornWorker -b 0.0.0.0:8000 main:app. Haga clic en Guardar para guardar los cambios. Espere a la notificación de que la configuración se actualiza antes de continuar. Si usas Python 3.14 o posterior, no se requiere ningún comando de arranque.
A continuación, reinicie la aplicación web. Seleccione Información general en el menú del lado izquierdo de la página. En el menú superior, seleccione Reiniciar.

@app.route('/')
def index():
   print('Request for index page received')
   return render_template('index.html')

@app.route('/favicon.ico')
def favicon():
    return send_from_directory(os.path.join(app.root_path, 'static'),
                               'favicon.ico', mimetype='image/vnd.microsoft.icon')

@app.route('/hello', methods=['POST'])
def hello():
   name = request.form.get('name')

   if name:
       print('Request for hello page received with name=%s' % name)
       return render_template('hello.html', name = name)
   else:
       print('Request for hello page received with no name or blank name -- redirecting')
       return redirect(url_for('index'))

def index(request):
    print('Request for index page received')
    return render(request, 'hello_azure/index.html')

@csrf_exempt
def hello(request):
    if request.method == 'POST':
        name = request.POST.get('name')
        
        if name is None or name == '':
            print("Request for hello page received with no name or blank name -- redirecting")
            return redirect('index')
        else:
            print("Request for hello page received with name=%s" % name)
            context = {'name': name }
            return render(request, 'hello_azure/hello.html', context)
    else:

@app.get("/", response_class=HTMLResponse)
async def index(request: Request):
    print('Request for index page received')
    return templates.TemplateResponse('index.html', {"request": request})

@app.get('/favicon.ico')
async def favicon():
    file_name = 'favicon.ico'
    file_path = './static/' + file_name
    return FileResponse(path=file_path, headers={'mimetype': 'image/vnd.microsoft.icon'})

@app.post('/hello', response_class=HTMLResponse)
async def hello(request: Request, name: str = Form(...)):
    if name:
        print('Request for hello page received with name=%s' % name)
        return templates.TemplateResponse('hello.html', {"request": request, 'name':name})
    else:
        print('Request for hello page received with no name or blank name -- redirecting')
        return RedirectResponse(request.url_for("index"), status_code=status.HTTP_302_FOUND)

Primero debe configurar Azure App Service para generar registros en el sistema de archivos de App Service mediante el comando az webapp log config.

az webapp log config \
    --web-server-logging filesystem \
    --name $APP_SERVICE_NAME \
    --resource-group $RESOURCE_GROUP_NAME

az webapp log config `
    --web-server-logging 'filesystem' `
    --name $APP_SERVICE_NAME `
    --resource-group $RESOURCE_GROUP_NAME

Para transmitir registros, use el comando az webapp log tail.

az webapp log tail \
    --name $APP_SERVICE_NAME \
    --resource-group $RESOURCE_GROUP_NAME

az webapp log tail `
    --name $APP_SERVICE_NAME `
    --resource-group $RESOURCE_GROUP_NAME

Actualice la página principal de la aplicación o pruebe otras solicitudes para generar algunos mensajes de registro. La salida debe tener una apariencia similar a la siguiente.

Starting Live Log Stream ---

2021-12-23T02:15:52.740703322Z Request for index page received
2021-12-23T02:15:52.740740222Z 169.254.130.1 - - [23/Dec/2021:02:15:52 +0000] "GET / HTTP/1.1" 200 1360 "https://msdocs-python-webapp-quickstart-123.azurewebsites.net/hello" "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:95.0) Gecko/20100101 Firefox/95.0"
2021-12-23T02:15:52.841043070Z 169.254.130.1 - - [23/Dec/2021:02:15:52 +0000] "GET /static/bootstrap/css/bootstrap.min.css HTTP/1.1" 200 0 "https://msdocs-python-webapp-quickstart-123.azurewebsites.net/" "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:95.0) Gecko/20100101 Firefox/95.0"
2021-12-23T02:15:52.884541951Z 169.254.130.1 - - [23/Dec/2021:02:15:52 +0000] "GET /static/images/azure-icon.svg HTTP/1.1" 200 0 "https://msdocs-python-webapp-quickstart-123.azurewebsites.net/" "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:95.0) Gecko/20100101 Firefox/95.0"
2021-12-23T02:15:53.043211176Z 169.254.130.1 - - [23/Dec/2021:02:15:53 +0000] "GET /favicon.ico HTTP/1.1" 404 232 "https://msdocs-python-webapp-quickstart-123.azurewebsites.net/" "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:95.0) Gecko/20100101 Firefox/95.0"

2021-12-23T02:16:01.304306845Z Request for hello page received with name=David
2021-12-23T02:16:01.304335945Z 169.254.130.1 - - [23/Dec/2021:02:16:01 +0000] "POST /hello HTTP/1.1" 200 695 "https://msdocs-python-webapp-quickstart-123.azurewebsites.net/" "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:95.0) Gecko/20100101 Firefox/95.0"
2021-12-23T02:16:01.398399251Z 169.254.130.1 - - [23/Dec/2021:02:16:01 +0000] "GET /static/bootstrap/css/bootstrap.min.css HTTP/1.1" 304 0 "https://msdocs-python-webapp-quickstart-123.azurewebsites.net/hello" "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:95.0) Gecko/20100101 Firefox/95.0"
2021-12-23T02:16:01.430740060Z 169.254.130.1 - - [23/Dec/2021:02:16:01 +0000] "GET /static/images/azure-icon.svg HTTP/1.1" 304 0 "https://msdocs-python-webapp-quickstart-123.azurewebsites.net/hello" "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:95.0) Gecko/20100101 Firefox/95.0"

Elimine el grupo de recursos con el comando az group delete.

az group delete \
    --name msdocs-python-webapp-quickstart \
    --no-wait

El argumento --no-wait permite la devolución del comando antes de que se complete la operación.

Siga estos pasos si ha iniciado sesión en Azure Portal para eliminar un grupo de recursos.

Instructions	Instantánea
En Azure Portal, vaya al grupo de recursos. Escriba el nombre del grupo de recursos en la barra de búsqueda de la parte superior de la página. En el encabezado Grupos de recursos, seleccione el nombre del grupo de recursos para ir a él.
Seleccione el botón Eliminar grupo de recursos en la parte superior de la página.
En el cuadro de diálogo de confirmación, escriba el nombre del grupo de recursos para confirmar su eliminación. Seleccione Eliminar para eliminar el grupo de recursos.