Compartir vía

Información general sobre las plantillas azd web de Python

Las plantillas de la CLI para desarrolladores de Azure web de Python (azd) son la manera más rápida y sencilla de compilar, configurar e implementar aplicaciones web de Python en Azure. En este artículo se proporciona información contextual en segundo plano para ayudarle a comprender los componentes implicados y cómo las plantillas simplifican la implementación.

La mejor manera de empezar es seguir el inicio rápido para crear su primera aplicación web de Python e implementarla en Azure en cuestión de minutos con azd plantillas. Si prefiere no configurar un entorno de desarrollo local, puede seguir el inicio rápido mediante GitHub Codespaces para obtener una experiencia totalmente basada en la nube con todas las herramientas preconfiguradas.

¿Cuáles son las plantillas de azd web de Python?

Las azd plantillas están diseñadas para desarrolladores web de Python experimentados que desean implementar aplicaciones escalables y listas para la nube en Azure con un tiempo de configuración mínimo.

Estas plantillas ofrecen el punto de partida más sencillo posible para compilar e implementar aplicaciones web de Python mediante:

  • Configurar rápidamente un entorno de desarrollo y hospedaje local completo.
  • Automatización de la creación de un entorno de implementación de Azure coincidente.
  • Uso de un flujo de trabajo sencillo y memorable de la CLI.

Una vez configurados los entornos, las plantillas proporcionan la manera más rápida de empezar a compilar la aplicación web de Python. Ustedes pueden:

  • Modifique los archivos de código proporcionados para que coincidan con los requisitos de la aplicación.
  • Implemente actualizaciones con un esfuerzo mínimo mediante comandos azd.
  • Amplíe la plantilla para que se ajuste a la arquitectura.

Estas plantillas reflejan patrones de diseño probados y procedimientos recomendados, lo que le permite:

  • Construye con confianza sobre una sólida base arquitectónica.
  • Siga las instrucciones desarrolladas por expertos del sector con experiencia profunda en Python y Azure.
  • Asegúrese de la mantenibilidad, escalabilidad y seguridad desde el principio.

¿Qué tareas puedo hacer con las plantillas?

Al ejecutar una plantilla web azd de Python, se completan rápidamente varias tareas:

  • Cree una aplicación de inicio. Crea un sitio web para una empresa ficticia denominada Relecloud. Este proyecto de inicio incluye:

    • Código bien organizado y listo para producción
    • Procedimientos recomendados para marcos web de Python (como Flask, Django).
    • Uso adecuado de las dependencias, la configuración y la estructura.

    La plantilla está diseñada para ser un punto de partida: puede personalizar libremente la lógica y expandir o quitar recursos de Azure para ajustarse al proyecto.

  • Aprovisionar recursos de Azure. Con Bicep, un lenguaje moderno de infraestructura como código (IaC), la plantilla aprovisiona todos los recursos de Azure necesarios para:

    • Hospedar la aplicación web (como App Service, Container Apps)
    • Conexión a bases de datos (como PostgreSQL, Cosmos DB)

    Los archivos de Bicep son totalmente editables: puede agregar o personalizar los servicios de Azure a medida que evoluciona la aplicación. De forma similar a la tarea anterior, puede modificar las plantillas de Bicep para agregar más servicios de Azure, según sea necesario.

  • Implemente la aplicación de inicio en los recursos de Azure aprovisionados. Una vez aprovisionados los recursos, la aplicación se implementa automáticamente en el entorno de Azure. Ahora puede hacer lo siguiente:

    • Ve tu aplicación ejecutándose en la nube en tan solo unos minutos.
    • Pruebe su comportamiento.
    • Decida qué funcionalidad o configuración se va a actualizar a continuación.

  • (Opcional) Configure el repositorio de GitHub y la canalización de CI/CD. Puede, si lo desea, inicializar un repositorio de GitHub con una canalización de integración continua y entrega continua (CI/CD) de GitHub Actions para:

    • Automatice las implementaciones en los cambios de código.
    • Colabore con miembros del equipo.
    • Envía actualizaciones a Azure fusionando en la rama principal.

    Esta integración le ayuda a adoptar los procedimientos recomendados de DevOps desde el principio.

¿Dónde puedo acceder a las plantillas?

