Después de la implementación
Esta página continúa la implementación. Complete primero la implementación.
1. Verificar la implementación
1.1 Comprobar los resultados de la implementación
Abra el grupo de recursos, seleccione Implementaciones, abra la implementación y seleccione Resultados.
| Resultado | Lo que muestra |
|---|---|
appServiceUrl | La URL en la que se puede acceder a AI Analyst |
keyVaultName | El Key Vault que almacena los secretos |
cognitiveServicesName | La cuenta Azure AI Foundry |
knowledgeHubPrivateLinkState | Si se ha aprobado la conexión con el Knowledge Hub |
1.2 Comprobar la aplicación
- Abra el App Service en el grupo de recursos administrado.
- En la pestaña Resumen, confirme que el Estado muestre
Running. - Abra Supervisión -> Transmisión de registros y confirme que la imagen del contenedor se haya descargado y que la aplicación haya iniciado sin errores.
Si el estado es Running y la transmisión de registros muestra un inicio limpio, la implementación está en buen estado.
Si su rango de IP está en la lista de permitidos, puede además abrir la URL de la aplicación en un navegador. Desde una dirección que no esté en dicha lista, tanto el navegador como la API devolverán 403. Esto indica que la lista de permitidos funciona como está configurada; no es una falla en la implementación.
1.3 Comprobar/configurar la accesibilidad a la base de datos
AI Analyst utiliza integración de red virtual; por lo tanto, todo su tráfico saliente hacia su base de datos sale por la subred de integración de su propia red virtual. Lo que deba configurar depende de la ubicación de la base de datos.
| Ubicación de la base de datos | Qué configurar |
|---|---|
| Azure SQL Database con punto de conexión público | Habilite Permitir que los servicios y recursos de Azure accedan a este servidor en la pestaña de red del SQL Server. Para una configuración más restrictiva, agregue a la lista de permitidos las direcciones IP salientes del App Service en su lugar. |
| Azure SQL Database con punto de conexión privado | Conecte su red virtual con la red virtual de AI Analyst y Link la zona DNS privada privatelink.database.windows.net a la red virtual de AI Analyst para que el nombre privado se resuelva correctamente. |
| MSSQL Server local | Establezca conectividad mediante conexiones híbridas de App Service. |
Documentación oficial de Microsoft:
Azure WebApp registra Database warm-up failed al iniciar hasta que la base de datos sea accesible.
2. Solicitar la aprobación del Private Link
La implementación crea un punto de conexión privado al dab Knowledge Hub. La conexión permanece en estado Pendiente hasta que dab la apruebe, y AI Analyst responde mientras tanto sin el conocimiento de fondo de dab.
Envíe su ID de suscripción y el mensaje de solicitud de Private Link que ingresó durante la implementación a su contacto de dab, o a delivery(at)dab-gmbh.de, para que dab pueda identificar y aprobar la conexión.
3. Actualizar una implementación existente
Para cambiar la configuración posteriormente, inicie de nuevo la implementación desde la oferta en Marketplace y seleccione el mismo grupo de recursos. Azure actualizará en su lugar los recursos existentes y solo modificará las propiedades que sean diferentes.
La implementación no puede leer los secretos existentes. En cada nueva implementación debe ingresar todos los valores de los secretos, incluso si solo quiere modificar la lista de IP permitidas. Ingrese los mismos valores para mantenerlos, o nuevos valores para renovarlos. Los valores vacíos o de prueba sobrescriben los secretos funcionales y dañan la implementación.
Los cambios más frecuentes son:
- Escalar el App Service Plan hacia arriba o hacia abajo
- Agregar rangos de IP a la lista de permitidos, lo que también puede hacer sin una nueva implementación en el Azure Portal, en App Service -> Redes -> Restricciones de acceso
- Cambiar el modelo o su capacidad
- Renovar la clave API de AIA o el secreto del token de sesión
dab no prescribe un intervalo de rotación para la clave API de AIA, el secreto de token de sesión ni las credenciales de la base de datos. Rote estos valores conforme a la política de seguridad de su organización.
Una rotación no requiere una nueva implementación: actualice el valor del secreto en el Key Vault de la Managed Application y reinicie la aplicación web en App Service -> Resumen -> Reiniciar. La aplicación lee el nuevo valor al iniciar.
5. Actualizar la aplicación a una nueva versión
dab AI Analyst se ejecuta como una imagen de contenedor que se descarga desde el registro de contenedores de dab. Para actualizar a la versión más reciente, reinicie la aplicación web en el Azure Portal bajo App Service -> Resumen -> Reiniciar. Al iniciar, el App Service descarga la imagen más reciente; no se requiere una nueva implementación ni volver a ingresar los secretos.
Esto cubre únicamente actualizaciones a la aplicación. Si una nueva versión también requiere cambios en la infraestructura subyacente (por ejemplo, nuevos recursos, configuraciones o permisos), dab le informará previamente y le proporcionará instrucciones. En ese caso, la actualización se realiza reimplementando la Managed Application según lo descrito en la sección 3.
4. Obtener ayuda
Si la implementación falla, consulte Problemas de implementación. Si la aplicación se implementa pero no funciona como se espera, consulte Problemas posteriores a la implementación.