Creazione di un'applicazione

Le applicazioni definiscono le impostazioni runtime gestite per le distribuzioni in hosting, tra cui scalabilità, storage gestito, networking e autenticazione. Questo task spiega come creare un'applicazione utilizzando la console di Oracle Cloud nel servizio AI generativa OCI.

Nella pagina elenco Applicazioni, selezionare Crea applicazione. Per assistenza nella ricerca della pagina di elenco, vedere Elenco delle applicazioni.

informazioni di base

Immettere un nome per l'applicazione.
Iniziare il nome con una lettera o un carattere di sottolineatura seguito da lettere, numeri, trattini o caratteri di sottolineatura. La lunghezza può essere compresa tra 1 e 255 caratteri.
(Facoltativo) Immettere la descrizione dell'applicazione.
Selezionare un compartimento in cui creare l'applicazione. Il compartimento predefinito è uguale alla pagina di elenco, ma è possibile selezionare qualsiasi compartimento nel quale si è autorizzati a lavorare.

Ridimensionamento

Importante

Se si prevede di abilitare lo storage dei file persistenti nel passo 3, impostare Numero minimo di repliche e Numero massimo di repliche su 1. Lo storage di file persistente supporta una replica in questa release.

Per Ridimensionamento automatico, definire la scalabilità delle distribuzioni in hosting per gestire il carico.
- Numero minimo di repliche
  Numero minimo di repliche che devono essere sempre in esecuzione. Questo valore deve essere minore o uguale al numero massimo di repliche. L'impostazione predefinita è 1.
- Numero massimo di repliche
  Numero massimo di repliche che è possibile eseguire. Nuove repliche vengono aggiunte all'aumentare del carico, fino a questo limite. Il valore predefinito è 3 e il valore massimo è 30. Per disabilitare il ridimensionamento automatico, impostare questo valore su Numero minimo di repliche.
Selezionare una metrica di ridimensionamento.
Il servizio aggiunge le repliche quando la metrica selezionata supera la destinazione configurata, fino al valore massimo delle repliche.
- Utilizzo CPU (%)
  Aggiunge le repliche quando l'utilizzo della CPU supera questa percentuale, fino al numero massimo di repliche impostate. Intervallo: 50–95%.
- Utilizzo memoria (%)
  Aggiunge le repliche quando l'utilizzo della memoria supera questa percentuale, fino al numero massimo di repliche impostate. Intervallo: 50–95%.
- Richieste concorrenti
  Aggiunge le repliche quando le richieste concorrenti superano questo valore, fino al numero massimo di repliche impostate. Intervallo: da 1 a 500.
- Richieste al secondo (RPS)
  Aggiunge le repliche quando le richieste al secondo superano la destinazione configurata, fino al numero massimo di repliche impostate.

Storage

Nel passo 3, abilita lo storage gestito dal servizio che le distribuzioni nell'applicazione richiedono: File Storage, OCI PostgreSQL, OCI Cache o Oracle Autonomous AI Database. È possibile collegare una risorsa di storage di ogni tipo.

Lo storage di file è disponibile in un percorso di accesso contenitore. I dettagli di connessione al database e alla cache vengono forniti tramite variabili di ambiente. Il servizio gestisce l'accesso allo storage dell'applicazione.

In Memorizzazione, attivare le opzioni richieste dall'applicazione.

Archiviazione file persistente
Conserva i file tra i riavvii e le ridistribuzioni dei container. Ogni applicazione può avere un allegato di storage dei file con una quota fissa di 50 GB (50.000.000.000 di byte).
Per questa opzione:
1. Attivare Archiviazione file persistente.
2. Assicurarsi che le repliche minime e le repliche massime nelle impostazioni di scala siano entrambe 1. Lo storage di file persistente supporta una replica in questa release.
3. In Memorizzazione selezionare una delle opzioni riportate di seguito.
  - Crea un nuovo storage: immettere un nome di storage. Il servizio crea una configurazione di storage nel compartimento dell'applicazione.
  - Selezionare uno storage esistente nel compartimento corrente: in Nome storage, selezionare una risorsa di storage dei file attiva. È possibile utilizzare Cerca e filtra per trovare una risorsa. Se non è disponibile uno storage di file attivo, selezionare Crea un nuovo storage.
