Introducere

Recent am fost pus într-o situatie dificilă. Am primit un laptop cu Windows. Partea și mai ciudată a fost că eu eram singurul din toata echipa tehnică care a primit un laptop cu Windows, toți ceilalți colegi aveau Mac. In mod evident, proiectul nu a fost făcut niciodată sa funcționeze pe Windows.

Singurii care au mai primit Windows în trecut l-au folosit în jur de o săptamană, până când le-a venit MacBook-ul, dar pe măsură ce treceau zilele (și săptămânile), a devenit evident că acesta nu o să fie și cazul meu.

Având in vedere că suntem în anul 2021 și criza cipurilor este în plină desfășurare, a trebuit să mă descurc în condițiile date.

Inițial am încercat opțiunea evidentă, Docker for Windows și Git for Windows, dar nu s-a dovedit a fi o idee prea bună. Problema este că aplicațiile Windows au nevoie de terminator de linie in stil Windows (\r\n), pe cand aplicațiile de Linux și macOS folosesc terminator de tip Unix (\n), și s-a dovedit foarte dificil să-mi dau seama unde e nevoie de unul și unde de altul. Chiar și atunci cand mi-am dat seama care se folosește unde, tot aveam problema că nu puteam face commit cu fișierele cu terminații diferite și trebuia sa le fac stash înainte de fiecare pull.

Cum funcționează

1. Descarcă și instalează WSL2 folosind instrucțiunile de aici: https://docs.microsoft.com/en-us/windows/wsl/install-win10

2. Restartează Windows (pentru că asta e ceva ce faci atunci când lucrezi cu Windows)

3. Din "Microsoft Store" instalează o distribuție de Linux (în acest tutorial voi folosi Ubuntu)

4. După ce s-a instalat distribuția, setup-ul va cere crearea de cont cu parolă, folosește ceva adecvat, acest cont se va folosi doar în interiorul distribuției Linux;

5. Deschide un PowerShell cu drepturi de admin și rulează următoarele comenzi:

   wsl --set-version Ubuntu 2 wsl --set-default Ubuntu

6. Pentru a verifica dacă pasul anterior a rulat cu succes, în aceeași instanță de shell rulează wsl -l -v, unde rezultatul ar trebuie să fie o linie cu Ubuntu și versiunea 2

7. Acum putem instala Docker, folosind pașii de aici: https://docs.docker.com/engine/install/ubuntu/#install-using-the-repository

8. Suntem aproape gata, trebuie doar să facem să pornească serviciul de Docker automat;

9. Apasă "Start" și apoi "Task Scheduler";

10. Apoi "Actions" > "Create Basic Task...";

11. Dă-i un nume și apasă Next;

12. în secțiunea de Trigger selectează "When I log on" și apasă Next;

13. în secțiunea de Action selectează "Start a program" și apasă Next;

14. în ecranul "Start a program" valoarea pentru "Program/script:" va fi "C:\Windows\System32\wsl.exe" și în "Add arguments (optional)" adaugă "-u root service docker start" și apoi apasă Next și Finish;

Asta este tot, după un restart de Windows, daemon-ul de Docker ar trebui sa porneasca automat.

Am observat ca uneori Windows nu rulează task-urile de startup dacă laptopul nu este la încărcat, dacă ai această problemă, sau Docker pur și simplu nu pornește, rulează în interiorul distribuției:

service docker start

O sugestie

Dacă folosești calculatorul doar pentru dezvoltare de software, ar trebui să iei în considerare distribuțiile de Linux mai prietenoase, cum este Ubuntu. Aplicații ca Docker și Git rulează mult mai bine pe Linux și suportul pentru aplicații ca IntelliJ și VS Code este foarte bun. Dacă nu ai încercat niciodată, sunt mult mai prietenoase cu utilizatorul decât ai crede.

Să folosești Docker pe orice altceva decât Linux este un compromis, chiar și pe Mac, ca să nu mai vorbim de Apple Silicon care este un compromis chiar mai mare decât Windows.

Folosesc Ubuntu pe calculatoarele mele personale de mai mult de un deceniu și, cu foarte puține excepții (cum ar fi interacțiunea cu unele aplicații web ale statului român), nu am avut nevoie de altceva.

