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.
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
/tmpfü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,/sbinund/sys/run,/tmpund/var/run/usr/bin,/usr/sbin,/usr/libund/usr/lib64/usr/local/bin,/usr/local/sbin,/usr/local/libund/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.
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.
| Feld | Beschreibung |
|---|---|
mountState | READY 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. |
lifecycleDetails | Wenn angegeben, werden ein Fehler beim Anhängen oder Mounten und die Aktion beschrieben, die Sie ausführen können. |
quotaLimitInGigabytes | Die 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.
| Feld | Beschreibung |
|---|---|
usageState | CURRENT 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. |
usageInBytes | Die zuletzt beobachtete Nutzung in Byte. |
usagePercentage | Der zuletzt beobachtete Prozentsatz des 50-GB-Kontingents. |
timeUsageObserved | Die 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.