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

  1. Geben Sie einen Namen für die Anwendung ein.
    Beginnen Sie den Namen mit einem Buchstaben oder Unterstrich, gefolgt von Buchstaben, Zahlen, Bindestrichen und Unterstrichen. Die Länge kann 1 bis 255 Zeichen betragen.
  2. (Optional) Geben Sie eine Bezeichnung für die Anwendung an.
  3. Wählen Sie ein Compartment für die Erstellung der Anwendung aus. Das Standard-Compartment ist mit der Listenseite identisch. Sie können jedoch jedes Compartment auswählen, für das Sie die Berechtigung zur Arbeit haben.

Tags

  1. (Optional) Wählen Sie Tag hinzufügen aus, und weisen Sie dieser Anwendung Tags zu. Siehe Ressourcentags.
  2. Wählen Sie Erstellen aus.

Skalierung

Wichtig

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.
  1. Definieren Sie für Autoscaling, wie gehostete Deployments skaliert werden, um die Last zu bewältigen.
    • Minimale Replikate

      Die Mindestanzahl von Replikaten, die immer ausgeführt werden müssen. Dieser Wert muss kleiner/gleich dem maximalen Replikatwert sein. Der Standardwert ist 1.

    • Maximale Anzahl Replikate

      Die maximale Anzahl von Replikaten, die ausgeführt werden können. Neue Replikate werden hinzugefügt, wenn die Last steigt, bis zu diesem Grenzwert. Der Standardwert ist 3 und der Höchstwert 30. Um Autoscaling zu deaktivieren, setzen Sie diesen Wert auf Mindestreplikate.

  2. Wählen Sie eine Skalierungsmetrik.
    Der Service fügt Replikate hinzu, wenn die ausgewählte Metrik das konfigurierte Ziel überschreitet, und zwar bis zum maximalen Replikatwert.
    • CPU-Auslastung (%)

      Fügt Replikate hinzu, wenn die CPU-Auslastung diesen Prozentsatz überschreitet, und zwar bis zu den maximal festgelegten Replikaten. Bereich: 50–95%.

    • Speicherauslastung (%)

      Fügt Replikate hinzu, wenn die Speicherauslastung diesen Prozentsatz überschreitet, und zwar bis zu den maximal festgelegten Replikaten. Bereich: 50–95%.

    • Hintergrundprozesse

      Fügt Replikate hinzu, wenn Hintergrundprozesse diesen Wert überschreiten, bis hin zu den maximal festgelegten Replikaten. Bereich: 1–500.

    • Anforderungen pro Sekunde (RPS)

      Fügt Replikate hinzu, wenn Anforderungen pro Sekunde das konfigurierte Ziel überschreiten, bis zu den maximal festgelegten Replikaten.

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.

Aktivieren Sie unter Speicher die Optionen, die Ihre Anwendung benötigt.
  • 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:

    1. Aktivieren Sie Persistenter Dateispeicher.
    2. Stellen Sie sicher, dass Mindestreplikate und Maximale Replikate in den Skalierungseinstellungen beide 1 sind. Der persistente Dateispeicher unterstützt ein Replikat in diesem Release.
    3. 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.
    4. Behalten Sie unter Mountpfad /mnt/persistent/data bei, 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-Cache
    Aktivieren 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 Database
    Ermö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

  1. (Optional) Geben Sie mindestens eine Umgebungsvariable für das Deployment als Schlüssel/Wert-Paare ein. Geben Sie für jede Variable den Namen der Umgebungsvariablen und den zugehörigen Wert ein. Fügen Sie beliebig viele Variablen hinzu.
  2. (Optional) Geben Sie unter Vaultumgebungsvariablen Folgendes ein:
    • Variablenname
    • Vault-OCID
    • Vault-Schlüssel
    • Der Service fügt die Vault-Informationen als JSON-Datei zum Container hinzu. Beispiel-JSON-Code:

      {
          "vaultId":<vault-ocid>,
          "key":<the secret in the vault>
      }

Networking (optional)