4. Per Percorso MOUNT, mantenere /mnt/persistent/data o immettere un altro percorso contenitore assoluto valido. Impossibile modificare questo percorso dopo la creazione dell'applicazione.
Le applicazioni che utilizzano la stessa risorsa di storage ricevono file system separati. La selezione dello storage esistente ne riutilizza la configurazione. Non condivide i file di un'altra applicazione.
Configurare l'applicazione in modo che legga e scriva i file persistenti nel percorso di accesso. Lo storage di file non utilizza una variabile di ambiente per le informazioni di connessione. Per i requisiti di percorso, configurazione API e stato degli allegati, vedere Storage di file persistente per le applicazioni in hosting.
PostgreSQL OCI
Abilitare OCI PostgreSQL per fornire un database gestito per le distribuzioni in questa applicazione.
Per questa opzione:
- Immettere il nome della variabile di ambiente che riceve l'URI di connessione PostgreSQL OCI. Il servizio aggiunge la stringa di connessione alla variabile di ambiente specificata.
- Memorizzazione: selezionare se creare o utilizzare lo storage esistente. Se si seleziona lo storage esistente, l'applicazione condivide la risorsa di storage OCI PostgreSQL con altre applicazioni nella tenancy. A ogni applicazione viene assegnato un database dedicato e questa applicazione dispone dell'autorizzazione per accedere solo al proprio database dedicato.
Cache OCI
Abilitare la cache OCI per fornire una cache gestita per le distribuzioni in questa applicazione. Per questa opzione:
- Immettere il nome della variabile di ambiente che riceve l'URI di connessione cache OCI.
- Memorizzazione: selezionare se creare o utilizzare lo storage esistente.
Oracle Autonomous Database
Consenti a Oracle Autonomous AI Database di fornire un database gestito per le distribuzioni in questa applicazione. Per questa opzione:
- Immettere il nome della variabile di ambiente che riceve l'URI di connessione Autonomous AI Database.
Oltre alla stringa di connessione, il servizio attiva le credenziali utente del database nei seguenti file locali nel contenitore:
```
/mnt/secrets/adb/username
/mnt/secrets/adb/password
```

Ambiente

(Facoltativo) Immettere una o più variabili di ambiente per la distribuzione come coppie chiave-valore. Per ogni variabile, immettere il nome della variabile di ambiente e il relativo valore. Aggiungere tutte le variabili necessarie all'applicazione.
(Facoltativo) Per le variabili di ambiente Vault, immettere quanto segue:
- Nome variabile
- OCID vault
- Chiave vault
- Il servizio aggiunge le informazioni del vault al contenitore sotto forma di file JSON. Codice JSON di esempio:
```
{
    "vaultId":<vault-ocid>,
    "key":<the secret in the vault>
}
```

Networking (facoltativo)

Selezionare il modo in cui le distribuzioni in questa applicazione instradano il traffico in uscita e il modo in cui i client accedono all'endpoint di distribuzione.

Per Networking, selezionare una delle opzioni seguenti.
- Predefinito (gestito dal servizio)
  Consente l'accesso in uscita ai servizi OCI e alla rete Internet pubblica tramite una rete gestita dal servizio.
- Personalizzato (gestito dal cliente)
  Esegue l'instradamento del traffico in uscita tramite una VCN e una subnet nella tenancy utilizzando una connessione endpoint privata. Questa opzione è consigliata per le distribuzioni private integrate nell'azienda. Per questa opzione, selezionare quanto segue:
  - Compartimento VCN
  - VCN
  - Compartimento subnet
  - Subnet
  Nota
  
  Se si seleziona la rete personalizzata, tutto il traffico in uscita viene instradato alla subnet VCN. Se l'applicazione richiede anche l'accesso a Internet, prendere in considerazione l'utilizzo di una subnet pubblica e la configurazione della tabella di instradamento. Vedere Gateway Internet.
Selezionare se l'accesso alla distribuzione attiva per questa applicazione avviene tramite un endpoint pubblico o privato.
- Pubblico
  Accessibile dall'esterno della VCN.
- Privato
  Accessibile solo dall'interno della VCN.
  Importante
  
  È necessario utilizzare un endpoint privato AI generativa. Se non ne hai uno, creare un endpoint privato AI generativa.
  Selezionare le informazioni riportate di seguito.
  - Compartimento endpoint privato
  - Endpoint privato
Dopo aver creato l'applicazione, è possibile accedervi tramite questo endpoint privato utilizzando il nome FQDN o l'indirizzo IP. Esempio di FQDN:
```
https://<pe-name>.pe.inference.generativeai.<region>
.oci.oraclecloud.com/20251112/hostedApplications/{your_application_ocid}
```

