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 2.0 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 previo, realice las tareas de Setting up Authentication for Agentic Support.
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 la API CreateHostedApplication para la autenticación de token de portador de dominio de identidad con InboundAuthConfig. Para crear una aplicación que utilice la autenticación de OCI IAM, utilice la API de CreateHostedApplicationIam con CreateHostedApplicationIamDetails. La API de OCI IAM no necesita una configuración de OAuth o IDCS.

Para el token de portador de dominio de identidad, realice los siguientes pasos:

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:
- Seleccionar un dominio de identidades 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.
  - Compartimento de dominio de identidad
  - Dominio de identidad
- Pegar una URL de dominio de identidad
  Ejemplo: https://idcs-xxx.identity.oraclecloud.com:443
Para el dominio de identidad, introduzca valores para los siguientes parámetros:
- Ámbito
  Especifica las acciones que el token de acceso puede realizar. Ejemplos: user.read, email.
- Público
  Especifica el servicio o la API a los que está destinado el token de acceso. El servidor de recursos de destino acepta el token solo cuando la reclamación de público coincide con ese servidor.
  Para buscar este valor, abra la consola del dominio de identidad y seleccione la aplicación integrada que ha creado en el Step 2. Cree una aplicación en el dominio de identidad. Seleccione Configuración de OAuth, copie el destino principal y péguelo aquí.
  Ejemplos:
```
https://api.example.com
```
```
https://my-service.internal
```
```
urn:my-resource-server
```
```
ocid1.resourceServer.oc1..xxxx
```

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