Muchas azd plantillas están disponibles en la galería de plantillas de la CLI para desarrolladores de Azure impresionantes. Estas plantillas proporcionan proyectos de aplicaciones web de Python listos para usar con paridad de características entre combinaciones populares de servicios de Azure y marcos web de Python.

Cada plantilla incluye lo siguiente:

  • Una aplicación de ejemplo con código limpio y fácil de mantener.
  • Infraestructura-como-código preconfigurada mediante Bicep.
  • Flujos de trabajo de implementación sin problemas mediante la CLI para desarrolladores de Azure.
  • Integración opcional de CI/CD a través de Acciones de GitHub

En las siguientes tablas se enumeran los monikers de plantilla web azd de Python que están disponibles para usar con el comando azd init. Las tablas identifican las tecnologías implementadas en cada plantilla y proporcionan un vínculo al repositorio de GitHub correspondiente, donde puede contribuir a los cambios.

Las plantillas siguientes azd están disponibles para el marco web de Django.

Plantilla Base de datos Plataforma de hospedaje Repositorio de GitHub
azure-django-postgres-flexible-aca Servidor flexible de Azure Database for PostgreSQL Azure Container Apps https://github.com/Azure-Samples/azure-django-postgres-flexible-aca
azure-django-postgres-flexible-appservice Servidor flexible de Azure Database for PostgreSQL Azure App Service https://github.com/Azure-Samples/azure-django-postgres-flexible-appservice
azure-django-cosmos-postgres-aca Azure Cosmos DB para Azure Database for PostgreSQL Azure Container Apps (Aplicaciones de Contenedores de Azure) https://github.com/Azure-Samples/azure-django-cosmos-postgres-aca
azure-django-cosmos-postgres-appservice Azure Cosmos DB para Azure Database for PostgreSQL Azure App Service https://github.com/Azure-Samples/azure-django-cosmos-postgres-appservice
azure-django-postgres-addon-aca Azure Container Apps con Base de Datos de Azure para PostgreSQL Azure Container Apps (Aplicaciones de Contenedores de Azure) https://github.com/Azure-Samples/azure-django-postgres-addon-aca

¿Cómo debo usar las plantillas?

Cada azd plantilla consta de un repositorio de GitHub que contiene el código de aplicación (código de Python que usa un marco web popular) y los archivos de infraestructura como código (es decir, Bicep) para crear los recursos de Azure. La plantilla también contiene la configuración necesaria para configurar un repositorio de GitHub con una canalización de CI/CD.

Entre los componentes clave de cada plantilla se incluyen:

  • Código de aplicación: escrito en Python y creado con un marco web popular (como Flask, Django, FastAPI). En la aplicación de ejemplo se muestran los procedimientos recomendados de enrutamiento, acceso a datos y configuración.

  • Infraestructura como código (IaC): se proporciona a través de archivos de Bicep para definir y aprovisionar los recursos de Azure necesarios, como:

    • Servicio de Aplicaciones o Container Apps
    • Bases de datos de Azure (como PostgreSQL, Cosmos DB)
    • Servicios de Azure AI, Almacenamiento y mucho más

  • Configuración de CI/CD (opcional): incluye archivos para configurar un repositorio de GitHub con una canalización de CI/CD de Acciones de GitHub, lo que habilita:

    • Implementación automática en Azure en cada solicitud de inserción o extracción en la rama principal.
    • Integración sin problemas en el flujo de trabajo de DevOps

    Estas plantillas son totalmente personalizables, lo que proporciona una base sólida para basarse y adaptarse a las necesidades específicas del proyecto.

Para realizar las tareas definidas por una azd plantilla web, use varios comandos de Python azd . Para obtener descripciones detalladas de estos comandos, consulte Inicio rápido: Implementación de una plantilla de la CLI para desarrolladores de Azure. El inicio rápido le guía por los pasos para usar una plantilla específica azd . Solo tiene que ejecutar cinco instrucciones de línea de comandos esenciales para el entorno de hospedaje de producción y el entorno de desarrollo local.

En la tabla siguiente se resumen los cinco comandos esenciales:

