Creación de una aplicación

Las aplicaciones definen la configuración de tiempo de ejecución gestionado para despliegues alojados, incluidos el escalado, el almacenamiento gestionado, las redes y la autenticación. En esta tarea se explica cómo crear una aplicación mediante la consola de Oracle Cloud en el servicio OCI Generative AI.

En la página de lista Aplicaciones, seleccione Crear aplicación. Si necesita ayuda para buscar la página de lista, consulte Listado de aplicaciones.

Información Básica

Introduzca un nombre para la aplicación.
Inicie el nombre con una letra o guion bajo, seguido de letras, números, guiones o guiones bajos. La longitud puede abarcar de 1 a 255 caracteres.
(Opcional) Introduzca una descripción para la aplicación.
Seleccione el compartimento en el que desea crear la aplicación. El compartimento por defecto es el que ha seleccionado en la página de lista, pero puede seleccionar cualquier compartimento en el que tenga permiso para trabajar.

Escalado

Para la escala automática, defina cómo se escalan los despliegues alojados para manejar la carga.
- Réplicas mínimas
  Número mínimo de réplicas que deben estar siempre en ejecución. Este valor debe ser menor o igual que el máximo valor de réplicas. El valor por defecto es 1.
- Número máximo de réplicas
  Número máximo de réplicas que se pueden ejecutar. Se agregan nuevas réplicas a medida que aumenta la carga, hasta este límite. El valor por defecto es 3 y el máximo es 30. Para desactivar la escala automática, defina este valor como Mínimo de réplicas.
Seleccione una métrica de escala.
El servicio agrega réplicas cuando la métrica seleccionada supera el destino configurado, hasta el valor máximo de réplicas.
- Uso de CPU (%)
  Agrega réplicas cuando el uso de CPU supera este porcentaje, hasta el máximo de réplicas que defina. Rango: de 50 a 95%.
- Uso de Memoria (%)
  Agrega réplicas cuando el uso de memoria supera este porcentaje, hasta el máximo de réplicas que defina. Rango: de 50 a 95%.
- Solicitudes simultáneas
  Agrega réplicas cuando las solicitudes simultáneas superan este valor, hasta el máximo de réplicas que defina. Rango: de 1 a 500.
- Solicitudes por segundo (RPS)
  Agrega réplicas cuando las solicitudes por segundo superan el destino configurado, hasta el máximo de réplicas que defina.

Almacenamiento (opcional)

Si los despliegues de la aplicación necesitan almacenamiento gestionado por servicios, puede activar OCI PostgreSQL, OCI Cache u Oracle Autonomous AI Database.

Active el almacenamiento gestionado para los despliegues alojados asociados a esta aplicación. El servicio crea y gestiona el almacenamiento gestionado y solo se puede acceder a él desde el despliegue alojado asociado a esta aplicación. Los detalles de conexión se proporcionan al contenedor mediante variables de entorno.

Si la aplicación necesita almacenamiento gestionado, active una de las siguientes opciones.

PostgreSQL OCI
Active OCI PostgreSQL para proporcionar una base de datos gestionada para los despliegues en esta aplicación.
Para esta opción:
- Introduzca el nombre de variable del entorno que recibe el URI del PostgreSQL de conexión de OCI. El servicio agrega la cadena de conexión a la variable de entorno especificada.
- Almacenamiento: seleccione si desea crear almacenamiento o utilizar almacenamiento existente. Si selecciona el almacenamiento existente, la aplicación comparte el recurso de almacenamiento de OCI PostgreSQL con otras aplicaciones del arrendamiento. A cada aplicación se le asigna una base de datos dedicada y esta aplicación tiene permiso para acceder solo a su base de datos dedicada.
Caché de OCI
Active OCI Cache para proporcionar una caché gestionada para los despliegues en esta aplicación. Para esta opción:
- Introduzca el nombre de la variable de entorno que recibe el URI para la conexión de OCI Cache.
- Almacenamiento: seleccione si desea crear almacenamiento o utilizar almacenamiento existente.
Oracle Autonomous Database
Permite que Oracle Autonomous AI Database proporcione una base de datos gestionada para despliegues en esta aplicación. Para esta opción:
- Introduzca el nombre de variable de entorno que recibe el URI para la conexión de la base de datos de IA autónoma.
Además de la cadena de conexión, el servicio monta las credenciales de usuario de la base de datos en los siguientes archivos locales del contenedor:
```
/mnt/secrets/adb/username
/mnt/secrets/adb/password
```

Entorno

