Dokumentazioa

Galleria argazki portfolioa desplegatzea eta kudeatzea gidatzeko gida osoa.

Hasierako gida

Galleria React 19, TypeScript, Express 5 eta SQLite erabiliz eraikitako argazki portfolio webgune moderno bat da. Irudiak entregatzeko optimizatuta dago, administratzaile panela, analitika jarraipena eta erantzunkorra den diseinua ditu.

Lotura Azkarrak

Google OAuth SSO Konfigurazioa

Gaitu Google OAuth Hitzarmen Bakarra zure Galleria administrazio panelean seguru, pasahitzik gabeko autentifikazioa lortzeko.

1. Pausoa: Sortu Google Cloud Proiektua

  1. Joan Google Cloud Kontsolara
  2. Sortu proiektu berri bat edo hautatu dagoeneko bat
  3. Joan APIak eta Zerbitzuak → Kredentzialak
  4. Egin klik Sortu Kredentzialak → OAuth bezero ID
  5. Eskaera egiten bada, konfiguratu lehenik OAuth onarpen pantaila

2. Pausoa: Konfiguratu OAuth Bezeroa

  1. Aukeratu Web aplikazioa aplikazio mota gisa
  2. Gehitu zure domeina Baimentutako JavaScript jatorrietara:
    https://yourdomain.com
  3. Gehitu callback URL-a Baimentutako berridazpen URItara:
    https://yourdomain.com/api/auth/google/callback
  4. Egin klik Sortu eta gorde zure kredentzialak

3. Pausoa: Konfiguratu Galleria Ezarpenetan

  1. Sartu zure Galleria administrazio panelean
  2. Joan Ezarpenak → Google OAuth
  3. Sartu zure Google Bezero IDa
  4. Sartu zure Google Bezero Sekretua
  5. Egin klik Gorde Google OAuth SSO aktibatzeko

Erabiltzaile Automatikoko Bihurketa: Helbide elektronikoak bat datozen erabiltzaile existitzenak automatikoki Google OAuth autentifikazioan bihurtuko dira. OAuth konfiguratu ondoren, berehala saioa hasi dezakete Google-rekin.

Segurtasun Aholkua: Gehitu fidagarriak diren helbide elektronikoak administratzaile erabiltzaile gisa. Hasierako konfigurazioa egin ondoren, administrazio paneletik erabiltzaileen sarbidea kudeatu dezakezu.

OpenObserve Analitika Konfigurazioa

OpenObserve-k log analitika indartsuak eta denbora errealean monitorizazioa eskaintzen ditu zure Galleria webgunean geo-hobekuntza gaitasunekin.

1. Pausoa: Instalatu OpenObserve Dockerrekin

Exekutatu OpenObserve Docker Compose erabiliz:

2. Pausoa: Zerbitzu Kontua Sortu

  1. Sar zaitez OpenObserve-ra http://localhost:5080
  2. Saioa hasi zure administratzaile kredentzialekin
  3. Joan Ezarpenak → Zerbitzu Kontuak
  4. Egin klik Sortu Zerbitzu Kontua
  5. Izen bat eman (adibidez, "galleria-analytics") eta baimen egokiak esleitu
  6. Sortutako API tokena kopiatu gerora erabiltzeko

1. pausoa: Galleria konfiguratu

  1. Sartu zure Galleria administrazio panelera
  2. Joan Ezarpenak → Analitika
  3. Sartu zure OpenObserve URL-a (adibidez, http://localhost:5080)
  4. Sartu zure Erakundearen IDa
  5. Sartu zure Stream Izena (webgunea)
  6. Sartu zure Erabiltzaile Izena (2. pausotik)
  7. Sartu zure Pasahitza (2. pausotik zerbitzu kontuaren tokena)
  8. Egin klik Gorde OpenObserve analitikak aktibatzeko

Arrakasta! Zure analitikak orain geo-hobetutako datuak izango ditu hiria, eskualdea, herrialdea, ISP eta bisitarien koordenatuak barne.

Hardwareko Bideo Kodetzea

Galleria hardware azkartutako bideo kodetzea onartzen du 5-10x azkarrago bideo prozesatzeko zure GPUa erabiliz.

Onartutako Hardwarea

NVIDIA GPUak (NVENC)

Docker eta jatorrizko laguntza

Intel Quick Sync (QSV)

Jatorrizko laguntza bakarrik

AMD GPUak (AMF)

Erdiko laguntza bakarrik

Apple VideoToolbox

macOS erdiko bakarrik

Hardware Kodetzea Aktibatu

  1. Joan Administratzaileen Panelean → Ezarpenak → Bideo Kalitatea
  2. "Hardware Transcoding" aktibatzea aldatu
  3. Bideo prozesatzeak orain GPU azelerazioa erabiliko du eskuragarri dagoenean

Ekoizpenen Disposizioa

PM2 erabiliz

Docker gabe ekoizpenen disposizioa egiteko:

npm run build
npm install -g pm2
pm2 start ecosystem.config.cjs
pm2 save
pm2 startup

Automatizatutako Disposizioa: Master adarrean push egin eta GitHub Actions automatikoki zure aldaketak despliegatzen ditu.

Lagundu Dokumentazio Hau Hobetzen

Akats bat aurkitu duzu edo dokumentazioan lagundu nahi duzu? Ekarpenak ongi etorriak dira!

Ekarri GitHuben