Anwendung erstellen
Anwendungen definieren verwaltete Laufzeiteinstellungen für gehostete Deployments, einschließlich Skalierung, verwaltetem Speicher, Netzwerk und Authentifizierung. In dieser Aufgabe wird erläutert, wie Sie eine Anwendung mit der Oracle Cloud-Konsole im OCI Generative AI-Service erstellen.
Wählen Sie auf der Listenseite Anwendungen die Option Anwendung erstellen aus. Wenn Sie Hilfe beim Suchen der Listenseite benötigen, finden Sie weitere Informationen unter Anwendungen auflisten.
Grundlegende Informationen
Tags
- (Optional) Wählen Sie Tag hinzufügen aus, und weisen Sie dieser Anwendung Tags zu. Siehe Ressourcentags.
- Wählen Sie Erstellen aus.
Skalierung
Wenn Sie den persistenten Dateispeicher in Schritt 3 aktivieren möchten, setzen Sie Mindestreplikate und Maximale Replikate auf
1. Der persistente Dateispeicher unterstützt ein Replikat in diesem Release.Speicher
Aktivieren Sie im 3. Schritt den serviceverwalteten Speicher, der in der Anwendung bereitgestellt werden muss: File Storage, OCI PostgreSQL, OCI Cache oder Oracle Autonomous AI Database. Sie können eine Speicherressource jedes Typs zuordnen.
File Storage ist in einem Container-Mount-Pfad verfügbar. Datenbank- und Cacheverbindungsdetails werden über Umgebungsvariablen bereitgestellt. Der Service verwaltet den Zugriff auf den Speicher der Anwendung.
- Persistenter Dateispeicher
Behalten Sie Dateien über Containerneustarts und erneute Deployments hinweg bei. Jede Anwendung kann einen Dateispeicheranhang mit einem festen 50-GB-Kontingent (50.000.000.000 Byte) haben.
Für diese Option:
- Aktivieren Sie Persistenter Dateispeicher.
- Stellen Sie sicher, dass Mindestreplikate und Maximale Replikate in den Skalierungseinstellungen beide
1sind. Der persistente Dateispeicher unterstützt ein Replikat in diesem Release. - Wählen Sie unter Speicher eine der folgenden Optionen aus:
- Neuen Speicher erstellen: Geben Sie einen Speichernamen ein. Der Service erstellt eine Speicherkonfiguration im Compartment der Anwendung.
- Vorhandenen Speicher im aktuellen Compartment auswählen: Wählen Sie unter Speichername eine aktive Dateispeicherressource aus. Mit Suchen und filtern können Sie eine Ressource suchen. Wenn kein aktiver Dateispeicher verfügbar ist, wählen Sie Neuen Speicher erstellen aus.
- Behalten Sie unter Mountpfad
/mnt/persistent/databei, oder geben Sie einen anderen gültigen absoluten Containerpfad ein. Sie können diesen Pfad nicht ändern, nachdem die Anwendung erstellt wurde.
Anwendungen, die dieselbe Speicherressource verwenden, erhalten separate Dateisysteme. Wenn Sie den vorhandenen Speicher auswählen, wird seine Konfiguration wieder verwendet. Die Dateien einer anderen Anwendung werden nicht freigegeben.
Konfigurieren Sie Ihre Anwendung so, dass persistente Dateien im Mountpfad gelesen und geschrieben werden. File Storage verwendet keine Umgebungsvariable für Verbindungsinformationen. Pfadanforderungen, API-Konfiguration und Anhangsstatus finden Sie unter Persistenter Dateispeicher für gehostete Anwendungen.
- OCI PostgreSQL
Aktivieren Sie OCI PostgreSQL, um eine verwaltete Datenbank für Deployments in dieser Anwendung bereitzustellen.
Für diese Option:- Geben Sie den Namen der Umgebungsvariablen ein, die den OCI-PostgreSQL-Verbindungs-URI empfängt. Der Service fügt die Verbindungszeichenfolge zur angegebenen Umgebungsvariablen hinzu.
- Speicher: Wählen Sie aus, ob Speicher erstellt oder vorhandener Speicher verwendet werden soll. Wenn Sie einen vorhandenen Speicher auswählen, verwendet die Anwendung die OCI PostgreSQL-Speicherressource gemeinsam mit anderen Anwendungen im Mandanten. Jeder Anwendung wird eine dedizierte Datenbank zugewiesen, und diese Anwendung hat die Berechtigung, nur auf ihre dedizierte Datenbank zuzugreifen.
- OCI-CacheAktivieren Sie OCI Cache, um einen verwalteten Cache für Deployments in dieser Anwendung bereitzustellen. Für diese Option:
- Geben Sie den Namen der Umgebungsvariablen ein, die den OCI Cache-Verbindungs-URI empfängt.
- Speicher: Wählen Sie aus, ob Speicher erstellt oder vorhandener Speicher verwendet werden soll.
- Oracle Autonomous DatabaseErmöglichen Sie Oracle Autonomous AI Database, eine verwaltete Datenbank für Deployments in dieser Anwendung bereitzustellen. Für diese Option:
- Geben Sie den Umgebungsvariablennamen ein, der die Autonomous AI Database-Verbindungs-URI empfängt.
Zusätzlich zur Verbindungszeichenfolge mountet der Service die Zugangsdaten des Datenbankbenutzers in den folgenden lokalen Dateien im Container:/mnt/secrets/adb/username /mnt/secrets/adb/password
Umgebung
Networking (optional)
Wählen Sie aus, wie Deployments in dieser Anwendung ausgehenden Traffic weiterleiten und wie Clients auf den Deployment-Endpunkt zugreifen.
Authentifizierung
Wählen Sie in Schritt 6 eine der folgenden Authentifizierungsoptionen aus:
- Identitätsdomain-Bearer-Token: Verwendet ein OAuth-Zugriffstoken, das von einer OCI-IAM-Identitätsdomain ausgegeben wird. Das Token wird als Bearer-Token an den Zielservice gesendet, und der Service validiert das Token, bevor die Anforderung akzeptiert wird. Führen Sie als Voraussetzung die Aufgaben unter Identitätsdomain-Bearer-Tokenauthentifizierung einrichten aus.
- Identitätsdomainbrowsersession: Verwendet den Autorisierungscodefluss OAuth 2.1 mit Proofschlüssel für Codeaustausch (PKCE). Browserbenutzer werden zur Anmeldung zu einer OCI-Identitätsdomain umgeleitet. Der gehostete Application Service ruft in seinem Namen ein Zugriffstoken ab und erstellt eine Browsersitzung, die ein Session-Cookie verwendet.
- OCI IAM: Verwendet die OCI IAM-Anforderungssignaturauthentifizierung. Jede Anforderung wird entsprechend den Anforderungen der OCI-API-Anforderungssignatur kryptografisch signiert.
- Keine Authentifizierung: Ermöglicht Anforderungen ohne plattformverwaltete Authentifizierung. Verwenden Sie diese Option für öffentlichen Inhalt oder wenn Ihre Anwendung die Authentifizierung verwaltet.
Wenn Sie die API verwenden, verwenden Sie CreateHostedApplication für die Identitätsdomainauthentifizierung oder keine Authentifizierung. Setzen Sie in inboundAuthConfig inboundAuthConfigType auf einen der folgenden Werte:
IDCS_AUTH_CONFIG: Authentifizierung für Identitätsdomain-Bearer-Token.IDCS_SESSION_AUTH_CONFIG: Sessionauthentifizierung des Identitätsdomainbrowsers mit dem Autorisierungscodefluss OAuth 2.1 mit PKCE.NO_AUTH_CONFIG: Deaktiviert die plattformverwaltete Aufruferauthentifizierung. Lassen SieidcsConfigaus.
Nehmen Sie für einen Identitätsdomainauthentifizierungstyp idcsConfig mit den erforderlichen Werten für domainUrl und scope auf. Das API-Schema kennzeichnet audience als optional. Außerdem werden clientId und clientSecretVaultId als optionale Felder definiert, die nur für IDCS_SESSION_AUTH_CONFIG gelten. Der Wert clientSecretVaultId ist die OCID eines OCI Vault-Secrets mit dem Client Secret OAuth. Weitere Informationen finden Sie unter InboundAuthConfig und IdcsAuthConfig.
Um keine Authentifizierung zu konfigurieren, geben Sie das folgende Objekt an. Es ist keine separate Mandantenanmeldung erforderlich.
"inboundAuthConfig": {
"inboundAuthConfigType": "NO_AUTH_CONFIG"
}Wenn inboundAuthConfig aus einem Update ausgelassen wird, bleibt die aktuelle Authentifizierungskonfiguration der Anwendung unverändert. Um die plattformverwaltete Aufruferauthentifizierung explizit zu deaktivieren, setzen Sie inboundAuthConfigType auf NO_AUTH_CONFIG, und lassen Sie idcsConfig weg.
Um eine Anwendung zu erstellen, die OCI-IAM-Authentifizierung verwendet, verwenden Sie CreateHostedApplicationIam mit CreateHostedApplicationIamDetails. Für die OCI-IAM-API ist keine OAuth- oder IDCS-Konfiguration erforderlich.
Führen Sie die Schritte für den ausgewählten Authentifizierungstyp aus.
Identitätsdomain-Bearer-Token
Browsersession der Identitätsdomain
Rufen Sie die Identitätsdomain-URL, den Geltungsbereich, die Zielgruppe und die Client-ID für die Anwendung OAuth ab, die für den Autorisierungscodeablauf mit PKCE konfiguriert ist. Speichern Sie das Client Secret OAuth in OCI Vault, und notieren Sie die OCID des Secrets für das Feld Client Secret Vault-ID.
OCI-IAM
Keine Berechtigungsprüfung
Mit dieser Option kann jeder, der den Endpunkt erreichen kann, Anforderungen ohne plattformverwaltete Authentifizierung senden. Wenn der Zugriff eingeschränkt werden muss, muss Ihre Anwendung Authentifizierung und Autorisierung durchsetzen. Siehe Keine Authentifizierung verwenden.
Anwendungslogs aktivieren
Aktivieren Sie das Ressourcenlogging, um Anwendungsaktivitäten zu verfolgen, Probleme zu beheben und Betriebseinblicke für gehostete Deployments zu erfassen.
Prüfen und erstellen
Prüfen Sie die Anwendungseinstellungen, und wählen Sie Anwendung erstellen aus.
Die Erstellungszeit der Anwendung hängt von den Ressourcen ab, die der Service für die Anwendung bereitstellt.
-
Wenn Managed Storage aktiviert ist, stellt der Service den ausgewählten Speicher bereit oder hängt ihn an. Dieser Vorgang kann einige Minuten dauern.
-
Wenn benutzerdefiniertes Networking ausgewählt ist, stellt der Service die erforderlichen Netzwerk-Bridging-Ressourcen bereit. Dies kann auch einige Minuten dauern.
Zeigen Sie nach der Erstellung den Authentifizierungstyp unter Authentifizierung auf der Registerkarte Konfiguration der Anwendung an.
Nachdem Sie eine Anwendung erstellt haben, können Sie ihre Details anzeigen und andere Aufgaben ausführen, wie z.B. das Verschieben in ein anderes Compartment, das Verwalten ihrer Tags oder das Löschen. Verwenden Sie das Menü in der Konsole, um auf diese Aufgaben zuzugreifen. Sie können auch ein Deployment für die Anwendung auf ihrer Detailseite erstellen. Weitere Informationen finden Sie unter Anwendungen auflisten.