Création d'une application

Les applications définissent des paramètres d'exécution gérés pour les déploiements hébergés, y compris l'évolutivité, le stockage géré, le réseau et l'authentification. Cette tâche explique comment créer une application à l'aide de la console Oracle Cloud du service d'intelligence artificielle générative pour OCI.

Dans la page de liste Applications, sélectionnez Créer une application. Si vous avez besoin d'aide pour trouver la page de liste, voir Liste des applications.

Informations de base

Entrez un nom pour l'application.
Commencez le nom par une lettre ou un trait de soulignement, suivi de lettres, de chiffres, de tirets ou de traits de soulignement. Il peut comporter entre 1 et 255 caractères.
(Facultatif) Entrez une description pour l'application.
Sélectionnez un compartiment dans lequel créer l'application. Le compartiment par défaut est le même que la page de liste, mais vous pouvez sélectionner tout compartiment que vous êtes autorisé à utiliser.

Marqueurs

(Facultatif) Sélectionnez Ajouter un marqueur et affectez des marqueurs à cette application. Voir Marqueurs de ressource.
Sélectionnez Créer.

Ajustement

Important

Si vous prévoyez d'activer le stockage de fichiers persistant à l'étape 3, réglez Nombre minimal de répliques et Nombre maximal de répliques à 1. Le stockage de fichiers persistant prend en charge une réplique dans cette version.

Pour l'ajustement automatique, définissez l'ajustement des déploiements hébergés pour gérer la charge.
- Nombre minimal de répliques
  Nombre minimal de répliques qui doivent toujours être en cours d'exécution. Cette valeur doit être inférieure ou égale à la valeur maximale des répliques. La valeur par défaut est 1.
- Nombre maximal de répliques
  Nombre maximal de répliques pouvant être exécutées. De nouvelles répliques sont ajoutées à mesure que la charge augmente, jusqu'à cette limite. La valeur par défaut est 3 et la valeur maximale est 30. Pour désactiver l'ajustement automatique, réglez cette valeur à Minimum de répliques.
Sélectionnez une mesure d'ajustement.
Le service ajoute des répliques lorsque la mesure sélectionnée dépasse la cible configurée, jusqu'à la valeur maximale des répliques.
- Utilisation d'UC (%)
  Ajoute des répliques lorsque l'utilisation d'UC dépasse ce pourcentage, jusqu'au nombre maximal de répliques que vous avez défini. Intervalle :50–95%.
- Utilisation de mémoire (%)
  Ajoute des répliques lorsque l'utilisation de la mémoire dépasse ce pourcentage, jusqu'au nombre maximal de répliques que vous avez défini. Intervalle :50–95%.
- Demandes concurrentes
  Ajoute des répliques lorsque les demandes concurrentes dépassent cette valeur, jusqu'au nombre maximal de répliques que vous avez défini. Intervalle : 1–500.
- Demandes par seconde (RPS)
  Ajoute des répliques lorsque les demandes par seconde dépassent la cible configurée, jusqu'au nombre maximal de répliques que vous avez défini.

Stockage

À l'étape 3, activez le stockage géré par le service dont les déploiements dans l'application ont besoin : File Storage, OCI PostgreSQL, OCI Cache ou Oracle Autonomous AI Database. Vous pouvez attacher une ressource de stockage de chaque type.

Le stockage de fichiers est disponible au niveau d'un chemin de montage de conteneur. Les détails de connexion à la base de données et au cache sont fournis au moyen de variables d'environnement. Le service gère l'accès au stockage de l'application.

Dans le service Stockage, activez les options dont votre application a besoin.

Stockage de fichiers persistant
Conservez les fichiers entre les redémarrages et les redéploiements de conteneur. Chaque application peut avoir un fichier joint de stockage de fichiers avec un quota fixe de 50 Go (50 000 000 000 octets).
Pour cette option :
1. Activez le stockage de fichiers persistant.
2. Assurez-vous que Le nombre minimal de répliques et Le nombre maximal de répliques dans les paramètres d'ajustement sont tous les deux 1. Le stockage de fichiers persistant prend en charge une réplique dans cette version.
3. Sous Stockage, sélectionnez une des options suivantes :
  - Créer un stockage : Entrez un nom de stockage. Le service crée une configuration de stockage dans le compartiment de l'application.
  - Sélectionner un stockage existant dans le compartiment courant : Sous Nom du stockage, sélectionnez une ressource de stockage de fichiers active. Vous pouvez utiliser Rechercher et filtrer pour rechercher une ressource. Si aucun stockage de fichiers actif n'est disponible, sélectionnez Créer un stockage.
