Nextcloud i HostArena S3: spoljno i primarno skladište

Nextcloud je program za sopstveni „oblak” za fajlove, sličan Dropbox-u ili Google Drive-u, koji instalirate na svoj server. HostArena S3 storage možete povezati sa Nextcloud-om na dva različita načina, i važno je da pre početka izaberete pravi.

Spoljno ili primarno skladište: koja je razlika

Ako niste sigurni, izaberite spoljno skladište. Ono je jednostavnije i bezbednije za postojeće instalacije.

Šta vam je potrebno

Sve podatke pronaći ćete u HostArena korisničkom panelu, kod vaše S3 usluge. Pripremite ih pre početka:

Secret Key čuvajte kao lozinku: ne šaljite ga mejlom i ne delite ga sa drugima.

Spoljno skladište (External storage)

1. Prijavite se u Nextcloud kao administrator.
2. Otvorite spisak aplikacija i proverite da je uključena aplikacija External storage support. Ako nije, uključite je.
3. Otvorite administratorska podešavanja i u levom meniju izaberite External storage.
4. U naziv foldera upišite kako želite da se folder zove u Nextcloud-u, npr. HostArena S3, a kao tip skladišta izaberite Amazon S3.
5. Popunite polja: Bucket: vas-bucket; Hostname: s3.hostarena.rs (bez https://); Port: 443; Region: garage.
6. Uključite Enable SSL i Enable Path Style. Opciju za staru (v2) autentifikaciju ostavite isključenu.
7. Za način prijave izaberite prijavu pristupnim ključem i upišite Access Key i Secret Key.
8. Izaberite kojim korisnicima ili grupama je folder dostupan i sačuvajte (kvačica na kraju reda).

Ako su podaci tačni, pored reda se pojavljuje zelena oznaka. Crvena oznaka znači da veza nije uspela; proverite podatke po odeljku „Najčešći problemi”.

Pažnja: folder spoljnog skladišta je direktan prikaz bucketa. Ako fajl obrišete u tom folderu, briše se i iz bucketa. Isto važi i obrnuto: ako fajl obrišete iz bucketa drugim programom, nestaće i iz Nextcloud-a.

Primarno skladište

Pažnja: bucket za primarno skladište treba da služi samo Nextcloud-u. Ne koristite isti bucket za bekape, sajt ili druge programe, i ne menjajte i ne brišite fajlove u njemu ručno. Nextcloud fajlove čuva pod brojčanim nazivima, a imena i folderi su zapisani samo u njegovoj bazi podataka. Ako se bucket „počisti” ručno ili se izgubi baza, fajlovi se praktično ne mogu vratiti. Zato redovno pravite bekap Nextcloud baze podataka.

Pažnja: primarno skladište podesite na novoj instalaciji, pre prvog otpremanja fajlova. Ako ga uključite na instalaciji koja već ima fajlove, postojeći fajlovi neće biti premešteni i korisnici ih više neće videti. Prebacivanje postojeće instalacije na S3 nije jednostavan postupak i nije pokriveno ovim uputstvom.

Podešavanje se upisuje u fajl config/config.php u Nextcloud folderu, pre završetka instalacije (ili odmah posle nje, dok nema fajlova). Dodajte blok objectstore unutar postojećeg niza $CONFIG:

<?php
$CONFIG = array (
  // ... postojeća podešavanja ostaju ...
  'objectstore' => [
    'class' => '\OC\Files\ObjectStore\S3',
    'arguments' => [
      'bucket' => 'vas-bucket',
      'hostname' => 's3.hostarena.rs',
      'port' => 443,
      'region' => 'garage',
      'use_ssl' => true,
      'use_path_style' => true,
      'autocreate' => false,
      'key' => 'VAS_ACCESS_KEY',
      'secret' => 'VAS_SECRET_KEY',
    ],
  ],
);

Umesto vas-bucket, VAS_ACCESS_KEY i VAS_SECRET_KEY upišite vaše podatke iz panela. Opcija autocreate je isključena jer bucket već postoji. Fajl config.php sadrži vaše ključeve, pa proverite da nije dostupan preko web-a (Nextcloud ga podrazumevano štiti).

Ako Nextcloud pokrećete kao Docker kontejner, zvanični Docker image podržava podešavanje primarnog S3 skladišta i preko promenljivih okruženja; pogledajte dokumentaciju tog image-a i upišite iste vrednosti (hostname, port 443, region garage, SSL i path-style uključeni).

Provera da radi

Za spoljno skladište: otvorite novi folder u Nextcloud-u, otpremite probni fajl i proverite da se vidi i u bucketu, npr. Cyberduck-om. Za primarno skladište: otpremite probni fajl u Nextcloud i proverite da se u bucketu pojavio novi objekat (sa brojčanim nazivom). Taj objekat ne dirajte.

Najčešći problemi

Pristup odbijen (Access Denied) ili neuspešna prijava

Proverite Access Key i Secret Key. Najčešće je pri kopiranju uhvaćen razmak na početku ili kraju. Kopirajte ključeve ponovo iz panela.

Veza ne može da se uspostavi

Proverite da je u polju za server upisano tačno s3.hostarena.rs, bez https://, bez kose crte na kraju i bez naziva bucketa ispred. Port mora biti 443, a HTTPS uključen. Ako ste na poslovnoj mreži, proverite da firewall dozvoljava izlazne veze na port 443.

Bucket nije pronađen (Bucket Not Found / NoSuchBucket)

Proverite naziv bucketa slovo po slovo, onako kako piše u panelu. Bucket se ne upisuje u polje za server, i nikada ne sme da se pojavi dva puta u adresi.

Greška koja pominje region (npr. „expected garage”)

U polju Region (ili 'region' u config.php) mora da piše garage. Ako je polje prazno, Nextcloud šalje us-east-1, i server odbija zahtev.

Posle uključivanja primarnog skladišta korisnici ne vide svoje fajlove

Primarno skladište je uključeno na instalaciji koja je već imala fajlove. Uklonite blok objectstore iz config.php da se vratite na prethodno stanje, i razmislite o spoljnom skladištu.

Ako problem i dalje postoji, otvorite tiket u korisničkom panelu i navedite tačan tekst greške.

Zaključak

Za postojeći Nextcloud izaberite spoljno skladište; za novu instalaciju koja treba da čuva sve na S3 izaberite primarno skladište, uz poseban bucket i redovan bekap baze. Ako Nextcloud radi u Docker-u, pogledajte i Docker aplikacije i HostArena S3, a tehničke detalje o adresama u tekstu HostArena S3 API.