Objektové úložiště app

Dostupnost

Spravované objektové úložiště zatím není k dispozici. Současná služba bucket je náhled control plane. Vytvoří záznam ve tvaru bucketu, vygeneruje jednorázové přihlašovací údaje ve tvaru S3 a může publikovat proměnné prostředí OF_S3_*, ale jeho endpoint je stub-minio-platform.local:9000. Nevytvoří se bucket MinIO a žádný objekt tam uložit nelze.

Nepoužívejte záznam se stavem stub pro nahrávání, zálohy ani data, která musí přežít. Úspěšné volání dokazuje jen to, že kontrakt control plane proběhl.

Co dnes můžete testovat

Náhled vyzkouší tyto hranice:

generování unikátního názvu bucketu;
kontroly vlastnictví app v obalu MCP;
jednorázové zacházení s tajemstvím;
odpovědi seznamu pouze s metadaty;
publikaci OF_S3_ENDPOINT, OF_S3_BUCKET, OF_S3_ACCESS_KEY, OF_S3_SECRET_KEY a OF_S3_REGION; a
propojení reference bucketu s app.

Pokud publikace prostředí uspěje, hodnoty jsou stále placeholder. Odstraňte je před nasazením zátěže, která očekává skutečné úložiště.

Nástroje MCP

Nástroj	Současné chování
`add_app_bucket(app_id)`	Vytvoří záznam `stub` a může publikovat placeholder hodnoty `OF_S3_*`.
`list_app_buckets(app_id)`	Vypíše metadata. Tajný klíč nikdy nevrátí.


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

Před použitím zkontrolujte odpověď:


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

Když automatická publikace prostředí není k dispozici, odpověď může jednou obsahovat tajemství a env_payload. Stub endpoint se tím nezmění na úložiště. S odpovědí nakládejte jako s citlivými daty a nezapisujte ji do logu.

Kontrakt REST

Method	Path	Výsledek
`POST`	`/api/app-infra/buckets`	Vytvoří záznam náhledu a vrátí jednorázová data ve tvaru přihlašovacích údajů.
`GET`	`/api/app-infra/buckets/{bucket_id}`	Vrátí metadata bez tajného klíče.
`GET`	`/api/app-infra/buckets?app_id={app_id}`	Vypíše metadata bucketů pro app.

Pro běžné použití upřednostněte nástroje MCP s rozsahem vlastníka. Trasy platformy slouží jako vnitřní integrační povrch.

Plánovaný kontrakt aplikace

Když bude zapnut skutečný poskytovatel, aplikace explicitně sestaví klienta kompatibilního se S3 z pěti proměnných OF_S3_*. Nespoléhejte na ambientní přihlašovací údaje AWS. Stejné názvy proměnných lze dnes použít s dočasnou službou S3 spravovanou operátorem, pokud dodáte skutečné hodnoty přes Tajemství a proměnné prostředí.

Než lze spravované úložiště označit za připravené

Verze vhodná pro produkci potřebuje důkazy pro:

nasazený a dosažitelný host object store;
izolaci přístupu podle app;
testy nahrávání, stahování a persistence po redeploy;
rotaci a bezpečný deprovisioning;
kapacitu, dostupnost a monitoring chyb; a
chování zálohy nebo replikace odpovídající deklarovanému cíli odolnosti.

Dokud tyto kontroly neprojdou, použijte službu kompatibilní se S3 spravovanou operátorem a přímo otestujte její cestu obnovy.