Persistenter Dateispeicher für gehostete Anwendungen

Behalten Sie Anwendungsdateien über Containerneustarts und erneute Deployments hinweg mit serviceverwaltetem File Storage in OCI Generative AI bei.

Hängen Sie File Storage an eine gehostete Anwendung an, und geben Sie einen absoluten Containerpfad an, in dem der Service ihn mountet. In diesen Pfad geschriebene Dateien bleiben bei Neustarts und erneuten Deployments verfügbar. Verwenden Sie persistente Dateien für Modellartefakte, Zwischenergebnisse, Checkpoints und Anwendungsstatus, die Ihre Workload für diese Ereignisse benötigt.

Jede Anwendung erhält ein separates Dateisystem, auch wenn Anwendungen dieselbe verwaltete Speicherressource verwenden. Bei der Wiederverwendung einer Speicherkonfiguration werden keine Dateien zwischen Anwendungen gemeinsam verwendet. Anwendungen greifen über den konfigurierten Mount-Pfad auf ihre eigenen Dateien zu.

Wichtig

Der persistente Dateispeicher unterstützt ein Replikat in diesem Release. Setzen Sie die Mindest- und Höchstanzahl von Replikaten der Anwendung auf 1.
  • Eine Anwendung kann einen File Storage-Mount und eine angehängte Speicherressource jedes Speichertyps aufweisen.
  • Jeder Dateispeicheranhang hat ein festes 50-GB-Quota (50.000.000.000 Byte).
  • Sie müssen den Mountpfad angeben, wenn Sie die Anwendung erstellen. Sie können ihn danach nicht mehr ändern.
  • Dateien, die außerhalb des Mountpfads geschrieben wurden, erhalten von diesem Anhang keine Persistenz. Verwenden Sie /tmp für temporäre Dateien.

Sie können File Storage über die Konsole oder die API für generative KI konfigurieren. Informationen zum Konsolenworkflow finden Sie unter Speicher.

Mountpfad auswählen

Der empfohlene Mountpfad ist /mnt/persistent/data. Sie können einen anderen gültigen Pfad angeben, wie /data, /app/storage oder /mount. Konfigurieren Sie die Anwendung so, dass persistente Dateien im ausgewählten Pfad gelesen und geschrieben werden.

Der Pfad muss die folgenden Anforderungen erfüllen:

  • Verwenden Sie einen absoluten Pfad im kanonischen UTF-8-Format, mit maximal 4.096 Byte insgesamt und 255 Byte pro Pfadkomponente.
  • Nehmen Sie keine leeren Komponenten, .- oder ..-Komponenten, Steuerzeichen oder einen abschließenden Schrägstrich auf.
  • Verwenden Sie nicht den Root-Pfad (/) oder einen Pfad, der sich mit einem anderen Container-Volume-Mount überschneidet.
  • Verwenden Sie keinen Pfad, der sich mit einem reservierten Systemverzeichnis oder Plattform-Mount überschneidet.

Die folgenden Pfade sind reserviert:

  • /bin, /boot, /dev, /etc, /lib, /lib64, /proc, /sbin und /sys
  • /run, /tmp und /var/run
  • /usr/bin, /usr/sbin, /usr/lib und /usr/lib64
  • /usr/local/bin, /usr/local/sbin, /usr/local/lib und /usr/local/lib64

Für File Storage ist ein expliziter Mountpfad erforderlich. Generierte Mountpfade und die environmentVariableKey-Konfiguration werden für diesen Speichertyp nicht unterstützt.

File Storage mit der API erstellen

Stellen Sie sicher, dass Sie die Berechtigung zum Erstellen von verwaltetem Speicher und gehosteten Anwendungen haben. Siehe Berechtigungen auf API-Ebene für Application Storage und Berechtigungen für das Deployment von Anwendungen.

Konfigurieren Sie die Anwendung mit einer Mindest- und Höchstanzahl an Replikaten von 1. Der persistente Dateispeicher unterstützt ein Replikat in diesem Release.