Comando Descripción de la tarea
azd init --template <template name> Cree un nuevo proyecto a partir de una plantilla y cree una copia del código de aplicación en el equipo local. El comando le pide que proporcione un nombre de entorno (como "myapp") que se usa como prefijo en la nomenclatura de los recursos implementados.
azd auth login Inicie sesión en Azure. El comando abre una ventana del explorador donde puede iniciar sesión en Azure. Después de iniciar sesión, se cierra la ventana del explorador y se completa el comando. El azd auth login comando solo es necesario la primera vez que use la CLI para desarrolladores de Azure (azd) por sesión.
azd up Aprovisione los recursos en la nube e implemente la aplicación en esos recursos.
azd deploy Implemente los cambios en el código fuente de la aplicación en los recursos ya aprovisionados por el azd up comando .
azd down Elimine los recursos de Azure y la canalización de CI/CD, si fue utilizada.

Sugerencia

Cuando trabaje con comandos azd, esté atento a mensajes para especificar más información. Después de ejecutar el azd up comando, es posible que se le pida que seleccione una suscripción, si tiene más de una. También se le pedirá que especifique su región. Puede cambiar las respuestas a las solicitudes editando las variables de entorno almacenadas en la carpeta /.azure/ de la plantilla.

Después de completar las tareas esenciales proporcionadas por la azd plantilla, tiene una copia personal de la plantilla original donde puede modificar cualquier archivo, según sea necesario.

  • Código de aplicación: personalice el código del proyecto de Python para implementar su propio diseño, rutas y lógica de negocios.
  • Infraestructura como código (Bicep): actualice los archivos de Bicep para aprovisionar servicios de Azure adicionales, cambiar configuraciones o quitar recursos innecesarios.

Este punto de partida flexible le permite crear sobre una base bien estructurada y adaptar la aplicación a su caso de uso real.

También puede modificar la configuración de infraestructura como código si necesita cambiar los recursos de Azure. Para obtener más información, consulte la sección ¿Qué puedo editar o eliminar ? más adelante en este artículo.

Tareas de plantilla opcionales

Además de los cinco comandos esenciales, hay tareas opcionales que puede completar con las azd plantillas.

Reaprovisionamiento y modificación de recursos de Azure

Después de aprovisionar recursos de Azure con una azd plantilla, puede modificar y volver a aprovisionar un recurso.

Configuración de canalizaciones de integración y entrega continuas

La CLI para desarrolladores de Azure (azd) proporciona una manera sencilla de configurar una canalización de CI/CD para la nueva aplicación web de Python. Al fusionar confirmaciones o solicitudes de incorporación de cambios en tu rama principal, la pipeline compila y publica automáticamente los cambios en sus recursos de Azure.

  • Para configurar la canalización de CI/CD, designe el repositorio de GitHub y la configuración deseada para habilitar la canalización.
  • Para crear la canalización, use el azd pipeline config comando .

Después de configurar la canalización, cada vez que se combinan los cambios de código en la rama principal del repositorio, la canalización implementa los cambios en los servicios de Azure aprovisionados.

Alternativas a las plantillas

Si prefiere no usar las plantillas web azd de Python, hay métodos alternativos para implementar aplicaciones web de Python en Azure y aprovisionar recursos de Azure.

Puede crear muchos recursos y completar los pasos de implementación mediante varias herramientas:

También puede seguir un tutorial completo que incluya marcos de desarrollo web de Python:

Preguntas más frecuentes

En las secciones siguientes se resumen las respuestas a las preguntas más frecuentes sobre cómo trabajar con las plantillas web azd de Python.

¿Tengo que usar contenedores de desarrollo?

No. Las plantillas web azd de Python usan contenedores de desarrollo de Visual Studio Code de forma predeterminada. Los contenedores de desarrollo proporcionan muchas ventajas, pero requieren algunos conocimientos y software previos. Si prefiere no usar contenedores de desarrollo y, en su lugar, use el entorno de desarrollo local, consulte el archivo README.md en el directorio raíz de la aplicación de ejemplo para obtener instrucciones de configuración del entorno.

¿Qué puedo editar o eliminar?

El contenido de cada plantilla web azd de Python puede variar según el tipo de proyecto y la pila de tecnología subyacente empleada. Las plantillas identificadas en este artículo siguen una convención común de carpeta y archivo, como se describe en la tabla siguiente.

