Utilice CLI de Azure para crear un recurso de App Service

  • Artículo

SE APLICA A: SDK v4

En este artículo se describe cómo crear un recurso de App Service con la CLI de Azure y una plantilla de Resource Manager de Azure (plantilla de ARM) como parte del proceso de aprovisionamiento y publicación de un bot. El servicio de aplicaciones se conoce a veces como una aplicación web.

Importante

Los bots de Python no se pueden implementar en un grupo de recursos que contiene servicios o bots de Windows. Se pueden implementar varios bots de Python en el mismo grupo de recursos, pero debe crear otros servicios (como Servicios de Azure AI) en otro grupo de recursos.

Nota:

Los SDK de JavaScript, C# y Python de Bot Framework seguirán siendo compatibles, pero el SDK de Java se va a retirar con la compatibilidad final a largo plazo que finaliza en noviembre de 2023.

Los bots existentes creados con el SDK de Java seguirán funcionando.

Para la creación de nuevos bots, considera el uso de Power Virtual Agents y lee sobre cómo elegir la solución de bot de chat adecuada.

Para obtener más información, consulta El futuro de la creación de bots.

Requisitos previos

Para usar la CLI de Azure para aprovisionar y publicar bots, necesitas:

  • Una cuenta de Azure que tenga una suscripción activa. Crear una cuenta gratuita.

  • Una Instalación de la CLI de Azure.

    Para el lenguaje de programación, usa la siguiente versión de la CLI de Azure. Algunos pasos no funcionarán con versiones posteriores de la CLI.

    Lenguaje Versión de la CLI
    C# y JavaScript 2.39.0 o posterior
    Python 2.55.0 o posterior
    Java 2.29.2

  • Este proceso usa una plantilla de Resource Manager de Azure (plantilla de ARM) para crear un recurso de App Service para el bot.

    Si no tiene las plantillas actuales, cree una copia en el proyecto de bot de la carpeta deploymentTemplates: C#, JavaScript, Python o Java.

Sugerencia

Esto forma parte del proceso más grande para aprovisionar y publicar un bot. Consulte cómo Aprovisionar y publicar un bot para obtener una lista completa de los requisitos previos.

Edición del archivo de parámetros

Edite el archivo de parámetros de la plantilla de ARM para que contenga los valores que desea usar.

Importante

Debe usar el mismo valor appType para los recursos de App Service y Azure Bot.

Si el proyecto aún no contiene los archivos de parámetros y plantillas de ARM más recientes, puede copiarlos desde el repositorio del SDK de Bot Framework para su lenguaje: C#, JavaScript, Python o Java.

En esta tabla se describen los parámetros de implementación del archivo de parámetros, para utilizarlos con la opción de comando parameters. De forma predeterminada, el nombre del archivo de parámetros es parameters-for-template-BotApp-with-rg.json.

Parámetro Tipo Description
appServiceName String Necesario. Nombre único global del App service.
existingAppServicePlanName Cadena Opcional. Nombre de un plan de App Service existente con el que se va a crear el servicio de aplicaciones para el bot.
existingAppServicePlanLocation Cadena Opcional. La ubicación del plan de App Service existente.
newAppServicePlanName Cadena Opcional. El nombre del nuevo plan de App Service.
newAppServicePlanLocation Cadena Opcional. La ubicación del nuevo plan de App Service.
newAppServicePlanSku Object Opcional. El SKU del nuevo plan de App Service. El valor predeterminado es el plan de servicio S1 (estándar).
appType Cadena Necesario. Cómo se administran las identidades de los recursos del bot. Valores permitidos: "MultiTenant", "SingleTenant" y "UserAssignedMSI". El valor predeterminado es "MultiTenant".
appId Cadena Necesario. Id. de cliente o identificador de aplicación del recurso de identidad que creó anteriormente. Este es el identificador de aplicación de Microsoft de App Service.
appSecret Cadena Opcional. En el caso de los tipos de aplicación de inquilino único y multiinquilino, la contraseña del recurso de identidad.
UMSIName Cadena Opcional. Para los tipos de aplicación de identidad administrada asignada por el usuario, el nombre del recurso de identidad.
UMSIResourceGroupName Cadena Opcional. En el caso de los tipos de aplicación de identidad administrada asignadas por el usuario, el grupo de recursos para el recurso de identidad.
tenantId Cadena Opcional. En el caso de la identidad administrada asignada por el usuario y los tipos de aplicación de un solo inquilino, el identificador de inquilino de Microsoft Entra ID para el recurso de identidad.

No todos los parámetros se aplican a todos los tipos de aplicación.

  • Proporcione valores para UMSIName, UMSIResourceGroupName y tenantId.
  • Deje appSecret en blanco.

Algunos parámetros son específicos del uso de un plan de App Service existente o nuevo.

  • Proporcione valores para existingAppServicePlanName y existingAppServicePlanLocation.
  • Deje newAppServicePlanName, newAppServicePlanLocation y newAppServicePlanSku en blanco.

Creación del App Service

Creación del App Service para el bot.

az deployment group create --resource-group <resource-group> --template-file <template-file-path> --parameters "@<parameters-file-path>"
Opción Descripción
resource-group Nombre del grupo de recursos de Azure en el que se crea el App Service.
template-file Ruta de acceso a la plantilla de ARM para el App Service. La ruta de acceso puede ser relativa o absoluta.
parámetros Ruta de acceso al archivo de parámetros que se va a usar con la plantilla de ARM. La ruta de acceso puede ser relativa o absoluta.

En el caso de los proyectos creados con los generadores más recientes, la plantilla de ARM y los archivos de parámetros se encuentran en la carpeta DeploymentTemplates\DeployUseExistResourceGroup del proyecto. Los nombres de archivo predeterminados son template-BotApp-with-rg.json y parameters-for-template-BotApp-with-rg.json.

Sugerencia

  • La dirección URL base del App Service se basa en el nombre de App Service: https:<app-service-name>.azurewebsites.net.
  • El punto de conexión de mensajes del bot será la dirección URL base más /api/messages, como https:<app-service-name>.azurewebsites.net/api/messages.

Información adicional

Para más información sobre las plantillas de ARM, consulte ¿Qué son las plantillas de ARM? y Cómo usar plantillas de implementación de Azure Resource Manager (ARM) con la CLI de Azure.

Pasos siguientes

Si creó App Service como parte de una implementación de bot, consulte Creación de recursos con plantillas de ARM para continuar el proceso.