Sa incepem sa ne instalam local solutia peviitor.ro
In functie de SISTEMUL DE OPERARE, am pregatit scripturi automate care iti vor aduce local toata solutia tehnica.
Ce inseamna sa instalezi local solutia?
Apache SOLR este partea principala a acestui proiect.
Ruland scriptul de local_environment vei avea instalat local Apache SOLR cu ultima versiune publica oficiala. In plus, scriptul pregateste toata schema de care ai nevoie in Apache SOLR. La inceputul scriptului vei fi intrebat de un username si password, acestea vor fi credentialele cu care te vei loga pe Apache SOLR in interfata web care vine o data cu SOLR.
Apache SOLR este livrat printr-un Docker container si va rula pe portul 8983 si UI-ul Apache SOLR poate fi accessat la adresa: http://localhost:8983/ dupa ce rulezi scriptul de instalare local_environment.
Apache SOLR vine cu PlugIn'ul Basic Authentication pentru securizarea datelor.
Serverul WEB este componenta care livreaza partea de front-end, API-ul si Swagger-UI.
Acest server este livrat intr-un Docker container care va fi mapat pe portul 8081 iar imaginea este luata de pe Docker Hub https://hub.docker.com/r/alexstefan1702/php-apache
Nu e nevoie sa faci nimic manual, scriptul va pregati totul pentru tine.
Serverul WEB este un server (web) Apache.
Definitia completa a ceea ce contine containerul poti sa o vezi aici: https://hub.docker.com/layers/alexstefan1702/php-apache
Front-End'ul este componenta care se dezvolta de catre voluntarii nostri si o gasesti pe GitHUB la aceasta adresa: https://github.com/peviitor-ro/search-engine/ , insa nu trebuie sa faci nimic manual, scriptul va aduce local solutia pregatita pentru a fi rulata local astfel dupa ce vei rula scriptul vei accesa UI-ul la adresa: http://localhost:8081/
Scriptul de instalare foloseste sectiunea de Releases si aduce codul "build'uit" deja pregatit sa acceseze API-ul pe portul 8081.
Back-End'ul este componenta care livreaza datele dinamic. API-ul este scris in PHP si este accesibil prin Serverul Web. Codul PHP al API-ului este un "wrapper" peste Apache SOLR.
Codul sursa OPEN SOURCE sta pe GitHUB la adresa: https://github.com/peviitor-ro/api
Swagger-UI este componenta cu care poti testa interactiunea cu Apache SOLR prin intermediul API-ului. Practic este documentatia tehnica a bck-endului.
LINUX
tested: Ubuntu, Mint
Cloneaza repo-ul de la adresa:
https://github.com/peviitor-ro/local_environment
verifica in ce folder esti: pwd
creaza-ti un folder unde vrei sa clonezi acest repo: mkdir local_env
schimba folderul:
cd local_environment
cd local_env
folosind comanda git:
git clone https://github.com/peviitor-ro/local_environment.git
schimba folderul: cd linux-local-auth
ruleaza scriptul de instalare: sudo bash run.sh
Scriptul va astepta parola de la userul tau de linux.
Apoi vei seta un user pentru Apache SOLR Basic Authentication plugin.
Apoi vei seta o parola care trebuie sa respecte cateva reguli impuse de Apache SOLR.
In mai putin de 2 minute absolut toate componentele vor fi pregatite pentru tine instalate local.
Mai mult, la finalul scriptului TOATE locurile de munca vor fi aduse de pe PRODUCTION la tine local.
La finalul rularii scriptului ai cateva informatii importante legate de componentele din arhitectura acestui proiect.
OS-X
tested: Sonoma 14.6.1
Cloneaza repo-ul de la adresa:
https://github.com/peviitor-ro/local_environment
verifica in ce folder esti: pwd
creaza-ti un folder unde vrei sa clonezi acest repo: mkdir local_env
schimba folderul: cd local_env
folosind comanda git:
git clone https://github.com/peviitor-ro/local_environment.git
schimba folderul:
cd local_environment
cd OSX-local-auth
ruleaza scriptul de instalare: bash run.sh
Scriptul va astepta parola de la userul tau de OS-X.
Apoi vei seta un user pentru Apache SOLR Basic Authentication plugin.
Apoi vei seta o parola care trebuie sa respecte cateva reguli impuse de Apache SOLR.
In mai putin de 2 minute absolut toate componentele vor fi pregatite pentru tine instalate local.
Mai mult, la finalul scriptului TOATE locurile de munca vor fi aduse de pe PRODUCTION la tine local.
La finalul rularii scriptului ai cateva informatii importante legate de componentele din arhitectura acestui proiect.
Studiaza aceasta arhitectura si incearca sa intelegi fiecare componenta in parte. Este fundatia pe care este creat tot acest proiect. Daca nu intelegi o componenta din acest proiect, intreaba echipa. Este important sa explorezi: structura, datele, sa incerci sa modifici, sa adaugi date, sa stergi date.
Te ajuta Swagger-UI'ul care vine odata instalat acest environment la adresa: http://localhost:8081/swagger-ui/
Tema de casa:
Cum ajung datele in SOLR?
Cum se sterg datele din SOLR?
Unde stau datele stocate?
Exista o baza de date undeva?
Care este diferenta intre o baza de date si un index?
Este Apache SOLR o baza de date?
De ce s-a ales Apache SOLR ca si componenta in aceasta arhitectura?
Pot sa am eu datele mele care ma intereseaza pe mine in Apache SOLR sau este obligatoriu sa am datele de pe production?
De ce este important sa am un peviitor local?
Pot sa il folosesc in interes personal si sa imi pastrez aici doar locurile de munca care ma intereseaza?
Pot sa imi populez eu singur datele filtrand din PRODUCTION doar datele care ma intereseaza?
Cum vad datele care sunt locale si cum vad datele din PRODUCTION?
Ce inseamna un environment?