Hai semuanya, pada materi study kasus kali ini kita akan membahas tentang Multiple git project dalam menggunakan docker compose. Diantaranya kita akan bahas

  1. Introduction
  2. Solution 1 (Using separate compose file per project)
  3. Solution 2 (Include all compose files)
  4. Solution 3 (Centralize compose file)

Ok langsung aja kita ke pembahasan yang pertama

Introduction

Jaman sekarang itu hampir semua aplikasi menggunakan arsitektur micro-services, artinya semua service di pecah-pecah menjadi beberapa module. Dengan begitu biasanya setiap module akan di buatkan project gitnya seperti

  1. backend
    1. backend-1
    2. backend-2
    3. backend-n
  2. api-gateway
  3. frontend

Yang jadi pertanyaan sebagai seorang DevOps bagaimana kita deploy jika kita menggunakan compose file?

Nah buat temen-temen mau meng-deploy microservices dengan arsitketurnya seperti study kasus sebelumnya yaitu

  1. spring-boot (backend)
  2. Angular (frontend)

Tapi sebelum itu saya mau import dulu project angular dan spring-boot menggunakan git submodule dengan perintah seperti berikut:

git submodule add --force --name frontend \
-b compose/angular \
git@repository.dimas-maryanto.com:youtube/devops/docker.git frontend;

git submodule add --force --name backend \
-b compose/spring-boot \
git@repository.dimas-maryanto.com:youtube/devops/docker.git backend;

Maka sekarang kita punya struktur directory seperti berikut:

C:\USERS\DIMASM93\WORKSPACES\UDEMY\DOCKER
➜ docker git:(compose/multiple-projects) tree .
Folder PATH listing

C:\USERS\DIMASM93\WORKSPACES\UDEMY\DOCKER
├───.idea
├───backend/
└───frontend/

Solusi 1 (Using separate compose file per project)

Nah kita bisa jalankan masing-masing servicenya per compose file (1 service/project 1 compose file), klo saya gambarkan structur filenya seperti berikut:

➜ docker git:(compose/run-per-project) tree .
Folder PATH listing

C:\USERS\DIMASM93\WORKSPACES\UDEMY\DOCKER
├───backend/ (spring-boot)
│   ├───docker-compose.yaml
│   └───docker-compose.production.yaml
└───frontend/ (angular)
    ├───docker-compose.yaml
    └───docker-compose.production.yaml

Sekarang kita buat saja compose file baru dengan nama docker-compose.per-project.yaml untuk backend (spring-boot) seperti berikut:

Dan setelah itu kita juga buat compose file baru untuk frontend (angular) seperti berikut:

Jadi disini karena service angular membutuhkan service spring-boot tetapi kita tidak mendefined secara bersaama (berbeda path compose file). jadi solusinya adalah menggunakan network binding host yaitu ip-address host dan ini tidak bisa menggunakan localhost atau 127.0.0.1. Sebagai contoh disini ip address yang saya terpakan adalah

➜ docker git:(compose/run-per-project)  ipconfig.exe

Ethernet adapter Ethernet:

   Connection-specific DNS Suffix  . :
   Link-local IPv6 Address . . . . . : fe80::cc00:7233:e9c8:356c%21
   IPv4 Address. . . . . . . . . . . : 192.168.88.252
   Subnet Mask . . . . . . . . . . . : 255.255.255.0
   Default Gateway . . . . . . . . . : 192.168.88.1

Jadi kita perlu rubah untuk environment variable BACKEND_HOST=<your-network-ip> menjadi BACKEND_HOST=192.168.88.252. Sekarang klo kita coba jalankan menggunakan perintah seperti berikut:

docker-compose --project-directory backend \
-f backend/docker-compose.yaml \
-f backend/docker-compose.per-project.yaml up -d build-jar && \
docker-compose --project-directory backend \
-f backend/docker-compose.yaml \
-f backend/docker-compose.per-project.yaml up -d --build && \
docker-compose --project-directory frontend \
-f frontend/docker-compose.per-project.yaml up -d --build