Mit der Control-Plane-API für generative KI können Sie eine verwaltete Speicherressource erstellen und dann in der Speicherkonfiguration der Anwendung referenzieren.

  1. Erstellen Sie die Speicherressource mit CreateHostedApplicationStorage.

    Senden Sie eine POST-Anforderung mit einem CreateHostedApplicationStorageDetails-Anforderungsbody an /20231130/hostedApplicationStorages. Geben Sie die Compartment-OCID, einen Anzeigenamen und FILE_STORAGE als Speichertyp an.

    {
      "compartmentId": "<compartment-ocid>",
      "displayName": "application-files",
      "storageType": "FILE_STORAGE"
    }

    Sie können auch eine optionale Beschreibung, definierte Tags und Freiformtags angeben.

  2. Verzeichnen Sie die OCID der erstellten Ressource HostedApplicationStorage. Wenn Sie vorhandenen File Storage verwenden, verwenden Sie die OCID der verwalteten Speicherressource.
  3. Fügen Sie einen File Storage-Eintrag in storageConfigs ein, wenn Sie die gehostete Anwendung erstellen.

    Setzen Sie im Eintrag StorageConfig storageId auf die OCID der verwalteten Speicherressource und mountPath auf den ausgewählten Containerpfad. Lassen Sie environmentVariableKey aus.

    Das folgende Fragment zeigt nur die Anhangskonfiguration. Nehmen Sie die anderen erforderlichen Eigenschaften für den von Ihnen verwendeten Anwendungserstellungsvorgang auf.

    {
      "storageConfigs": [
        {
          "storageId": "<hosted-application-storage-ocid>",
          "mountPath": "/mnt/persistent/data"
        }
      ]
    }

    Die Anwendung unterstützt bis zu vier Speicherkonfigurationen mit einem Anhang pro Speichertyp. Geben Sie für ADB, PostgreSQL und Cachespeicher environmentVariableKey an, und lassen Sie mountPath weg.

  4. Prüfen Sie, ob die Anwendung storageConfigs[].fileStorageDetails.mountState zurückgegeben hat, bevor Sie den Mount verwenden.

    READY bedeutet, dass die aktive Anwendungsrevision den konfigurierten Mountpfad verwenden kann. Siehe Anhangsstatus prüfen.

Anhangsstatus wird geprüft

Der Eintrag storageConfigs der Anwendung enthält fileStorageDetails mit dem Anhangsstatus. Siehe FileStorageDetails in der API-Referenz. Diese Felder melden den vom Service verwalteten Status.

Dateispeicheranhangsstatus
FeldBeschreibung
mountStateREADY bedeutet, dass der Service den Anhang abgestimmt hat und die aktive Anwendungsrevision den konfigurierten Mountpfad verwenden kann. Weitere Werte sind CREATING, NEEDS_ATTENTION, DELETING, DELETED und FAILED. In diesen Status greift der Anhang nicht auf den lokalen Speicher oder einen direkten NFS-Mount zurück.
lifecycleDetailsWenn angegeben, werden ein Fehler beim Anhängen oder Mounten und die Aktion beschrieben, die Sie ausführen können.
quotaLimitInGigabytesDie feste Anhang-Quota von 50 GB.

Speicherauslastung prüfen

Verwenden Sie die Nutzungsfelder in fileStorageDetails, um den zuletzt beobachteten Verbrauch zu prüfen. Verwendungswerte sind Advisory. File Storage erzwingt die feste Quota.

Verwendung des Dateispeicherplatzes
FeldBeschreibung
usageStateCURRENT gibt ein aktuelles Beispiel an. STALE gibt ein Beispiel an, das älter ist als das Frischeziel des Service. UNAVAILABLE gibt an, dass kein Nutzungsbeispiel verfügbar ist.
usageInBytesDie zuletzt beobachtete Nutzung in Byte.
usagePercentageDer zuletzt beobachtete Prozentsatz des 50-GB-Kontingents.
timeUsageObservedDie Zeit der Nutzungsbeobachtung im RFC 3339-Format.

Die Verwendungswerte und die Beobachtungszeit werden nur zurückgegeben, wenn usageState CURRENT oder STALE ist. Wenn es UNAVAILABLE ist, werden diese Felder ausgelassen. Fehlende Werte bedeuten nicht, dass kein Speicher verwendet wird.