Autenticazione

Nel passo 6, selezionare una delle seguenti opzioni di autenticazione:

Token bearer del dominio di Identity: utilizza un token di accesso OAuth emesso da un dominio di Identity IAM OCI. Il token viene inviato al servizio di destinazione come token bearer e il servizio convalida il token prima di accettare la richiesta. Come prerequisito, eseguire i task in Impostazione dell'autenticazione del token Bearer del dominio di Identity.
Sessione del browser del dominio di Identity: utilizza il flusso del codice di autorizzazione OAuth 2.1 con chiave di prova per lo scambio di codice (PKCE). Gli utenti del browser vengono reindirizzati a un dominio di Identity OCI per connettersi. Il servizio di applicazione ospitato ottiene un token di accesso per loro conto e stabilisce una sessione del browser che utilizza un cookie di sessione.
OCI IAM: utilizza l'autenticazione della firma di richiesta IAM OCI. Ogni richiesta è firmata crittograficamente in base ai requisiti di firma delle richieste API OCI.
Nessuna autenticazione: consente le richieste senza l'autenticazione gestita dalla piattaforma. Utilizzare questa opzione per il contenuto pubblico o quando l'applicazione gestisce l'autenticazione.

Nota

Quando si utilizza l'interfaccia API, utilizzare CreateHostedApplication per l'autenticazione del dominio di Identity o nessuna autenticazione. In inboundAuthConfig, impostare inboundAuthConfigType su uno dei seguenti valori:

IDCS_AUTH_CONFIG: autenticazione del token bearer del dominio di Identity.
IDCS_SESSION_AUTH_CONFIG: autenticazione della sessione del browser del dominio di Identity mediante il flusso del codice di autorizzazione OAuth 2.1 con PKCE.
NO_AUTH_CONFIG: disabilita l'autenticazione del chiamante gestita dalla piattaforma. Omettere idcsConfig.

Per il tipo di autenticazione del dominio di Identity, includere idcsConfig con i valori domainUrl e scope richiesti. Lo schema API contrassegna audience come facoltativo. Definisce inoltre clientId e clientSecretVaultId come campi facoltativi che si applicano solo a IDCS_SESSION_AUTH_CONFIG. Il valore clientSecretVaultId è l'OCID di un segreto vault OCI contenente il segreto client OAuth. Per informazioni dettagliate, vedere InboundAuthConfig e IdcsAuthConfig.

Per non configurare alcuna autenticazione, specificare l'oggetto seguente. Non è richiesta alcuna iscrizione alla tenancy separata.

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

L'omissione di inboundAuthConfig da un aggiornamento lascia invariata la configurazione di autenticazione corrente dell'applicazione. Per disabilitare in modo esplicito l'autenticazione del chiamante gestito dalla piattaforma, impostare inboundAuthConfigType su NO_AUTH_CONFIG e omettere idcsConfig.

Per creare un'applicazione che utilizza l'autenticazione IAM OCI, utilizzare CreateHostedApplicationIam con CreateHostedApplicationIamDetails. L'API IAM OCI non richiede una configurazione OAuth o IDCS.

Attenersi alla procedura per il tipo di autenticazione selezionato.

Token bearer dominio di Identity

Per Tipo di autenticazione, selezionare Token bearer del dominio di identità.
Selezionare una delle opzioni seguenti:
- Scegliere un dominio di identità esistente
  Utilizzare lo stesso dominio di Identity in cui è stata creata l'applicazione integrata riservata nel Passo 2. Creare un'applicazione nel dominio di Identity. Selezionare valori per i campi seguenti:
  - Compartimento del dominio di identità
  - Dominio di Identity
- Incolla un URL del dominio di identità
  Esempio: https://idcs-xxx.identity.oraclecloud.com:443
In Ambito, immettere l'ambito configurato per l'applicazione nel dominio di Identity.

L'ambito specifica le autorizzazioni concesse dal token di accesso. Utilizzare l'ambito configurato al Passo 3. Configurare le impostazioni OAuth.
(Facoltativo) Per Audience, immettere l'audience configurata per l'applicazione nel dominio di Identity.

L'audience identifica il servizio o l'API a cui è destinato il token di accesso. Per trovare questo valore, aprire l'applicazione integrata nel dominio di Identity, selezionare OAuth configurazione e copiare Audience principale.
Selezionare Next.

Sessione browser del dominio di identità