Nota

Trebuie mentionat ca aceasta solutie este adaptata nevoilor mele, deci exista posibilitatea ca ele sa nu se suprapuna perfect cu nevoile tale. Totusi nu-ti face griji, totul este pe GitHub, asa ca poti lua doar ce ai nevoie.

Vreau sa mai adaug si ca acesta nu este blog de genul “ai folosit total gresit Magento2 cu Docker pana acum, uite cum se face de fapt”, eu doar vreau sa-mi impartasesc experienta. Probabil ca nu este cea mai buna solutie pentru toata lumea, dar cred ca orice persoana interesata de subiect poate gasi ceva util aici.

Intro

De aproape 2 ani folosesc Magento2 in containere Docker. Am facut asta si inainte, dar trebuie sa recunosc ca a fost pentru ca a trebuit, nu pentru ca am vazut calea cea buna, adica avantajele Docker.

Dupa cum probabil ai aflat deja, Magento2 nu este tocmai o aplicatie micuta si usoara, este chiar foarte greoi, lucru vizibil in special in timpul dezvoltarii.

Daca l-am compara cu un VM clasic, cu Docker ai avea in plus:

• Viteza: cred ca acesta este unul dintre cele mai mari avantaje, poti opri si porni containerele foarte rapid, doar primul build dureaza mai mult, dupa asta totul va fi foarte rapid;
• Mai putine resurse utilizate: Comparat cu un VM, un container nu trebuie sa includa tot sistemul de operare, in consecinta nu va ocupa mult spatiu pe disc si nu va folosi foarte multa putere de procesare, iar pentru ca nu este un OS intreg nu face toate lucrurile… de OS, in general face doar actiuni legate de serverul relevant.

Dar ce nu primesti in schimb:

• Curba de invatare: daca nu ai cunostinte de Docker si Docker Compose, o sa fie mai putin intuitiv la inceput;
• Prima instalare: este mai greu de setat la inceput, iar daca ai folosit VM-uri mult timp o sa ai impresia ca mergi impotriva curentului, dar cu siguranta o sa devina mult mai usor pe termen lung.

Luand cele de mai sus in considerare, vreau sa mentionez ca atunci cand am facut acest setup foloseam un Linux cu 8Gb de RAM. Un coleg chiar mi-a urat succes in a instala Magento2 pe un calculator ultraportabil cu 8Gb de RAM. Nici macar nu era sarcastic, era mai degraba compasiune legata de decizia mea proasta in a-mi alege calculatorul de lucru.

O alta nevoie a fost sa am izolare si configuratii specifice intre proiecte, nu puteam sa instalez un server pe local si gata.

In trecut am folosit Vagrant si VirtualBox, o combinatie foarte buna, foarte usor de folosit (in mare parte). Dar pentru Magento2, am realizat ca avea nevoie de prea multe resurse si calculatorul meu nu facea fata.

Totodata trebuia sa fie si usor de folosit, nu-mi place sa scriu comenzi de 3 cuvinte din memorie, vreau doar sa apas tab de cateva ori si sa se rezolve totul.

Cerintele

Au fost cateva cerinte specifice:

• nginx config – trebuia sa meraga din prima, iar fisierul de configurare pentru Magento 2 nu e tocmai mic si usor de folosit;
• SSL – domeniul trebuia sa mearga si cu HTTPS, in mare parte din pricina API-urilor care aveau nevoie de o conexiune HTTPS, chiar daca certificatul nu este valid;
• bash – comenzile de Magento trebuiau sa fie rulate cu utilizatorul de pe sistemul gazda, nu ca root (asa cum ruleaza in general containerele). Aveam nevoie de asta ca sa nu fie probleme de drepturi intre fisierele generate de mine si cele generate de Magento.
• xdebug – trebuie sa ruleze out of the box si sa fie usor de integrat cu un IDE.

Implementare si intrebuintare

Magento2 oferea un container Docker pentru dezvoltare. Nu vreau sa spun nimic de el, pentru ca nu era deloc ce imi trebuia.

