Compose file for multiple git projects

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

Back to top ↑