Ottenere l'URL del dominio di Identity, l'ambito, l'audience e l'ID client per l'applicazione OAuth configurata per il flusso del codice di autorizzazione con PKCE. Memorizzare il segreto client OAuth nel vault OCI e registrare l'OCID del segreto per il campo ID vault segreto client.

Per Tipo di autenticazione, selezionare Sessione browser del dominio di identità.
In Tipo selezionare una delle opzioni riportate di seguito.
- Scegliere un dominio di Identity esistente: selezionare il compartimento del dominio di Identity e il dominio di Identity per l'applicazione OAuth.
- Incollare un URL del dominio di Identity: immettere l'URL del dominio di Identity. Ad esempio, https://idcs-xxx.identity.oraclecloud.com:443.
Immettere i seguenti valori richiesti dalla console per l'applicazione OAuth:
- Ambito: l'ambito configurato nel dominio di Identity.
- Audience: l'audience configurata nel dominio di Identity.
- ID client OAuth: l'ID client dell'applicazione OAuth utilizzato per l'accesso al browser.
- ID vault segreto client: l'OCID del segreto vault OCI contenente il segreto client dell'applicazione OAuth.
(Facoltativo) In Percentuali di accesso pubblico, selezionare Aggiungi pattern percorso pubblico e immettere un percorso a cui è possibile accedere senza autenticazione. Ripetere le operazioni per ciascun percorso aggiuntivo.

I percorsi devono iniziare con una barra. Ad esempio, /health e /assets/*. Le richieste ai percorsi corrispondenti ignorano l'autenticazione. Aggiungere solo i percorsi destinati all'accesso senza eseguire l'accesso.
Selezionare Next.

IAM OCI

Per Tipo di autenticazione, selezionare IAM OCI.

Questa opzione utilizza l'autenticazione della firma della richiesta IAM OCI e non richiede impostazioni del dominio di Identity.
Selezionare Next.

Nessuna autenticazione.

Con questa opzione, chiunque sia in grado di raggiungere l'endpoint può inviare richieste senza autenticazione gestita dalla piattaforma. Se l'accesso richiede limitazioni, l'applicazione deve applicare l'autenticazione e l'autorizzazione. Vedere Utilizzo di nessuna autenticazione.

Per Tipo di autenticazione, selezionare Nessuna autenticazione.
Non sono richiesti campi di autenticazione aggiuntivi.
Selezionare Next.

Abilita log applicazione

Abilita il log delle risorse per tenere traccia dell'attività dell'applicazione, risolvere i problemi e raccogliere insight operativi per le distribuzioni in hosting.

(Facoltativo) Attiva Abilita log.
Per Categoria, selezionare genai-hosted-deployment-log o creare un nuovo gruppo di log.
Per Gruppo di log, selezionare un gruppo di log già esistente oppure selezionare Crea nuovo gruppo di log.
Selezionare il compartimento che contiene il gruppo di log.
Immettere un nome di log.
(Facoltativo) In Opzioni avanzate, selezionare un periodo di conservazione dei log.
Il periodo retention predefinito è 1 mese (30 giorni).

Rivedi e crea

Rivedere le impostazioni dell'applicazione, quindi selezionare Crea applicazione.

Nota

Il tempo di creazione dell'applicazione dipende dalle risorse fornite dal servizio per l'applicazione.

Se lo storage gestito è abilitato, il servizio esegue il provisioning o collega lo storage selezionato, che potrebbe richiedere diversi minuti.
Se è selezionata l'opzione rete personalizzata, il servizio esegue il provisioning delle risorse di bridge di rete necessarie. Questa operazione potrebbe richiedere anche alcuni minuti.

Rivedere le impostazioni e selezionare Crea applicazione.

Se è stata selezionata l'opzione Nessuna autenticazione, verificare che nel campo Tipo di autenticazione sia visualizzato tale valore.

Dopo la creazione, visualizzare Tipo di autenticazione in Autenticazione nella scheda Configurazione dell'applicazione.

Suggerimento

Dopo aver creato un'applicazione, è possibile visualizzarne i dettagli ed eseguire altri task, ad esempio spostarla in un compartimento diverso, gestirne le tag o eliminarla. Per accedere a questi task, utilizzare il menu Azioni (tre punti) nella console. È inoltre possibile creare una distribuzione per l'applicazione dalla relativa pagina di dettaglio. Per ulteriori informazioni, vedere Elenco delle applicazioni.

Documentazione dell'infrastruttura Oracle Cloud