4. Pour Chemin de montage, conservez /mnt/persistent/data ou entrez un autre chemin de conteneur absolu valide. Vous ne pouvez pas modifier ce chemin après la création de l'application.
Les applications qui utilisent la même ressource de stockage reçoivent des systèmes de fichiers distincts. La sélection d'un stockage existant réutilise sa configuration. Il ne partage pas les fichiers d'une autre application.
Configurez votre application pour lire et écrire des fichiers persistants au niveau du chemin de montage. Le stockage de fichiers n'utilise pas de variable d'environnement pour les informations de connexion. Pour les exigences de chemin, la configuration d'API et le statut des fichiers joints, voir Stockage de fichiers persistant pour les applications hébergées.
PostgreSQL pour OCI
Activer OCI PostgreSQL pour fournir une base de données gérée pour les déploiements dans cette application.
Pour cette option :
- Entrez le nom de la variable d'environnement qui reçoit l'URI de connexion PostgreSQL pour OCI. Le service ajoute la chaîne de connexion à la variable d'environnement spécifiée.
- Stockage : Indiquez s'il faut créer ou utiliser un stockage existant. Si vous sélectionnez un stockage existant, l'application partage la ressource de stockage OCI PostgreSQL avec d'autres applications de la location. Une base de données dédiée est affectée à chaque application et cette dernière est autorisée à accéder uniquement à sa base de données dédiée.
Cache OCI
Activer le cache OCI pour fournir un cache géré pour les déploiements dans cette application. Pour cette option :
- Entrez le nom de la variable d'environnement qui reçoit l'URI de connexion au cache OCI.
- Stockage : Indiquez s'il faut créer ou utiliser un stockage existant.
Oracle Autonomous Database
Permettez à Oracle Autonomous AI Database de fournir une base de données gérée pour les déploiements dans cette application. Pour cette option :
- Entrez le nom de la variable d'environnement qui reçoit l'URI de connexion à la base de données d'intelligence artificielle autonome.
En plus de la chaîne de connexion, le service monte les données d'identification de l'utilisateur de base de données dans les fichiers locaux suivants du conteneur :
```
/mnt/secrets/adb/username
/mnt/secrets/adb/password
```

Environnement

(Facultatif) Entrez une ou plusieurs variables d'environnement pour le déploiement en tant que paires clé-valeur. Pour chaque variable, entrez le nom de la variable d'environnement et sa valeur. Ajoutez autant de variables que nécessaire à l'application.
(Facultatif) Pour Variables d'environnement de chambre forte, entrez les informations suivantes :
- Nom de variable
- OCID de la chambre forte
- Clé de chambre forte
- Le service ajoute les informations de chambre forte au conteneur en tant que fichier JSON. Exemple de code JSON :
```
{
    "vaultId":<vault-ocid>,
    "key":<the secret in the vault>
}
```

Service de réseau (facultatif)

Sélectionnez la façon dont les déploiements de cette application acheminent le trafic sortant et la façon dont les clients accèdent au point d'extrémité de déploiement.

Pour Réseau, sélectionnez une des options suivantes.
- Par défaut (géré par le service)
  Permet l'accès sortant aux services OCI et à l'Internet public au moyen d'un réseau géré par le service.
- Personnalisé (géré par le client)
  Achemine le trafic sortant au moyen d'un VCN et d'un sous-réseau de la location à l'aide d'une connexion de point d'extrémité privé. Cette option est recommandée pour les déploiements privés intégrés à l'entreprise. Pour cette option, sélectionnez les options suivantes :
  - Compartiment du réseau en nuage virtuel
  - VCN
  - Compartiment du sous-réseau
  - Sous-réseau
  Note
  
  Si vous sélectionnez un réseau personnalisé, tout le trafic sortant est acheminé vers le sous-réseau VCN. Si l'application a également besoin d'un accès Internet, envisagez d'utiliser un sous-réseau public et de configurer la table de routage. Voir Passerelle Internet.
Indiquez si le déploiement actif de cette application est accessible au moyen d'un point d'extrémité public ou privé.
- Publics
  Accessible à partir de l'extérieur du VCN.
- Privé
  Accessible uniquement à partir du VCN.
  Important
  
  Vous devez utiliser un point d'extrémité privé du service d'intelligence artificielle générative. Si vous n'en avez pas, créez un point d'extrémité privé du service d'intelligence artificielle générative.
  Sélectionnez les informations suivantes :
  - Compartiment du point d'extrémité privé
  - Point d'extrémité privé