Sursa mea principala de inspiratie a fost: https://github.com/markoshust/docker-magento. Proiectul s-a schimbat foarte mult in ultimii 2 ani, dar merita sa-i acordati cateva minute.

Punctul de inceput este: https://github.com/claudiu-persoiu/magento2-docker-compose

Fisierele relevante sunt:

• magento2 – ar trebui sa contina un folder html in care se afla proiectul;
• dkc_short – poate sa stea oriunde, dar ar trebui adaugat la ~/.bash_profile or ~/.bashrc, acest fisier contine alias-uri si scurtaturi, nu este neaparat necesar dar mie imi face viata mai usoara;
• docker-compose.yml – contine toate maparile si containerele relevante.

NOTA: Cred ca ar trebui sa mentionez ca in containerul PHP se pot rula comenzi in doua feluri, ca utilizator de sistem sau ca root. Aceasta limitare este datorata modului in care ruleaza containerele in Linux, o sa revin la acest subiect mai tarziu.

Pasul 1:

Ce trebuie facut atunci cand vrei sa rulezi un proiect Magento2 existent:

1$ git clone https://github.com/claudiu-persoiu/magento2-docker-compose.git nume_proiect
2$ cd nume_proiect
3$ git clone calea_catre_repository magento2/html

Pasul 2 (optional):

Copierea alias-urilor in consola bash:

1$ cp dkc_short ~/
2$ echo ~/dkc_short >> ~/.bash_profile
3$ source ~/.bash_profile

NOTE: Daca nu exista fisierul ~/.bash_profile atunci trebuie folosit ~/.bashrc

Pasul 3:

Pornirea containerelor:

1$ dkc-up -d

Va dura mai mult prima data, dar de data viitoare va fi mult mai rapid.

Pasul 4:

Instalat dependinte folosind composer:

1$ dkc-php-run composer install

Cam asta e tot.

Ce e chestia asta cu dkc?

Dupa cum spuneam, imi place sa folosesc tab cand scriu o comanda, asa ca mi-am adaugat cateva alias-uri care imi permit sa rulez comenzi fara sa tastez tot. De exemplu dkc[tab]p[tab]-[tab] si restul comenzii. Iubesc autocomplete-ul din bash.

Lista de comenzi este foarte simpla:

• dkc-up -d – pornesc toate containerele in background
• dkc-down – opresc toate containerele
• dkc-mag [command] – ruleaza o comanda Magento2
• dkc-clean – curata cache-ul
• dkc-php-run – ruleaza o comanda bash in containerul de PHP, cum a fost composer in exemplul anterior. NOTA: aceasta comanda ruleaza ca utilizator de sistem, nu root
• dkc-exec phpfpm [command] – la fel ca mai sus dar dar ruleaza ca root. In majoritatea cazurilor va fi nevoie doar de comanda de mai sus;
• dkc-exec [container] [command] – aceasta comanda are nevoie de explicatie mai extinsa:
  • poate sa fie:
    • app – pt serverul Nginx,
    • phpfrm – pentru containerul PHP,
    • db – pentru baza de date,
    • cache sau fpc – pentru cache;
  • aceasta comanda poate sa fie orice se aplica la un container, precum “bash” sau “bash composer”, etc.

Stiu ca toate comenzile par ca mai adauga ceva de invatat, dar in mare parte din timp doar primele 4 sunt necesare.

Cum functioneaza toata magia?

Pai, comenzile de mai sus se pot vedea in fisierul “dkc_short”.

Mai sunt doua repositories de interes:

• https://github.com/claudiu-persoiu/magento2-docker-php – containerul phpfpm,
• https://github.com/claudiu-persoiu/magento2-docker-nginx – containerul cu serverul nginx.

Repository-urile sunt destul de mici si relativ usor de inteles.

Daca ai nevoie sa modifici ceva, poti face un fork fara grija.

Concluzia

Cam asta e tot ce este de stiut, eu folosesc aceasta configuratie de aproape 2 ani.

Pentru mine functioneaza fara probleme si am putut sa folosesc Magento2 pe un calculator ultraportabil cu 8Gb RAM fara niciun neajuns.

Final (fericit)!