Carpeta/archivos Propósito Descripción
/ Directorio raíz La carpeta raíz de cada plantilla contiene muchos tipos diferentes de archivos y carpetas con distintos fines.
/.celeste azd archivos de configuración La carpeta .azure se crea después de ejecutar el azd init comando . La carpeta almacena los archivos de configuración de las variables de entorno usadas por los azd comandos. Puede cambiar los valores de las variables de entorno para personalizar la aplicación y los recursos de Azure. Para obtener más información, consulte Archivo .env específico del entorno.
/.devcontainer Archivos de configuración del contenedor de desarrollo Los contenedores de desarrollo permiten crear un entorno de desarrollo basado en contenedores completo con todos los recursos que necesita para el desarrollo de software dentro de Visual Studio Code. La carpeta .devcontainer se crea después de que Visual Studio Code genere un archivo de configuración de contenedor de desarrollo en respuesta a un comando de plantilla.
/.github Archivos de configuración de Acciones de GitHub Esta carpeta contiene ajustes de configuración para la pipeline opcional de CI/CD de GitHub Actions, linting y pruebas. Si no desea configurar la canalización de Acciones de GitHub mediante azd pipeline config el comando , puede modificar o eliminar el archivo azure-dev.yaml .
/infra Archivos de Bicep La carpeta infra contiene los archivos de configuración de Bicep. Bicep permite declarar los recursos de Azure que desea implementar en el entorno. Solo debe modificar los archivos main.bicep y web.bicep . Para obtener más información, consulte Inicio rápido: Escalado de servicios implementados con las plantillas web de Python azd mediante Bicep.
/src Archivos de código del proyecto de inicio La carpeta src contiene varios archivos de código necesarios para preparar el proyecto de inicio. Algunos ejemplos de los archivos incluyen plantillas requeridas por el marco web, archivos estáticos, archivos de Python (.py) para la lógica de código y los modelos de datos, un archivo derequirements.txt , etc. Los archivos específicos dependen del marco web, del marco de acceso a datos, etc. Puede modificar estos archivos para que se adapten a los requisitos del proyecto.
/.cruft.json Archivo de generación de plantillas El archivo JSON .cruft se usa internamente para generar las plantillas web azd de Python. Puede eliminar este archivo de forma segura, según sea necesario.
/.gitattributes Archivo con configuración de atributos para Git Este archivo proporciona a Git opciones de configuración importantes para controlar archivos y carpetas. Puede modificar este archivo, según sea necesario.
/.gitignore Archivo con elementos ignorados para Git El archivo .gitignore informa a Git sobre los archivos y carpetas que se van a excluir (omitir) al escribir en el repositorio de GitHub para la plantilla. Puede modificar este archivo, según sea necesario.
/azure.yaml azd up archivo de configuración Este archivo de configuración contiene los valores de configuración del azd up comando . Especifica los servicios y las carpetas de proyecto que se van a implementar. Importante: Este archivo no debe eliminarse.
/*.md Archivos de formato Markdown Una plantilla puede incluir varios archivos de formato Markdown (.md) para diferentes propósitos. Puede eliminar archivos Markdown de forma segura.
/docker-compose.yml Configuración de Docker Compose Este archivo YML crea el paquete de contenedor para la aplicación web de Python antes de que la aplicación se implemente en Azure.
/pyproject.toml Archivo de configuración de compilación de Python El archivo TOML contiene los requisitos del sistema de compilación de proyectos de Python. Puede modificar este archivo para identificar sus preferencias de herramienta, como un linter específico o un marco de pruebas unitarias.
/requirements-dev.in archivo de requisitos de pip Este archivo se usa para crear una versión del entorno de desarrollo de los requisitos mediante el pip install -r comando . Puede modificar este archivo para incluir otros paquetes, según sea necesario.

Sugerencia

A medida que modifique los archivos de plantilla para el programa, asegúrese de practicar un buen control de versiones. Este enfoque puede ayudarle a restaurar el repositorio a una versión de trabajo anterior, si los nuevos cambios provocan problemas de programa.

¿Cómo puedo controlar los errores de plantilla?

Si recibe un error al usar una azd plantilla, revise las opciones descritas en el artículo Solución de problemas de la CLI para desarrolladores de Azure . También puede notificar problemas en el repositorio de GitHub asociado a la azd plantilla.

Contenido relacionado

  • Last updated on