Diferències

Ací es mostren les diferències entre la revisió seleccionada i la versió actual de la pàgina.

Enllaç a la visualització de la comparació

--- dockeritzacio_aplicacions_php [2022/07/12 18:28]
jordi_selga_ruiz
+++ dockeritzacio_aplicacions_php [2022/07/14 11:31] (actual)
jordi_selga_ruiz [Comprovació de funcionament]
@@ Línia 1: / Línia 1: @@
 ====== Dockerització d'aplicacions PHP amb connexió a BBDD ======
-{{tag> #FpInfor #Ciber #CiberMp03 #Ceti #php #mysql #docker #Laravel}}
+{{tag> #FpInfor #Ciber #CiberMp03 #Ceti #php #mysql #docker #Symfony #Laravel}}
 ===== Requeriments previs =====
 Per seguir bé aquest article cal tenir coneixements de [[docker|Docker pràctic]] i [[docker-compose|Docker Compose]] i s'ha de tenir instal·lat al sistema [[https://www.docker.com/get-started/|docker]] i [[https://docs.docker.com/compose/install/|docker-compose]]
+===== Referències =====
+  * Tutorial base d'aquest article: [[http://blog.adnansiddiqi.me/create-your-first-php-mysql-application-in-docker/|Create your first PHP/MySQL application in docker]]
+  * Documentació de Docker - https://docs.docker.com/
 ===== Desplegament d’aplicació en php i mysql =====
@@ Línia 25: / Línia 30: @@
 En aquest exemple s'ha optat per la versió 7.4 de php i s'ha afegit a la imatge extensions com [[https://www.php.net/manual/en/intro.pdo.php] |PDO]] o [[https://www.php.net/manual/en/ref.pdo-mysql.php|PDO_MYSQL]]. També s'ha habilitat el mòdul rewrite de l'apache, s'ha copiat el contingut de codi al directori per defecte i s'ha exposat el port 80.
-=== BBDD mySQL ===
+=== BBDD MySQL ===
 Per la part de la BBDD s'ha optat per una [[https://hub.docker.com/_/mysql|imatge base de mysql]] sense modificar per simplicitat (Més tard transferirem la BBDD a la imatge).
-<file yaml docker-compose.yml [enable_line_numbers="true",highlight_lines_extra="9,10,20,21,23"]>
+==== Configuració del fitxer docker-compose ====
+D'una banda tenim definida l'aplicació amb el nom app on hem optat per construir la imatge amb //build// i //context//. L'alternativa seria carregar la imatge pujada a un repositori remot com [[https://hub.docker.com/|Docker Hub]] (opció típica per a producció).
+En la directiva ports trobem definit extern:intern. En aquest cas, el port intern és el 80 que és el que apache sol fer servir per http i és el que hem exposat al Dockerfile. El port extern, en canvi, està configurat a 82 per evitar conflictes si la nostra màquina està servint alguna cosa pel port 80 (es pot canviar per un port a conveniència).
+La directiva //environment// indica les variables d'entorn que necessita la app. En aquest cas: host, user, password i database per a poder comunicar-se amb la BBDD.
+<file yaml docker-compose.yml [enable_line_numbers="true",highlight_lines_extra="3,16,27"]>
 version: '3.3'
 services:
-  mysql:
-    image: mysql:8.0
-    container_name: 'mysql-server-80'
-    volumes:
-      - mysql-data:/var/lib/mysql
-    restart: always
-    environment:
-      MYSQL_ROOT_PASSWORD: root
-      MYSQL_DATABASE: bank
-    ports:
-      - "8082:3306"
   app:
     container_name: app_php
@@ Línia 56: / Línia 55: @@
     depends_on:
       - mysql
+  mysql:
+    image: mysql:8.0
+    container_name: 'mysql-server-80'
+    volumes:
+      - mysql-data:/var/lib/mysql
+    restart: always
+    environment:
+      MYSQL_ROOT_PASSWORD: root
+      MYSQL_DATABASE: bank
+    ports:
+      - "8082:3306"
 volumes:
   mysql-data:
 </file>
+Pel que fa al servei de BBDD utilitzem la imatge mysql:8.0 del repositori oficial. Definim un volum amb la directiva // volumes // on enllacem el directori intern de la imatge // /var/lib/mysql // amb el volum de docker definit més endavant.  Definim les variables d'entorn necessàries i definim els ports extern i intern (en aquest cas l'extern es defineix diferent al per defecte per si tenim un servei funcionant en aquest port com en el cas del servei app).
+Finalment es defineix un volum intern de docker per assegurar la persistència amb // volumes // //mysql-data: // (Aquesta directiva ha d'esta al mateix nivell que // services // i al final del fitxer).
+==== Arrencada dels contenidors ====
+El primer cop hem d'arrencar amb l'argument --build per tal de construir la imatge. Després no caldrà a no ser que fem modificacions a l'aplicació i fos necessari reconstruir la imatge original.
+<code>
+docker-compose up -d --build
+</code>
+Comprovem que els dos contenidors estan arrencats amb // docker ps //:
+<code>
+docker ps
+CONTAINER ID   IMAGE           COMMAND                  CREATED          STATUS         PORTS                                                  NAMES
+cdc1c58ecd   dockerphp_app   "docker-php-entrypoi…"   9 seconds ago    Up 7 seconds   0.0.0.0:82->80/tcp, :::82->80/tcp                      app_php
+e2fbd45531d   mysql:8.0       "docker-entrypoint.s…"   10 seconds ago   Up 8 seconds   33060/tcp, 0.0.0.0:8082->3306/tcp, :::8082->3306/tcp   mysql-server-80
+</code>
+==== Importar la base de dades ====
+Per importar una base de dades existent hem de copiar un fitxer sql que contingui l'estructura de la BBDD i executar-lo en el contenidor:
+<code>
+docker cp bank.sql mysql-server-80:/bank.sql
+</code>
+<code>
+docker exec -i mysql-server-80 mysql -u root -proot bank < bank.sql
+</code>
+En el cas d'exemple tenim algunes dades de prova. Podem observar-ho entrant dins del contenidor del servei i consultant la BBDD:
+<code>
+mysql> select * from compte;
++----+--------+-------+--------+
+| id | codi   | saldo | client |
++----+--------+-------+--------+
+|  1 | BK 100 | 15000 |      1 |
+|  2 | BK 101 |   200 |      1 |
+|  3 | BK 200 | 18000 |      2 |
++----+--------+-------+--------+
+rows in set (0.00 sec)
+</code>
+==== Comprovació de funcionament ====
+Ara podem entrar a l'aplicació mitjançant el navegador (localhost:82) i fer les comprovacions pertinents.
+Es mostra el llistat dels comptes on s'ha afegit mitjançant l'aplicació un compte nou.
+{{:captura_de_pantalla_de_2022-07-13_13-25-16.png?200|}}
+També podem comprovar que si aturem els contenidors i els tornem a arrencar les dades persisteixen gràcies a l'ús de volums.
+<code>
+docker-compose down
+Stopping app_php         ... done
+Stopping mysql-server-80 ... done
+Removing app_php         ... done
+Removing mysql-server-80 ... done
+Removing network dockerphp_default
+</code>
+<code>
+docker-compose up -d
+Creating network "dockerphp_default" with the default driver
+Creating mysql-server-80 ...
+Creating mysql-server-80 ... done
+Creating app_php ...
+Creating app_php ... done
+</code>
+<code>
+select * from compte;
++----+--------+--------+--------+
+| id | codi   | saldo  | client |
++----+--------+--------+--------+
+|  1 | BK 100 |  15000 |      1 |
+|  2 | BK 101 |    200 |      1 |
+|  3 | BK 200 |  18000 |      2 |
+|  4 | BK 345 | 123456 |      2 |
++----+--------+--------+--------+
+rows in set (0.00 sec)
+</code>
+==== REPTE 1 ====
+<WRAP center todo>
+Fent servir el recurs penjat a: https://github.com/kadnan/DockerPHPTutorial edita el Dockerfile i el docker-compose.yml per poder desplegar amb contenidors docker l'aplicació proporcionada a la teva maquina local.
+</WRAP>
+==== REPTE 2 ====
+<WRAP center todo>
+Dockeritza una aplicació pròpia o bé alguna que trobis en algun repositori fent servir de guia els passos indicats anteriorment. Comprova que la pots fer funcionar al la tema màquina local
+Exeples d'aplicacions php amb mysql:
+  * https://github.com/shehryarkn/PHP-MySQL-CRUD-Web-Application
+  * https://github.com/justinhartman/complete-php7-ecom-website
+</WRAP>
+===== Dockerització d'aplicacions basades en Frameworks associats a PHP =====
+Si ja estem enfocats a Docker i habituat una possibilitat és que ja desenvolupem els nostres projectes directament amb un framework muntat sobre docker com per exemple de la forma que es descriu en l'article [[dockeritzacio_aplicacions_symfony|Dockerització d'aplicacions Symfony]] on tenim un symfony preparat per iniciar el nostre projecte. D'altra banda si el que volem és dockeritzar una aplicació basada en framework que ja tenim desenvolupada en local haurem de fer servir pasos diferents.
+==== Symfony ====
+S'ha de procedir igual que s'ha fet amb l'aplicació php amb mysql però s'ha de transferir al contenidor tot el directori del projecte inclús el directori vendor que sol ocupar més espai. Tot i així seria com si el pujèssim a un servidor tradicional amb un apache i php.
+Cal tenir en compte dues coses importants:
+  * S'ha d'exportar la BBDD del nostre projecte a un fitxer sql i copiar-lo al contenidor corresponent.
+  * La variable d'entorn <nowiki>DATABASE_URL="mysql://[nom_usuari]:[password]@[host]:[port]/[db]"</nowiki> s'ha d'adaptar pel contenidor docker de la base de dades on el host és el nom del servei i no localhost com normalment
+==== Laravel ====
+De la mateixa manera podem dockeritzar una aplicació feta amb Laravel
+Cal tenir en compte dues coses importants:
+  * S'ha d'exportar la BBDD del nostre projecte a un fitxer sql i copiar-lo al contenidor corresponent.
+  * Les variables d'entorn en aquest cas són:
+   - DB_CONNECTION=[mysql, postgres,...]
+   - DB_HOST=[nom del servei]
+   - DB_PORT=[port intern on s'exposa el servei]
+   - DB_DATABASE=[nom de la BBDD]
+   - DB_USERNAME=[nom d'usuari de la BBDD]
+   - DB_PASSWORD=[password de k'usuari de BBDD]
+Aquestes variables s'han d'adaptar al contenidor docker del servei de BBDD per tal que coincideixin.
+==== Resum Frameworks ====
+Tant amb Symfony com amb Laravel el més important és definir bé les variables d'entorn que canviaran respecte quan estem en desenvolupament. Es pot fer mitjançant la modificació del fitxer .env o fent servir la directiva environment del fitxer docker-compose.yml.
+L'altre opció mitxa que podem fer servir és instal·lar php  [[https://getcomposer.org/|composer]] en el contenidor de l'aplicació i dins del contenidor executar les actualitzacions i migracions necessaries.
+En el Dockerfile caldria afegir les linies necessàries per instal·lar composer
+<code>
+RUN php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
+RUN php composer-setup.php --install-dir=. --filename=composer
+RUN mv composer /usr/local/bin/
+</code>

bytes.cat

Eines de l'usuari

Eines del lloc

Diferències

Eines de la pàgina