(Opcional) Introduzca una o más variables de entorno para el despliegue como pares clave-valor. Para cada variable, introduzca el nombre de la variable de entorno y su valor. Agregue tantas variables como necesite la aplicación.
(Opcional) En Variables de entorno de almacén, introduzca lo siguiente:
- Nombre de variable
- OCID de almacén
- Clave de almacén
- El servicio agrega la información del almacén al contenedor como un archivo JSON. Ejemplo de código JSON:
```
{
    "vaultId":<vault-ocid>,
    "key":<the secret in the vault>
}
```

Redes (opcional)

Seleccione cómo enrutan los despliegues de esta aplicación el tráfico saliente y cómo acceden los clientes al punto final de despliegue.

Para Red, seleccione una de las siguientes opciones.
- Por defecto (gestionado por servicios)
  Permite el acceso saliente a los servicios de OCI y a la red pública de Internet a través de una red gestionada por servicios.
- Personalizado (gestionado por el cliente)
  Enruta el tráfico saliente a través de una VCN y una subred del arrendamiento mediante una conexión de punto final privado. Esta opción se recomienda para despliegues privados integrados en la empresa. Para esta opción, seleccione lo siguiente:
  - Compartimento de VCN
  - VCN
  - Compartimento de subred
  - Subred
  Nota
  
  Si selecciona una red personalizada, todo el tráfico de salida se direcciona a la subred de la VCN. Si la aplicación también necesita acceso a Internet, considere el uso de una subred pública y la configuración de la tabla de rutas. Consulte Gateway de internet.
Seleccione si se accede al despliegue activo para esta aplicación a través de un punto final público o privado.
- Público
  Accesible desde fuera de la VCN.
- Privado
  Accesible solo desde la VCN.
  Importante
  
  Debe utilizar un punto final privado de IA generativa. Si no tiene uno, cree un punto final privado de IA generativa.
  Seleccione la siguiente información:
  - Compartimento de punto final privado
  - Punto final privado
Una vez creada la aplicación, puede acceder a ella a través de este punto final privado mediante su FQDN o dirección IP. Ejemplo de FQDN:
```
https://<pe-name>.pe.inference.generativeai.<region>
.oci.oraclecloud.com/20251112/hostedApplications/{your_application_ocid}
```

Autenticación

Seleccione uno de los siguientes métodos de autenticación:

Token de portador de dominio de identidad: utiliza un token de acceso OAuth emitido por un dominio de identidad de OCI IAM. El token se envía al servicio de destino como un token portador y el servicio valida el token antes de aceptar la solicitud. Como requisito, realice las tareas de Configuración de la autenticación de token de portador de dominio de identidad.
Sesión del explorador de dominio de identidad: utiliza el flujo de código de autorización OAuth 2.1 con la clave de prueba para el intercambio de código (PKCE). Los usuarios del explorador se redirigen a un dominio de identidad de OCI para conectarse. El servicio de aplicación alojado obtiene un token de acceso en su nombre y establece una sesión de explorador que utiliza una cookie de sesión.
OCI IAM: utiliza la autenticación de firma de solicitud de OCI IAM. Cada solicitud se firma criptográficamente según los requisitos de firma de solicitudes de la API de OCI.

Nota

Al utilizar la API, utilice CreateHostedApplication para cualquier método de autenticación de dominio de identidad. En inboundAuthConfig, defina inboundAuthConfigType en uno de los siguientes valores:

IDCS_AUTH_CONFIG: autenticación de token de portador de dominio de identidad.
IDCS_SESSION_AUTH_CONFIG: autenticación de sesión del explorador del dominio de identidad mediante el flujo de código de autorización OAuth 2.1 con PKCE.

Para cualquiera de los tipos, incluya idcsConfig con los valores domainUrl y scope necesarios. El esquema de API marca audience como opcional. También define clientId y clientSecretVaultId como campos opcionales que solo se aplican a IDCS_SESSION_AUTH_CONFIG. El valor clientSecretVaultId es el OCID de un secreto de OCI Vault que contiene el secreto de cliente OAuth. Para obtener más información, consulte InboundAuthConfig y IdcsAuthConfig.

Si se omite inboundAuthConfig de una actualización, la configuración de autenticación actual de la aplicación no cambia.

Para crear una aplicación que utilice la autenticación de OCI IAM, utilice CreateHostedApplicationIam con CreateHostedApplicationIamDetails. La API de OCI IAM no necesita una configuración de OAuth o IDCS.

Siga los pasos para el tipo de autenticación que seleccione. El token de portador de dominio de identidad existente y la autenticación de OCI IAM siguen estando soportados. Después de crear una aplicación, puede seleccionar Editar en su página de detalles para cambiar el tipo de autenticación.

Token de portador de dominio de identidad

