MinIO Client (mc) i HostArena S3: podešavanje i komande

MinIO Client (komanda mc) je alat komandne linije za rad sa S3 kompatibilnim skladištima. Sa HostArena S3 storage ga koristite za otpremanje, preuzimanje, preslikavanje foldera i pravljenje privremenih linkova. Na nekim Linux distribucijama (npr. Arch Linux) program se zove mcli, da se ne bi mešao sa programom Midnight Commander.

Šta vam je potrebno

Instalirajte MinIO Client prema uputstvu na zvaničnom MinIO sajtu i proverite instalaciju:

mc --version

Podešavanje veze (alias)

1. Postavite ključeve kao promenljive okruženja, da ih ne kucate direktno u komandu:

   export AWS_ACCESS_KEY_ID="VAS_ACCESS_KEY"
   export AWS_SECRET_ACCESS_KEY="VAS_SECRET_KEY"

2. Napravite alias hostarena:

   mc alias set hostarena https://s3.hostarena.rs "$AWS_ACCESS_KEY_ID" "$AWS_SECRET_ACCESS_KEY" --api S3v4 --path on

   Opcija --path on uključuje path-style adrese, što je najpouzdaniji način rada. Ako izostavite ključeve, mc će ih sam zatražiti.

3. Proverite da je alias sačuvan:

   mc alias list hostarena

Region garage ne morate posebno da unosite, jer mc region preuzima sa servera. Ako ipak dobijete grešku o regionu, pogledajte deo „Najčešći problemi”.

Osnovne komande

Spisak bucketa, sadržaj bucketa i zauzeće:

mc ls hostarena
mc ls hostarena/vas-bucket
mc du hostarena/vas-bucket

Otpremanje fajla i foldera:

mc cp bekap.zip hostarena/vas-bucket/bekapi/
mc cp --recursive ./bekap hostarena/vas-bucket/bekap

Preuzimanje fajla i foldera:

mc cp hostarena/vas-bucket/bekapi/bekap.zip .
mc cp --recursive hostarena/vas-bucket/bekap ./vracanje

Podaci o jednom fajlu (veličina, datum):

mc stat hostarena/vas-bucket/bekapi/bekap.zip

Preslikavanje foldera (mirror)

mc mirror prenosi nove fajlove iz izvora na odredište. Prvo ga pokrenite sa --dry-run, da vidite šta bi se prenelo:

mc mirror --dry-run ./bekap hostarena/vas-bucket/bekap
mc mirror ./bekap hostarena/vas-bucket/bekap

Pažnja: opcija --overwrite prepisuje fajlove na odredištu, a opcija --remove briše sa odredišta sve što ne postoji u izvoru. Ako zamenite izvor i odredište, menjate fajlove na svom računaru. Sa tim opcijama uvek prvo pokrenite --dry-run.

Brisanje

mc rm hostarena/vas-bucket/bekapi/stari.zip
mc rm --recursive --force --dry-run hostarena/vas-bucket/stari-bekap

Pažnja: mc rm --recursive --force briše sve pod navedenom putanjom, bez pitanja. Obrisani fajlovi se ne mogu vratiti. Prvo pokrenite komandu sa --dry-run, pa tek onda bez nje.

Privremeni link za deljenje

Link za preuzimanje koji važi ograničeno vreme (ovde jedan sat), bez otvaranja bucketa za javnost:

mc share download --expire 1h hostarena/vas-bucket/dokument.pdf

Provera da radi

Pokrenite mc ls hostarena/vas-bucket. Ako dobijete spisak fajlova ili prazan odgovor bez greške, veza radi. Za potpunu proveru otpremite mali fajl i preuzmite ga nazad.

Najčešći problemi

Access Denied ili The Access Key Id you provided does not exist

Ključevi nisu dobro uneti. Ponovite mc alias set sa ključevima iz HostArena korisničkog panela.

Greška o regionu (AuthorizationHeaderMalformed)

Server očekuje region garage. Proverite da li koristite noviju verziju mc (mc update ako ste ga instalirali kao zaseban program) i da je alias napravljen sa --api S3v4. Ako greška ostane, otvorite tiket u korisničkom panelu.

Komande mc admin ne rade

Komande mc admin namenjene su upravljanju MinIO serverima i ne rade sa HostArena S3. Za rad sa fajlovima koristite ls, cp, mirror, rm i share.

Unable to initialize new alias

Adresa mora biti tačno https://s3.hostarena.rs, bez naziva bucketa. Proverite i da firewall dozvoljava izlazne HTTPS veze na port 443.

Zaključak

Slične mogućnosti imaju AWS CLI i rclone. Tehnički detalji o adresama i potpisivanju zahteva nalaze se u uputstvu HostArena S3 API: adrese, potpisivanje i kompatibilnost. Nemate S3 uslugu? Pogledajte pakete na stranici HostArena S3 storage. Ako zapne, otvorite tiket u korisničkom panelu.