Objektové úložisko app

Dostupnosť

Spravované objektové úložisko zatiaľ nie je k dispozícii. Súčasná služba bucket je náhľad control plane. Vytvorí záznam v tvare bucketu, vygeneruje jednorazové prihlasovacie údaje v tvare S3 a môže publikovať premenné prostredia OF_S3_*, ale jeho endpoint je stub-minio-platform.local:9000. Nevytvorí sa bucket MinIO a žiadny objekt tam uložiť nemožno.

Nepoužívajte záznam so stavom stub na nahrávanie, zálohy ani dáta, ktoré musia prežiť. Úspešné volanie dokazuje len to, že kontrakt control plane prebehol.

Čo dnes môžete testovať

Náhľad vyskúša tieto hranice:

generovanie jedinečného názvu bucketu;
kontroly vlastníctva app v obale MCP;
jednorazové zaobchádzanie s tajomstvom;
odpovede zoznamu len s metadátami;
publikáciu OF_S3_ENDPOINT, OF_S3_BUCKET, OF_S3_ACCESS_KEY, OF_S3_SECRET_KEY a OF_S3_REGION; a
prepojenie referencie bucketu s app.

Ak publikácia prostredia uspeje, hodnoty sú stále placeholder. Odstráňte ich pred nasadením záťaže, ktorá očakáva skutočné úložisko.

Nástroje MCP

Nástroj	Súčasné správanie
`add_app_bucket(app_id)`	Vytvorí záznam `stub` a môže publikovať placeholder hodnoty `OF_S3_*`.
`list_app_buckets(app_id)`	Vypíše metadáta. Tajný kľúč nikdy nevráti.


add_app_bucket(app_id='550e8400-e29b-41d4-a716-446655440000')

Pred použitím skontrolujte odpoveď:


{
  "bucket_id": "buk-a7f3b2c1d9e4f",
  "endpoint_url": "http://stub-minio-platform.local:9000",
  "status": "stub",
  "env_published": false
}

Keď automatická publikácia prostredia nie je k dispozícii, odpoveď môže raz obsahovať tajomstvo a env_payload. Stub endpoint sa tým nezmení na úložisko. S odpoveďou narábajte ako s citlivými údajmi a nezapisujte ju do logu.

Kontrakt REST

Method	Path	Výsledok
`POST`	`/api/app-infra/buckets`	Vytvorí záznam náhľadu a vráti jednorazové dáta v tvare prihlasovacích údajov.
`GET`	`/api/app-infra/buckets/{bucket_id}`	Vráti metadáta bez tajného kľúča.
`GET`	`/api/app-infra/buckets?app_id={app_id}`	Vypíše metadáta bucketov pre app.

Pre bežné použitie uprednostnite nástroje MCP s rozsahom vlastníka. Trasy platformy slúžia ako vnútorný integračný povrch.

Plánovaný kontrakt aplikácie

Keď bude zapnutý skutočný poskytovateľ, aplikácie explicitne zostavia klienta kompatibilného so S3 z piatich premenných OF_S3_*. Nespoliehajte sa na ambientné prihlasovacie údaje AWS. Tie isté názvy premenných možno dnes použiť s dočasnou službou S3 spravovanou operátorom, ak dodáte skutočné hodnoty cez Tajomstvá a premenné prostredia.

Kým sa dá spravované úložisko označiť za pripravené

Verzia vhodná pre produkciu potrebuje dôkazy pre:

nasadený a dosiahnuteľný host object store;
izoláciu prístupu podľa app;
testy nahrávania, sťahovania a persistence po redeploy;
rotáciu a bezpečný deprovisioning;
kapacitu, dostupnosť a monitoring chýb; a
správanie zálohy alebo replikácie zodpovedajúce deklarovanému cieľu odolnosti.

Kým tieto kontroly neprejdú, použite službu kompatibilnú so S3 spravovanú operátorom a priamo otestujte jej cestu obnovy.