Sovellusten objektitallennus

Saatavuus

Hallittu objektitallennus ei ole vielä käytettävissä. Nykyinen bucket-palvelu on control-planen esikatselu. Se luo bucketin muotoisen tietueen, generoi kertakäyttöiset S3-muotoiset tunnistetiedot ja voi julkaista OF_S3_* ympäristömuuttujat, mutta päätepiste on stub-minio-platform.local:9000. MinIO-buckettia ei luoda eikä sinne voi tallentaa objektia.

Älä käytä stub-tilaisen tietueen uploadiin, varmuuskopioihin tai dataan, jonka on säilyttävä. Onnistunut kutsu todistaa vain, että control-planen sopimus ajettiin.

Mitä voit testata tänään

Esikatselu harjoittelee näitä rajoja:

yksilöllisen bucket-nimen generointi;
sovelluksen omistajuustarkistukset MCP-kääreessä;
kertakäyttöisten salaisuuksien käsittely;
metadataa sisältävät listausvastaukset;
OF_S3_ENDPOINT, OF_S3_BUCKET, OF_S3_ACCESS_KEY, OF_S3_SECRET_KEY ja OF_S3_REGION julkaisu; ja
bucket-viitteen liittäminen sovellukseen.

Jos ympäristömuuttujien julkaisu onnistuu, arvot ovat silti paikkamerkkejä. Poista ne ennen kuin otat käyttöön työkuorman, joka odottaa oikeaa tallennusta.

MCP-työkalut

Tool	Nykyinen käyttäytyminen
`add_app_bucket(app_id)`	Luo `stub`-tietueen ja voi julkaista paikkamerkki-`OF_S3_*`-arvot.
`list_app_buckets(app_id)`	Listaa metadatan. Ei koskaan palauta secret key -arvoa.


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

Tarkista vastaus ennen käyttöä:


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

Kun automaattinen ympäristömuuttujien julkaisu ei ole käytettävissä, vastaus voi sisältää salaisuuden ja env_payload-kentän kerran. Se ei muuta stub-päätepistettä tallennukseksi. Käsittele vastaus arkaluontoisena äläkä lokita sitä.

REST-sopimus

Method	Path	Tulos
`POST`	`/api/app-infra/buckets`	Luo esikatselutietueen ja palauttaa kertakäyttöiset credential-muotoiset tiedot.
`GET`	`/api/app-infra/buckets/{bucket_id}`	Palauttaa metadatan ilman secret key -arvoa.
`GET`	`/api/app-infra/buckets?app_id={app_id}`	Listaa sovelluksen bucket-metadatan.

Käytä normaalissa työssä owner-scoped MCP-työkaluja. Alustan reitit ovat sisäinen integraatiopinta.

Suunniteltu sovellussopimus

Kun oikea tarjoaja on käytössä, sovellukset rakentavat eksplisiittisesti S3-yhteensopivan asiakkaan viidestä OF_S3_*-muuttujasta. Älä luota ympäristön AWS-tunnistetietoihin. Samoja muuttujanimiä voi käyttää tänään väliaikaisen operaattorin hallitseman S3-palvelun kanssa, jos toimitat oikeat arvot App environment variables -sivun kautta.

Ennen kuin hallittu tallennus voidaan pitää valmiina

Tuotantovalmius vaatii näyttöä seuraavista:

otettu käyttöön ja tavoitettavissa oleva object store -isäntä;
sovelluskohtainen pääsyn eristys;
upload-, download- ja redeploy-pysyvyystestit;
rotaatio ja turvallinen deprovisioning;
kapasiteetti, saatavuus ja virheiden seuranta; ja
varmuuskopiointi tai replikointi ilmoitettuun kestävyystavoitteeseen sopivasti.

Kunnes nämä tarkistukset menevät läpi, käytä operaattorin hallitsemaa S3-yhteensopivaa palvelua ja testaa sen palautuspolku suoraan.