Une fois l'application créée, vous pouvez y accéder au moyen de ce point d'extrémité privé à l'aide de son nom de domaine complet ou de son adresse IP. Exemple de nom de domaine complet :
```
https://<pe-name>.pe.inference.generativeai.<region>
.oci.oraclecloud.com/20251112/hostedApplications/{your_application_ocid}
```

Authentication

À l'étape 6, sélectionnez l'une des options d'authentification suivantes :

Jeton du porteur du domaine d'identité : Utilise un jeton d'accès OAuth émis par un domaine d'identité IAM OCI. Le jeton est envoyé au service cible en tant que jeton porteur, et le service valide le jeton avant d'accepter la demande. Comme préalable, effectuez les tâches sous Configuration de l'authentification par jeton de porteur de domaine d'identité.
Session du navigateur de domaine d'identité : Utilise le flux de code d'autorisation OAuth 2.1 avec la clé de vérification pour l'échange de code (PKCE). Les utilisateurs du navigateur sont redirigés vers un domaine d'identité OCI pour se connecter. Le service d'application hébergé obtient un jeton d'accès en son nom et établit une session de navigateur qui utilise un témoin de session.
OCI IAM : Utilise l'authentification de signature de demande OCI IAM. Chaque demande est signée cryptographiquement selon les exigences de signature de demande de l'API OCI.
Aucune authentification : Autorise les demandes sans authentification gérée par la plate-forme. Utilisez cette option pour le contenu public ou lorsque votre application gère l'authentification.

Note

Lorsque vous utilisez l'API, utilisez CreateHostedApplication pour l'authentification de domaine d'identité ou aucune authentification. Dans inboundAuthConfig, réglez inboundAuthConfigType à l'une des valeurs suivantes :

IDCS_AUTH_CONFIG : Authentification par jeton du porteur du domaine d'identité.
IDCS_SESSION_AUTH_CONFIG : Authentification de session du navigateur de domaine d'identité à l'aide du flux de code d'autorisation OAuth 2.1 avec PKCE.
NO_AUTH_CONFIG : Désactive l'authentification de l'appelant gérée par la plate-forme. Omettre idcsConfig.

Pour l'un ou l'autre des types d'authentification de domaine d'identité, incluez idcsConfig avec les valeurs domainUrl et scope requises. Le schéma d'API marque audience comme facultatif. Elle définit également clientId et clientSecretVaultId comme des champs facultatifs qui s'appliquent uniquement à IDCS_SESSION_AUTH_CONFIG. La valeur clientSecretVaultId est l'OCID d'une clé secrète de chambre forte OCI contenant la clé secrète client OAuth. Pour plus de détails, consultez InboundAuthConfig et IdcsAuthConfig.

Pour configurer l'absence d'authentification, indiquez l'objet suivant. Aucune inscription de location distincte n'est requise.

"inboundAuthConfig": {
  "inboundAuthConfigType": "NO_AUTH_CONFIG"
}

Si vous omettez inboundAuthConfig d'une mise à jour, la configuration d'authentification courante de l'application reste inchangée. Pour désactiver explicitement l'authentification d'appelant gérée par la plate-forme, réglez inboundAuthConfigType à NO_AUTH_CONFIG et omettez idcsConfig.

Pour créer une application qui utilise l'authentification OCI IAM, utilisez CreateHostedApplicationIam avec CreateHostedApplicationIamDetails. L'API OCI IAM ne nécessite pas de configuration OAuth ou IDCS.

Suivez les étapes pour le type d'authentification que vous sélectionnez.

Jeton du porteur du domaine d'identité

Pour Type d'authentification, sélectionnez Jeton du porteur du domaine d'identité.
Sélectionnez une des options suivantes :
- Sélectionner un domaine d'identité existant
  Utilisez le même domaine d'identité dans lequel vous avez créé l'application intégrée confidentielle à l'étape 2. Créer une application dans le domaine d'identité. Sélectionnez des valeurs pour les champs suivants :
  - Compartiment de domaine d'identité
  - Domaine d'identité
- Coller une URL de domaine d'identité
  Exemple : https://idcs-xxx.identity.oraclecloud.com:443
Pour Portée, entrez l'étendue configurée pour l'application dans le domaine d'identité.

L'étendue spécifie les autorisations accordées par le jeton d'accès. Utilisez la portée configurée à l'étape 3. Configurez les paramètres OAuth.
(Facultatif) Pour Groupe cible, entrez le groupe cible configuré pour l'application dans le domaine d'identité.