Wählen Sie aus, wie Deployments in dieser Anwendung ausgehenden Traffic weiterleiten und wie Clients auf den Deployment-Endpunkt zugreifen.

  1. Wählen Sie unter Networking eine der folgenden Optionen aus.
    • Standard (serviceverwaltet)

      Ermöglicht ausgehenden Zugriff auf OCI-Services und das öffentliche Internet über ein serviceverwaltetes Netzwerk.

    • Benutzerdefiniert (vom Kunden verwaltet)
      Leitet ausgehenden Traffic über ein VCN und Subnetz im Mandanten mit einer privaten Endpunktverbindung weiter. Diese Option wird für private, unternehmensintegrierte Deployments empfohlen. Wählen Sie für diese Option Folgendes aus:
      • VCN-Compartment
      • VCN
      • Subnetz-Compartment
      • Subnetz
      Hinweis

      Wenn Sie ein benutzerdefiniertes Networking auswählen, wird der gesamte Egress-Traffic an das VCN-Subnetz weitergeleitet. Wenn die Anwendung auch Internetzugriff benötigt, sollten Sie ein öffentliches Subnetz verwenden und die Routentabelle konfigurieren. Siehe Internetgateway.
  2. Wählen Sie aus, ob über einen öffentlichen oder privaten Endpunkt auf das aktive Deployment für diese Anwendung zugegriffen wird.
    • Öffentlich

      Zugriff von außerhalb des VCN.

    • Privat

      Nur über das VCN zugänglich.

      Wichtig

      Sie müssen einen privaten Endpunkt für generative KI verwenden. Wenn Sie keinen haben, erstellen Sie einen privaten Endpunkt für generative KI.

      Wählen Sie die folgenden Informationen aus:

      • Compartment des privaten Endpunkts
      • Privater Endpunkt

    Nachdem die Anwendung erstellt wurde, können Sie über diesen privaten Endpunkt mit dem FQDN oder der IP-Adresse darauf zugreifen. Beispiel-FQDN:

    https://<pe-name>.pe.inference.generativeai.<region>
    .oci.oraclecloud.com/20251112/hostedApplications/{your_application_ocid}

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.
Hinweis

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 Sie idcsConfig aus.

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

  1. Wählen Sie unter Authentifizierungstyp die Option Identitätsdomain-Träger-Token aus.
  2. Folgende Optionen stehen zur Auswahl:
    • Vorhandene Identitätsdomain auswählen

      Verwenden Sie dieselbe Identitätsdomain, in der Sie die vertrauliche integrierte Anwendung in Schritt 2 erstellt haben. Anwendung in der Identitätsdomain erstellen. Wählen Sie Werte für folgende Felder aus:

      • Identitätsdomain-Compartment
      • Identitätsdomain
    • Identitätsdomain-URL einfügen

      Beispiel: https://idcs-xxx.identity.oraclecloud.com:443

  3. Geben Sie unter Geltungsbereich den Geltungsbereich ein, der für die Anwendung in der Identitätsdomain konfiguriert ist.

    Der Geltungsbereich gibt die Berechtigungen an, die das Zugriffstoken erteilt. Verwenden Sie den in Step 3 konfigurierten Geltungsbereich. Konfigurieren Sie OAuth-Einstellungen.

  4. (Optional) Geben Sie unter Zielgruppe die für die Anwendung konfigurierte Zielgruppe in der Identitätsdomain ein.

    Die Zielgruppe identifiziert den Service oder die API, für den bzw. die das Zugriffstoken bestimmt ist. Um diesen Wert zu finden, öffnen Sie die integrierte Anwendung in der Identitätsdomain, wählen Sie OAuth-Konfiguration aus, und kopieren Sie Primäre Zielgruppe.

  5. Wählen Sie Weiter.

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.

  1. Wählen Sie unter Authentifizierungstyp die Option Browsersession der Identitätsdomain aus.
  2. Wählen Sie unter Typ eine der folgenden Optionen:
    • Vorhandene Identitätsdomain auswählen: Wählen Sie das Identitätsdomain-Compartment und die Identitätsdomain für die Anwendung OAuth aus.
    • Identitätsdomain-URL einfügen: Geben Sie die Identitätsdomain-URL ein. Beispiel: https://idcs-xxx.identity.oraclecloud.com:443.
  3. Geben Sie die folgenden Werte ein, die von der Konsole für die Anwendung OAuth erforderlich sind:
    • Geltungsbereich: Der Geltungsbereich, der in der Identitätsdomain konfiguriert ist.
    • Zielgruppe: Die in der Identitätsdomain konfigurierte Zielgruppe.
    • OAuth-Client-ID: Die Client-ID der Anwendung OAuth, die für die Browseranmeldung verwendet wird.
    • Client Secret Vault-ID: Die OCID des OCI Vault Secrets mit dem Client Secret der OAuth-Anwendung.
  4. (Optional) Wählen Sie unter Pfadmuster für öffentlichen Zugriff die Option Pfadmuster für öffentlichen Zugriff hinzufügen aus, und geben Sie einen Pfad ein, auf den ohne Authentifizierung zugegriffen werden kann. Wiederholen Sie den Vorgang für jeden weiteren Pfad.

    Pfade müssen mit einem Schrägstrich beginnen. Beispiele sind /health und /assets/*. Anforderungen an übereinstimmende Pfade umgehen die Authentifizierung. Fügen Sie nur Pfade hinzu, die für den Zugriff ohne Anmeldung bestimmt sind.

  5. Wählen Sie Weiter.

OCI-IAM

  1. Wählen Sie unter Authentifizierungstyp OCI IAM aus.

    Diese Option verwendet die OCI IAM-Anforderungssignaturauthentifizierung und erfordert keine Identitätsdomaineinstellungen.

  2. Wählen Sie Weiter.

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.

  1. Wählen Sie unter Authentifizierungstyp die Option Keine Authentifizierung aus.
    Es sind keine zusätzlichen Authentifizierungsfelder erforderlich.
  2. Wählen Sie Weiter.

Anwendungslogs aktivieren

Aktivieren Sie das Ressourcenlogging, um Anwendungsaktivitäten zu verfolgen, Probleme zu beheben und Betriebseinblicke für gehostete Deployments zu erfassen.

  1. (Optional) Aktivieren Sie Log aktivieren.
  2. Wählen Sie unter Kategorie die Option genai-hosted-deployment-log aus, oder erstellen Sie eine neue Loggruppe.
  3. Wählen Sie unter Loggruppe eine vorhandene Loggruppe aus, oder wählen Sie Neue Loggruppe erstellen aus.
  4. Wählen Sie das Compartment aus, das die Loggruppe enthält.
  5. Geben Sie einen Lognamen ein.
  6. (Optional) Wählen Sie unter Erweiterte Optionen einen Logaufbewahrungszeitraum aus.
    Der Standardaufbewahrungszeitraum beträgt 1 Monat (30 Tage).

Prüfen und erstellen

Prüfen Sie die Anwendungseinstellungen, und wählen Sie Anwendung erstellen aus.

Hinweis

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.

Prüfen Sie die Einstellungen, und wählen Sie Anwendung erstellen aus.
Wenn Sie Keine Authentifizierung ausgewählt haben, prüfen Sie, ob unter Authentifizierungstyp dieser Wert angezeigt wird.

Zeigen Sie nach der Erstellung den Authentifizierungstyp unter Authentifizierung auf der Registerkarte Konfiguration der Anwendung an.

Tipp

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ü Aktionen (drei Punkte) 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.