Jika dijalankan maka hasilnya seperti berikut:

➜ docker git:(compose/run-per-project) docker-compose --project-directory backend -f backend\docker-compose.yaml -f backend\docker-compose.per-project.yaml up -d build-jar
[+] Running 2/2
 - Network backend_default        Created                                   0.0s
 - Container backend-build-jar-1  Starte...                                 1.4s

➜ docker git:(compose/run-per-project) docker-compose --project-directory backend -f backend\docker-compose.yaml -f backend\docker-compose.per-project.yaml up -d --build
[+] Running 2/2
 - Container backend-postgres-1     Runni...                                0.0s
 - Container backend-spring-boot-1  Ru...                                   0.0s

➜ docker git:(compose/run-per-project) docker-compose --project-directory backend -f backend\docker-compose.yaml -f backend\docker-compose.per-project.yaml ps
NAME                    COMMAND                  SERVICE             STATUS              PORTS
backend-build-jar-1     "/usr/local/bin/mvn-…"   build-jar           exited (0)  
backend-postgres-1      "docker-entrypoint.s…"   postgres            running             0.0.0.0:55432->5432/tcp
backend-spring-boot-1   "java -jar -Djava.se…"   spring-boot         running (healthy)   0.0.0.0:8080->8080/tcp

➜ docker git:(compose/run-per-project) docker-compose --project-directory frontend -f frontend\docker-compose.per-project.yaml up -d
[+] Running 1/0
 - Container frontend-angular-1  Running                                    0.0s

➜ docker git:(compose/run-per-project) docker-compose --project-directory frontend -f frontend\docker-compose.per-project.yaml ps
NAME                 COMMAND                  SERVICE             STATUS              PORTS
frontend-angular-1   "/docker-entrypoint.…"   angular             running (healthy)   0.0.0.0:80->80/tcp

Solution 2 (Include all compose files)

Selanjutnya kita akan mencoba menjalankan dengan cara include semua compose file, untuk struktur directory masih sama seperti sebelumnya yaitu seperti berikut:

➜ docker git:(compose/run-per-project) tree .
Folder PATH listing

C:\USERS\DIMASM93\WORKSPACES\UDEMY\DOCKER
├───backend/ (spring-boot)
│   ├───docker-compose.yaml
│   └───docker-compose.production.yaml
└───frontend/ (angular)
    ├───docker-compose.yaml
    └───docker-compose.production.yaml

Ok pertama kita buat compose file baru ya supaya tidak menggangu compose file yang sudah dibuat, sekarang kita buat untuk backend module dengan nama docker-compose.include-all.yaml seperti berikut:

Dan satu lagi, kita buat compose file baru dengan nama docker-compose.include-all.yaml untuk module frontend seperti berikut:

Jadi jika temen-temen perhatikan kita mengganti beberapa value untuk property

  1. <services>.build.context di tujukan ke folder tertentu berdasarkan modulenya masing-masing
  2. build-jar.volumes["./backend:/var/lib/spring-boot"], kita mengganti foldernya untuk localtion source-code backend
  3. backend.networks["frontend"], menambahkan network frondend supaya bisa connect dengan service angular
  4. angular.env["BACKEND_HOST=spring-boot"], mengganti host dari service tidak menggunakan ip lagi, tetapi dns docker
  5. angular.depends_on, menggunakan dependency dengan service name spring-boot

Ok sekarang kita bisa execute menggunakan perintah seperti berikut:

docker-compose --project-directory ./ \
-f backend/docker-compose.yaml -f backend/docker-compose.include-all.yaml \
-f frontend/docker-compose.include-all.yaml \
up -d build-jar && \
docker-compose --project-directory ./ \
-f backend/docker-compose.yaml -f backend/docker-compose.include-all.yaml \
-f frontend/docker-compose.include-all.yaml \
up -d --build

Jika dijalankan maka hasilnya seperti berikut:

➜ docker git:(compose/multiple-projects) docker-compose --project-directory ./ `
>> -f .\backend\docker-compose.yaml -f .\backend\docker-compose.include-all.yaml `
>> -f .\frontend\docker-compose.include-all.yaml `
>> up -d build-jar
[+] Running 1/1
 - Container docker-build-jar-1  Started                                     1.2s

➜ docker git:(compose/multiple-projects) docker-compose --project-directory ./ `
>> -f .\backend\docker-compose.yaml -f .\backend\docker-compose.include-all.yaml `
>> -f .\frontend\docker-compose.include-all.yaml `
>> up -d
[+] Running 3/3
 - Container docker-postgres-1     Running                                   0.0s
 - Container docker-spring-boot-1  Runni...                                  0.0s
 - Container docker-angular-1      Running                                   0.0s

➜ docker git:(compose/multiple-projects) docker-compose --project-directory ./ `
>> -f .\backend\docker-compose.yaml -f .\backend\docker-compose.include-all.yaml `
>> -f .\frontend\docker-compose.include-all.yaml `
>> ps
NAME                   COMMAND                  SERVICE             STATUS               PORTS
docker-angular-1       "/docker-entrypoint.…"   angular             running (starting)   0.0.0.0:80->80/tcp
docker-build-jar-1     "/usr/local/bin/mvn-…"   build-jar           exited (0)    
docker-postgres-1      "docker-entrypoint.s…"   postgres            running              0.0.0.0:55432->5432/tcp
docker-spring-boot-1   "java -jar -Djava.se…"   spring-boot         running (starting)   80/tcp

Solution 3 (Centralize compose file)

Selanjutnya kita akan mencoba menjalankan dengan cara centralize compose file (system terpusat), untuk struktur directory sekarang seperti berikut:

➜ docker git:(compose/run-per-project) tree .
Folder PATH listing

C:\USERS\DIMASM93\WORKSPACES\UDEMY\DOCKER
├───.env
├───docker-compose.yaml
├───docker-compose.override.yaml
├───docker-compose.production.yaml
├───backend/ (spring-boot)
└───frontend/ (angular)

Ok pertama kita buat compose file dengan nama docker-compose.yaml seperti berikut:

Setelah itu buat juga untuk docker-compose.override.yaml untuk melakukan build docker imagenya seperti berikut:

Kemudian untuk running di server, kita tidak perlu build lagi cukup pull saja dari docker image yang udah kita build sebelumnya yaitu dengan buat compose file baru namanya docker-compose.production.yaml seperti berikut:

Dan yang terakhir jangan lupa juga untuk menambahkan file .env seperti berikut:

Ok sekarang jika sudah, kita bisa jalankan dengan perintah seperti berikut:

docker-compose --env-file .env up build-jar && \
docker-compose --env-file .env up -d --build

Jika dijalankan maka hasilnya seperti berikut:

➜ docker git:(compose/multiple-projects) docker-compose --env-file .env up -d build-jar
[+] Running 4/4
 - Network docker_default        Created                                     0.0s
 - Volume "docker_pg_data"       Created                                     0.0s
 - Volume "docker_spring_data"   Created                                     0.0s
 - Container docker-build-jar-1  Started                                     1.3s

➜ docker git:(compose/multiple-projects) docker-compose --env-file .env up -d --build
[+] Building 3.9s (28/28) FINISHED
[+] Running 3/3
 - Container docker-postgres-1     Started                                   0.5s
 - Container docker-spring-boot-1  Start...                                  1.3s
 - Container docker-angular-1      Started                                   2.2s

➜ docker git:(compose/multiple-projects) docker-compose --env-file .env ps
NAME                   COMMAND                  SERVICE             STATUS               PORTS
docker-angular-1       "/docker-entrypoint.…"   angular             running (starting)   0.0.0.0:80->80/tcp
docker-build-jar-1     "/usr/local/bin/mvn-…"   build-jar           exited (0)

docker-postgres-1      "docker-entrypoint.s…"   postgres            running              0.0.0.0:5432->5432/tcp
docker-spring-boot-1   "java -jar -Djava.se…"   spring-boot         running (starting)   0.0.0.0:8080->8080/tcp