En Tipo de autenticación, seleccione Token de portador de dominio de identidad.
Seleccione una de las siguientes opciones:
- Seleccione un dominio de identidad existente
  Utilice el mismo dominio de identidad en el que ha creado la aplicación integrada confidencial en el Step 2. Cree una aplicación en el dominio de identidad. Seleccione valores para los siguientes campos:
  - Compartimento de dominio de identidad
  - Dominio de identidad
- Pegar una URL de dominio de identidad
  Ejemplo: https://idcs-xxx.identity.oraclecloud.com:443
En Ámbito, introduzca el ámbito configurado para la aplicación en el dominio de identidad.

El ámbito especifica los permisos que otorga el token de acceso. Utilice el ámbito configurado en el Step 3. Configure los valores de OAuth.
(Opcional) En Destinatario, introduzca el público configurado para la aplicación en el dominio de identidad.

El público identifica el servicio o la API a los que está destinado el token de acceso. Para buscar este valor, abra la aplicación integrada en el dominio de identidad, seleccione OAuth configuration y copie el destino principal.
Seleccione Next (Siguiente).

Sesión de explorador del dominio de identidad

Obtenga la URL, el ámbito, el público y el ID de cliente del dominio de identidad para la aplicación OAuth configurada para el flujo de código de autorización con PKCE. Almacene el secreto de cliente OAuth en OCI Vault y registre el OCID del secreto para el campo ID de almacén de secreto de cliente.

Para Tipo de autenticación, seleccione Sesión de explorador de dominio de identidad.
En Tipo, seleccione una de las siguientes opciones:
- Seleccionar un dominio de identidad existente: seleccione el compartimento de dominio de identidad y el dominio de identidad para la aplicación OAuth.
- Pegar una URL de dominio de identidad: introduzca la URL de dominio de identidad. Por ejemplo, https://idcs-xxx.identity.oraclecloud.com:443.
Introduzca los siguientes valores que necesita la consola para la aplicación OAuth:
- Ámbito: ámbito configurado en el dominio de identidad.
- Destinatario: público configurado en el dominio de identidad.
- ID de cliente OAuth: ID de cliente de la aplicación OAuth utilizada para la conexión del explorador.
- ID de almacén de secretos de cliente: OCID del secreto de OCI Vault que contiene el secreto de cliente de la aplicación OAuth.
(Opcional) En Patrones de ruta de acceso pública, seleccione Agregar patrón de ruta de acceso pública e introduzca una ruta a la que se pueda acceder sin autenticación. Repita esta acción para cada ruta adicional.

Las rutas deben comenzar con una barra inclinada. Algunos ejemplos son /health y /assets/*. Las solicitudes para rutas coincidentes omiten la autenticación. Agregue solo rutas de acceso destinadas al acceso sin iniciar sesión.
Seleccione Next (Siguiente).

IAM de OCI

En Tipo de autenticación, seleccione OCI IAM.

Esta opción utiliza la autenticación de firma de solicitud de OCI IAM y no necesita la configuración del dominio de identidad.
Seleccione Next (Siguiente).

Activar logs de aplicación

Active el registro de recursos para realizar un seguimiento de la actividad de la aplicación, solucionar problemas y recopilar estadísticas operativas para despliegues alojados.

(Opcional) Active Activar log.
Para Categoría, seleccione genai-hosted-deployment-log o cree un nuevo grupo de logs.
Para Grupo de logs, seleccione un grupo de logs ya existente o seleccione Crear nuevo grupo de logs.
Seleccione el compartimento que contiene el grupo de logs.
Introduzca un nombre de log.
(Opcional) En Opciones avanzadas, seleccione un período de retención de log.
El período de retención por defecto es 1 mes (30 días).

Revisar y crear

Revise la configuración de la aplicación y, a continuación, seleccione Crear aplicación.

Nota

El tiempo de creación de la aplicación depende de los recursos que aprovisione el servicio para la aplicación.

Si el almacenamiento gestionado está activado, el servicio aprovisiona una instancia de almacenamiento dedicada, que puede tardar varios minutos.
Si se selecciona custom networking, el servicio aprovisiona los recursos de puente de red necesarios, que también pueden tardar varios minutos.

Revise la configuración y seleccione Crear aplicación.

Consejo

Después de crear una aplicación, puede ver sus detalles y realizar otras tareas, como moverla a un compartimento diferente, gestionar sus etiquetas o suprimirla. Utilice el menú Acciones (tres puntos) de la consola para acceder a estas tareas. También puede crear un despliegue para la aplicación desde su página de detalles. Para obtener más información, consulte Listado de aplicaciones.

Documentación de Oracle Cloud Infrastructure