L'audience identifie le service ou l'API auquel le jeton d'accès est destiné. Pour trouver cette valeur, ouvrez l'application intégrée dans le domaine d'identité, sélectionnez Configuration OAuth et copiez le public principal.
Sélectionnez Suivant.

Session de navigateur du domaine d'identité

Obtenez l'URL du domaine d'identité, l'étendue, l'audience et l'ID client pour l'application OAuth configurée pour le flux de code d'autorisation avec PKCE. Stockez la clé secrète client OAuth dans le service de chambre forte OCI et enregistrez l'OCID de la clé secrète pour le champ ID chambre forte de clé secrète client.

Pour Type d'authentification, sélectionnez Session de navigateur de domaine d'identité.
Sous Type, sélectionnez l'une des options suivantes :
- Sélectionner un domaine d'identité existant : Sélectionnez le compartiment du domaine d'identité et le domaine d'identité pour l'application OAuth.
- Coller une URL de domaine d'identité : Entrez l'URL du domaine d'identité. Par exemple, https://idcs-xxx.identity.oraclecloud.com:443.
Entrez les valeurs suivantes requises par la console pour l'application OAuth :
- Portée : Portée configurée dans le domaine d'identité.
- Groupe cible : Groupe cible configuré dans le domaine d'identité.
- ID client OAuth : ID client de l'application OAuth utilisée pour la connexion au navigateur.
- ID chambre forte de clé secrète client : OCID de la clé secrète du service de chambre forte OCI contenant la clé secrète client de l'application OAuth.
(Facultatif) Sous Modèles de chemin d'accès public, sélectionnez Ajouter un modèle de chemin public et entrez un chemin accessible sans authentification. Répétez cette opération pour chaque chemin supplémentaire.

Les chemins doivent commencer par une barre oblique. Par exemple, /health et /assets/*. Les demandes pour les chemins correspondants ignorent l'authentification. Ajoutez uniquement des chemins destinés à l'accès sans vous connecter.
Sélectionnez Suivant.

OCI IAM

Pour Type d'authentification, sélectionnez OCI IAM.

Cette option utilise l'authentification de signature de demande OCI IAM et ne nécessite pas de paramètres de domaine d'identité.
Sélectionnez Suivant.

Aucune authentification

Avec cette option, toute personne pouvant atteindre le point d'extrémité peut envoyer des demandes sans authentification gérée par la plate-forme. Si l'accès nécessite une restriction, votre application doit appliquer l'authentification et l'autorisation. Voir Aucune authentification.

Pour Type d'authentification, sélectionnez Aucune authentification.
Aucun champ d'authentification supplémentaire n'est requis.
Sélectionnez Suivant.

Activer les journaux d'application

Activez la journalisation des ressources pour suivre l'activité des applications, résoudre les problèmes et collecter des informations opérationnelles pour les déploiements hébergés.

(Facultatif) Activez Activer le journal.
Pour Catégorie, sélectionnez genai-hosted-deployment-log ou créez un nouveau groupe de journaux.
Pour Groupe de journaux, sélectionnez un groupe de journaux existant ou sélectionnez Créer un nouveau groupe de journaux.
Sélectionnez le compartiment qui contient le groupe de journaux.
Entrez un nom de journal.
(Facultatif) Sous Options avancées, sélectionnez une période de conservation des journaux.
La période de conservation par défaut est de 1 mois (30 jours).

Vérifier et créer

Vérifiez les paramètres de l'application, puis sélectionnez Créer une application.

Note

Le temps de création de l'application dépend des ressources que le service provisionne pour l'application.

Si le stockage géré est activé, le service provisionne ou attache le stockage sélectionné, ce qui peut prendre plusieurs minutes.
Si l'option Réseau personnalisé est sélectionnée, le service provisionne les ressources de pontage de réseau requises, ce qui peut également prendre plusieurs minutes.

Vérifiez les paramètres et sélectionnez Créer une application.

Si vous avez sélectionné Aucune authentification, vérifiez que le type d'authentification affiche cette valeur.

Après la création, voir Type d'authentification sous Authentification dans l'onglet Configuration de l'application.

Conseil

Après avoir créé une application, vous pouvez voir ses détails et effectuer d'autres tâches, telles que le déplacement vers un autre compartiment, la gestion de ses marqueurs ou leur suppression. Utilisez le menu Actions (trois points) de la console pour accéder à ces tâches. Vous pouvez également créer un déploiement pour l'application à partir de sa page de détails. Pour plus d'informations, voir Liste des applications.

Documentation sur Oracle Cloud Infrastructure