Membangun Container Image Apache Tomcat Ramping (< 450 MB) Berbasis Windows NanoServer dengan Instrumentasi Observabilitas Bawaan
Pada lingkungan server enterprise dan data center dengan regulasi ketat, server aplikasi kerap berada di jaringan terisolasi (air-gapped) tanpa akses internet langsung. Panduan ini membahas teknik menyusun container image Apache Tomcat 9.0 native Windows Containers berbasis NanoServer (ltsc2022) yang disematkan agent telemetri Prometheus JMX Exporter serta multi-versi Java LTS (Eclipse Temurin JRE 11, 17, dan 21) menggunakan satu Dockerfile modular, lengkap dengan metode distribusinya ke private OCI registry maupun berkas arsip offline.
๐ Mengapa Menggunakan Windows NanoServer + JMX Exporter?#
Bagi System Engineer dan System Administrator (SysAdmin) yang mengelola beban kerja berbasis Java di ekosistem Microsoft Windows Server, kombinasi ini memberikan keuntungan operasional yang signifikan:
- Ukuran Image Ultra-Ramping (< 450 MB Total): Base image Windows Server Core berukuran sekitar ~4,5 GB hingga 5 GB. Sebaliknya, Windows NanoServer (
nanoserver:ltsc2022) memangkas subsistem grafis (GDI) dan Win32 legacy, menghasilkan base OS layer hanya ~100โ170 MB. Total image setelah digabung dengan Java Runtime, Tomcat, dan JMX Agent berada di kisaran ~430โ456 MB. - Observabilitas JVM Native Tanpa Port RMI Terbuka: Mengaktifkan Remote JMX standar melalui protokol Java RMI membuka risiko keamanan eksploitasi deserialization (Remote Code Execution) serta kerumitan port traversal di firewall. Menanamkan Prometheus JMX Exporter Java Agent langsung ke dalam image memungkinkan metrik internal JVM (Heap Memory, Metaspace, GC pause, dan Tomcat Thread Pools) diekspos melalui endpoint HTTP/HTTPS standar (port 9404) secara aman dan efisien.
- Fleksibilitas Multi-Versi Java dengan Satu Dockerfile: Kebutuhan aplikasi legacy maupun modern dapat dipenuhi cukup dengan satu template Dockerfile modular yang memanfaatkan argumen build (
--build-arg JAVA_TAG=...), sehingga Anda tidak perlu memelihara banyak Dockerfile terpisah untuk Java 11, 17, dan 21. - Kemandirian di Lingkungan Tertutup (Air-Gapped Ready): Image yang sudah dibuild dapat didistribusikan ke private container registry internal (seperti Gitea, Harbor, Nexus, Artifactory) atau diekspor ke file arsip
.taruntuk diimpor langsung di server target tanpa memerlukan koneksi ke Docker Hub atau internet publik. - Arsitektur Observabilitas Zero-Rebuild: Konfigurasi JMX bawaan menyertakan aturan dasar siap pakai serta mendukung mekanisme penimpaan (override) otomatis melalui direktori
conf/, sehingga penambahan metrik atau kustomisasi aturan baru dapat dilakukan sewaktu-waktu tanpa perlu membangun ulang (rebuild) citra container.
๐๏ธ Arsitektur & Alur Distribusi Image#
Proses pembuatan dimulai dari host builder Windows Server yang memiliki akses internet atau file biner lokal, kemudian didistribusikan ke server-server target melalui registry internal atau arsip offline:
flowchart TD
subgraph Build_Host ["Host Windows Server (Docker Engine)"]
TomcatZip["Biner Apache Tomcat 9.0"]
NanoBase["Base Image: Eclipse Temurin NanoServer
(Java 11 / 17 / 21)"]
JmxAgent["Prometheus JMX Exporter
Java Agent JAR + config.yaml"]
Builder["Docker Engine (windowsfilter)"]
BuiltImages["Local Container Images:
- tomcat:9.0-jdk11
- tomcat:9.0-jdk17
- tomcat:9.0-jdk21"]
end
subgraph Distribution ["Distribusi Image Enterprise"]
Registry["Private OCI Container Registry
(Gitea / Harbor / Artifactory)"]
TarArchive["File Arsip Offline (.tar)
(Air-Gapped Deployment)"]
end
TomcatZip --> Builder
NanoBase --> Builder
JmxAgent --> Builder
Builder --> BuiltImages
BuiltImages -->|docker push| Registry
BuiltImages -->|docker save| TarArchive
๐ ๏ธ Prasyarat Sistem & Kebutuhan#
Sebelum memulai tahapan build, pastikan host telah memenuhi spesifikasi berikut:
| Parameter | Spesifikasi / Kebutuhan |
|---|---|
| Sistem Operasi Host | Windows Server 2022 Datacenter (OS Build 20348) atau Windows Server 2019 (OS Build 17763) |
| Container Engine | Docker Engine Community Edition (CE) v27.0+ dalam mode Windows Containers |
| Hak Akses Shell | PowerShell 5.1 atau PowerShell 7+ dijalankan sebagai Administrator |
| Konektivitas / Biner | Akses internet untuk mengunduh biner upstream, ATAU file biner yang telah disiapkan sebelumnya pada folder lokal |
| Private Registry (Opsional) | Private OCI Container Registry (misal: Gitea Container Registry, Harbor, Docker Trusted Registry) jika menggunakan metode push jaringan |
Kernel Matching pada Windows Containers (Process Isolation): Pada mode Process Isolation (performa I/O disk NTFS 100% native), versi build kernel host Windows dan versi base image container harus identik:
- Host Windows Server 2022 (Kernel Build
20348) $\rightarrow$ gunakan base tag:ltsc2022. - Host Windows Server 2019 (Kernel Build
17763) $\rightarrow$ gunakan base tag:1809atau:ltsc2019.
๐ Langkah-Langkah Implementasi#
Langkah 1: Persiapan Direktori Kerja & Unduh Biner Komponen#
Jalankan perintah PowerShell berikut di host Windows untuk membuat direktori kerja (C:\build) dan mengunduh komponen yang dibutuhkan:
# 1. Buat struktur folder build kerja
New-Item -ItemType Directory -Force -Path "C:\build" | Out-Null
Set-Location "C:\build"
# 2. Unduh Apache Tomcat 9.0 binary zip resmi (~11 MB)
$tomcatVersion = "9.0.98"
$tomcatUrl = "https://archive.apache.org/dist/tomcat/tomcat-9/v$tomcatVersion/bin/apache-tomcat-$tomcatVersion.zip"
Write-Host "Mengunduh Apache Tomcat $tomcatVersion..." -ForegroundColor Cyan
Invoke-WebRequest -Uri $tomcatUrl -OutFile "tomcat.zip"
# 3. Ekstrak dan rapikan folder distribusi
Expand-Archive -Path "tomcat.zip" -DestinationPath "temp"
Move-Item "temp\apache-tomcat-$tomcatVersion" "tomcat"
Remove-Item -Recurse -Force "temp", "tomcat.zip"
# 4. Siapkan folder & unduh Prometheus JMX Exporter Java Agent (~500 KB)
New-Item -ItemType Directory -Force -Path "C:\build\jmx-exporter" | Out-Null
$jmxVersion = "1.0.1"
$jmxUrl = "https://repo1.maven.org/maven2/io/prometheus/jmx/jmx_prometheus_javaagent/$jmxVersion/jmx_prometheus_javaagent-$jmxVersion.jar"
Write-Host "Mengunduh Prometheus JMX Exporter v$jmxVersion..." -ForegroundColor Cyan
Invoke-WebRequest -Uri $jmxUrl -OutFile "C:\build\jmx-exporter\jmx_prometheus_javaagent.jar"
# 5. Konfigurasi Standar Prometheus JMX Exporter (Bawaan Citra)
# Aturan ini menangkap metrik Catalina dasar dan wildcard '.*' untuk auto-discovery MBean baru
$jmxConfig = @'
lowercaseOutputLabelNames: true
lowercaseOutputName: true
rules:
- pattern: 'Catalina<type=GlobalRequestProcessor, name=\"([^\"]+)\"><>(\w+):'
name: tomcat_request_processor_$2
labels:
name: "$1"
- pattern: 'Catalina<type=ThreadPool, name=\"([^\"]+)\"><>(\w+):'
name: tomcat_threadpool_$2
labels:
name: "$1"
- pattern: 'Catalina<type=Manager, host=([^,]+), context=([^,]+)><>(activeSessions|maxActive|sessionCounter):'
name: tomcat_session_$3
labels:
host: "$1"
context: "$2"
- pattern: '.*'
'@
Set-Content -Path "C:\build\jmx-exporter\config.yaml" -Value $jmxConfig -Encoding ASCII
# 6. Konfigurasi setenv.bat (Defensive JRE_HOME & Hierarchy Fallback JMX)
$setenvContent = @'
@echo off
rem 1. Alihkan JAVA_HOME ke JRE_HOME secara defensif agar catalina.bat tidak memvalidasi javac.exe
if not "%JAVA_HOME%" == "" set "JRE_HOME=%JAVA_HOME%"
set "JAVA_HOME="
rem 2. Logika Hierarchy Fallback JMX Exporter:
rem Prioritaskan custom config dari host bind-mount (%CATALINA_HOME%\conf\jmx-config.yaml) jika ada,
rem atau fallback ke default config bawaan citra (C:\jmx-exporter\config.yaml).
if exist "%CATALINA_HOME%\conf\jmx-config.yaml" (
set "CATALINA_OPTS=%CATALINA_OPTS% -javaagent:C:\jmx-exporter\jmx_prometheus_javaagent.jar=9404:%CATALINA_HOME%\conf\jmx-config.yaml"
) else if exist "C:\jmx-exporter\config.yaml" (
set "CATALINA_OPTS=%CATALINA_OPTS% -javaagent:C:\jmx-exporter\jmx_prometheus_javaagent.jar=9404:C:\jmx-exporter\config.yaml"
)
'@
Set-Content -Path "C:\build\tomcat\bin\setenv.bat" -Value $setenvContent -Encoding ASCIIMengapa Membutuhkan setenv.bat dengan Hierarchy Fallback?
- Defensive Bridging
JRE_HOME: Image resmi Temurin JRE mengekspor variabelJAVA_HOME. Skrip startupcatalina.batsecara default akan memvalidasi keberadaan compilerjavac.exejikaJAVA_HOMEdidefinisikan (mengasumsikan JDK penuh terpasang). Mengalihkan nilainya keJRE_HOMEmembuat Tomcat hanya memvalidasijava.exeruntime sehingga dapat berjalan normal di lingkungan JRE murni tanpa memicu errorNB: JAVA_HOME should point to a JDK not a JRE. - Zero-Rebuild Observability Architecture: Dengan menanamkan
config.yamldefault ke dalam image dan menyematkan logika pengecekanconf\jmx-config.yaml:- Out-of-the-Box: Container langsung menyajikan metrik Prometheus di port 9404 begitu di-start dengan parameter JMX.
- Bebas Masalah Mount Windows: Keterbatasan Windows Containers yang tidak mendukung file bind-mount dan ancaman directory shadowing dapat dihindari sepenuhnya.
- Kustomisasi Tanpa Rebuild: Jika aplikasi Anda membutuhkan aturan metrik kustom di masa depan, Anda cukup meletakkan file
jmx-config.yamldi direktori hostconf/(yang sudah ter-mount viaconf:ro) tanpa perlu membangun ulang (rebuild) citra container!
Langkah 2: Buat Dockerfile Modular Multi-Java#
Gunakan sintaks array PowerShell @(...) | Set-Content untuk menghasilkan file C:\build\Dockerfile. Penggunaan forward slash (/) pada direktori Windows dianjurkan untuk mencegah kendala escape character:
@(
"ARG JAVA_TAG=11-jre-nanoserver-ltsc2022",
'FROM eclipse-temurin:${JAVA_TAG}',
'ENV CATALINA_HOME="C:/usr/local/tomcat"',
'WORKDIR C:/usr/local/tomcat',
'COPY tomcat .',
'COPY jmx-exporter C:/jmx-exporter',
'EXPOSE 8080 8443 9404',
'CMD ["cmd.exe", "/c", "bin\\catalina.bat", "run"]'
) | Set-Content -Path "C:\build\Dockerfile" -Encoding ASCII
# Verifikasi isi Dockerfile
Get-Content "C:\build\Dockerfile"Cukup Dibuat Sekali Saja:
Baris ARG JAVA_TAG=11-jre-nanoserver-ltsc2022 hanyalah nilai default awal. Nilai ini akan ditimpa (override) secara dinamis pada saat proses build menggunakan parameter --build-arg JAVA_TAG=....
Langkah 3: Build Varian Image Java (JDK/JRE 11, 17, dan 21)#
Jalankan perintah build untuk ketiga versi Java LTS yang didukung. Docker Engine akan secara otomatis menarik (pull) base image Eclipse Temurin NanoServer terkait dan memasukkan biner Apache Tomcat serta agent JMX ke dalamnya:
Set-Location "C:\build"
# 1. Build varian Java 11 LTS
Write-Host "Membangun image Tomcat dengan Java 11..." -ForegroundColor Cyan
docker build --build-arg JAVA_TAG=11-jre-nanoserver-ltsc2022 -t tomcat:9.0-jdk11 .
# 2. Build varian Java 17 LTS
Write-Host "Membangun image Tomcat dengan Java 17..." -ForegroundColor Cyan
docker build --build-arg JAVA_TAG=17-jre-nanoserver-ltsc2022 -t tomcat:9.0-jdk17 .
# 3. Build varian Java 21 LTS
Write-Host "Membangun image Tomcat dengan Java 21..." -ForegroundColor Cyan
docker build --build-arg JAVA_TAG=21-jre-nanoserver-ltsc2022 -t tomcat:9.0-jdk21 .Setelah proses kompilasi selesai, periksa daftar image yang tersedia di repositori Docker lokal:
docker imagesOutput yang diharapkan menampilkan ketiga varian image dengan ukuran yang sangat ringkas:
REPOSITORY TAG IMAGE ID CREATED SIZE
tomcat 9.0-jdk21 406e457bc8ed 1 minute ago 456MB
tomcat 9.0-jdk17 0789b6cb3d6f 2 minutes ago 435MB
tomcat 9.0-jdk11 3b5ceae84cd7 3 minutes ago 430MBSolusi Jika Image Berstatus <none>:<none>:
Jika opsi -t terpotong saat eksekusi, image tetap berhasil dibuild namun belum memiliki nama/tag. Anda tidak perlu mengulang proses build, cukup berikan tag secara manual menggunakan Image ID:
docker tag <IMAGE_ID> tomcat:9.0-jdk17Langkah 4: Publikasi & Distribusi Image#
Terdapat dua metode distribusi image ke server produksi target:
Metode A: Private OCI Container Registry (Direkomendasikan untuk Jaringan Enterprise)#
Metode ini paling efisien jika server produksi Anda dapat menjangkau server container registry internal (misal: Gitea Container Registry, Harbor, Nexus, Artifactory, atau Docker Registry v2).
Daftarkan Insecure Registry (Jika Menggunakan HTTP Tanpa Sertifikat Publik): Jika server registry internal Anda berjalan di atas protokol HTTP atau sertifikat self-signed, daftarkan alamatnya ke
C:\ProgramData\docker\config\daemon.json:# 1. Pastikan folder konfigurasi docker tersedia $configDir = "C:\ProgramData\docker\config" if (-not (Test-Path $configDir)) { New-Item -ItemType Directory -Force -Path $configDir | Out-Null } # 2. Tambahkan alamat registry ke array insecure-registries $registryAddress = "registry.internal.corp:5000" # Sesuaikan dengan domain/IP registry Anda $configPath = "$configDir\daemon.json" $json = if (Test-Path $configPath) { Get-Content $configPath -Raw | ConvertFrom-Json } else { @{} } $currentInsecure = @($json.'insecure-registries') if ($currentInsecure -notcontains $registryAddress) { $json | Add-Member -NotePropertyName "insecure-registries" -NotePropertyValue ($currentInsecure + $registryAddress) -Force $json | ConvertTo-Json -Depth 5 | Set-Content $configPath -Encoding ASCII Write-Host "Merestart Docker Engine untuk memuat konfigurasi registry..." -ForegroundColor Yellow Restart-Service docker }Login, Berikan Tag, dan Push ke Registry:
$registry = "registry.internal.corp:5000" $namespace = "devops" # Login ke registry docker login $registry # Tag image sesuai format OCI: <registry>/<namespace>/<repository>:<tag> docker tag tomcat:9.0-jdk11 "$registry/$namespace/tomcat:9.0-jdk11" docker tag tomcat:9.0-jdk17 "$registry/$namespace/tomcat:9.0-jdk17" docker tag tomcat:9.0-jdk21 "$registry/$namespace/tomcat:9.0-jdk21" # Push image ke registry docker push "$registry/$namespace/tomcat:9.0-jdk11" docker push "$registry/$namespace/tomcat:9.0-jdk17" docker push "$registry/$namespace/tomcat:9.0-jdk21"Menarik (Pull) Image di Server Target: Di server target, image siap diunduh kapan saja tanpa membutuhkan koneksi internet:
docker pull registry.internal.corp:5000/devops/tomcat:9.0-jdk17
Metode B: Ekspor Arsip File .tar (Solusi untuk Jaringan Air-Gapped Murni)#
Jika server produksi terisolasi secara fisik tanpa ada jaringan ke registry OCI, Anda dapat mengekspor image menjadi berkas arsip .tar:
Simpan (Save) Image ke File
.tardi Host Windows:New-Item -ItemType Directory -Force -Path "C:\images-archive" | Out-Null Write-Host "Mengekspor image ke file arsip..." -ForegroundColor Cyan docker save -o "C:\images-archive\tomcat-9.0-jdk11.tar" tomcat:9.0-jdk11 docker save -o "C:\images-archive\tomcat-9.0-jdk17.tar" tomcat:9.0-jdk17 docker save -o "C:\images-archive\tomcat-9.0-jdk21.tar" tomcat:9.0-jdk21Pindahkan File ke Server Target: Kirimkan berkas
.tarke server target melalui SCP, SFTP, shared storage, atau media penyimpanan USB fisik.Impor (Load) Image di Server Produksi Offline: Di server target, jalankan perintah
docker load:docker load -i "C:\images-archive\tomcat-9.0-jdk17.tar" # Verifikasi bahwa image telah terdaftar docker images
Langkah 5: Smoke Test & Verifikasi Runtime#
Untuk memastikan image yang telah dibuild berfungsi dengan baik, jalankan uji coba kontainer dengan mempublikasikan port HTTP aplikasi (8080) dan port Prometheus JMX Exporter (9404):
# 1. Jalankan container uji coba
docker run -d --name tomcat-test -p 8080:8080 -p 9404:9404 tomcat:9.0-jdk17
# 2. Tunggu beberapa detik dan cek status container
docker ps
# 3. Periksa log bootstrap Tomcat (pastikan Java Agent JMX aktif)
docker logs tomcat-test
# 4. Uji respons HTTP aplikasi web Tomcat (port 8080)
Invoke-WebRequest -Uri "http://localhost:8080/" -UseBasicParsing | Select-Object StatusCode, StatusDescription
# 5. Uji respons endpoint metrik Prometheus JMX Exporter (port 9404)
$metricsResponse = Invoke-WebRequest -Uri "http://localhost:9404/metrics" -UseBasicParsing
[PSCustomObject]@{
StatusCode = $metricsResponse.StatusCode
StatusDescription = $metricsResponse.StatusDescription
SampleMetrics = ($metricsResponse.Content -split "`n" | Where-Object { $_ -match "^(jvm_|tomcat_)" } | Select-Object -First 3) -join " | "
}Jika output StatusCode untuk port 8080 bernilai 200 atau 404, dan port 9404 mengembalikan metrik Prometheus (HTTP 200), berarti Tomcat dan agen observabilitas JMX telah aktif sempurna!
Setelah pengujian selesai, bersihkan container uji coba:
docker rm -f tomcat-testLangkah 6: Praktik Kustomisasi & Menambah Metrik JMX Baru Tanpa Rebuild Citra (Zero-Rebuild Override)#
Salah satu keunggulan terbesar dari arsitektur Hierarchy Fallback pada skrip setenv.bat adalah Anda tidak perlu me-rebuild image Docker saat ingin menambahkan metrik baru, memonitor MBean aplikasi tertentu, atau mengubah konvensi penamaan telemetri.
Berikut tutorial praktis langkah-demi-langkah cara mengubah konfigurasi JMX langsung dari host Windows:
1. Skenario Kebutuhan: Menambahkan Monitoring Database Pool & Servlet#
Katakanlah aplikasi enterprise Anda menambahkan connection pool HikariCP (com.zaxxer.hikari) dan Anda ingin mengekspos metrik koneksi aktif, idle, serta waktu pemrosesan servlet tertentu.
2. Buat Berkas jmx-config.yaml pada Direktori Host conf\#
Di host Windows, buat file jmx-config.yaml langsung di dalam folder bind-mount conf/ instance Tomcat Anda (misal C:\tomcats\tomcat-lab\conf\jmx-config.yaml):
$customJmx = @'
lowercaseOutputLabelNames: true
lowercaseOutputName: true
rules:
# 1. Aturan Standar Tomcat (Request & ThreadPool)
- pattern: 'Catalina<type=GlobalRequestProcessor, name=\"([^\"]+)\"><>(\w+):'
name: tomcat_request_processor_$2
labels:
name: "$1"
- pattern: 'Catalina<type=ThreadPool, name=\"([^\"]+)\"><>(\w+):'
name: tomcat_threadpool_$2
labels:
name: "$1"
# 2. METRIK TAMBAHAN BARU: Database Connection Pool (HikariCP)
- pattern: 'com.zaxxer.hikari<type=Pool \((.+)\)><>(ActiveConnections|IdleConnections|TotalConnections|ThreadsAwaitingConnection):'
name: app_hikaricp_$2
labels:
pool: "$1"
type: GAUGE
# 3. METRIK TAMBAHAN BARU: Waktu Eksekusi Servlet & Error Count
- pattern: 'Catalina<j2eeType=Servlet, name=([^,]+), WebModule=([^,]+), J2EEApplication=none, J2EEServer=none><>(processingTime|requestCount|errorCount):'
name: tomcat_servlet_$3
labels:
servlet: "$1"
module: "$2"
# 4. Fallback Catch-All Wildcard (Otomatis Tangkap MBean Lainnya)
- pattern: '.*'
'@
# Tulis berkas ke folder conf host yang sudah di-mount ke container
Set-Content -Path "C:\tomcats\tomcat-lab\conf\jmx-config.yaml" -Value $customJmx -Encoding ASCII3. Terapkan Konfigurasi Baru (Cukup Restart)#
Karena direktori host conf/ terhubung ke kontainer melalui bind mount (conf:ro), kontainer cukup di-restart tanpa perlu membuang image atau melakukan build ulang:
docker restart tomcat-labAtau saat menjalankan kontainer baru:
docker run -d --name tomcat-lab `
-p 8080:8080 -p 9404:9404 `
-v "C:\tomcats\tomcat-lab\conf:C:\usr\local\tomcat\conf:ro" `
tomcat:9.0-jdk17Saat Tomcat melakukan bootstrap, skrip setenv.bat otomatis mendeteksi:
if exist "%CATALINA_HOME%\conf\jmx-config.yaml"Karena file tersebut ditemukan di folder conf, Java Agent JMX langsung memuat konfigurasi kustom tersebut, mengabaikan konfigurasi default image tanpa menyentuh satu pun layer Docker.
4. Verifikasi Metrik Baru di Endpoint /metrics#
Uji apakah metrik baru HikariCP dan Servlet sudah berhasil diekspos oleh Prometheus JMX Exporter:
# Filter output metrik baru dari endpoint port 9404
(Invoke-WebRequest -Uri "http://localhost:9404/metrics" -UseBasicParsing).Content -split "`n" | Select-String -Pattern "app_hikaricp|tomcat_servlet"Output yang diharapkan menampilkan deretan metrik time-series baru yang siap di-scrape oleh server Prometheus:
app_hikaricp_ActiveConnections{pool="HikariPool-1",} 5.0
app_hikaricp_IdleConnections{pool="HikariPool-1",} 15.0
tomcat_servlet_processingTime{module="//localhost/",servlet="dispatcherServlet",} 142.0๐ ๏ธ Tips Operasional & Troubleshooting SysAdmin#
1. Jebakan Indentasi Here-String PowerShell (Stuck pada Prompt >>)#
Saat menyalin skrip yang menggunakan sintaks Here-String (@' ... '@) langsung ke konsol terminal:
- Tanda penutup
'@wajib berada persis di karakter pertama baris baru tanpa spasi atau tab sama sekali. - Jika ada spasi di depan
'@, PowerShell tidak akan menganggapnya sebagai penutup blok teks, sehingga terminal akan stuck menunggu input baris baru dengan menampilkan prompt>>. - Solusi: Tekan
Ctrl + Cuntuk membatalkan eksekusi, dan gunakan sintaks array string@( ... ) | Set-Contentyang kebal terhadap masalah spasi dan indentasi.
2. Error “Could not find a part of the path C:\ProgramData\docker\config\daemon.json”#
Secara default, instalasi baru Docker CE di Windows Server tidak otomatis membuat subfolder config di dalam direktori C:\ProgramData\docker.
- Perintah PowerShell
Set-Contentakan melempar errorDirectoryNotFoundExceptionjika direktori induk belum ada. - Solusi: Selalu jalankan
New-Item -ItemType Directory -Force -Path "C:\ProgramData\docker\config"sebelum mencoba menulis atau memodifikasi filedaemon.json.
3. Mengapa Menggunakan Base Image JRE Headless (Klarifikasi Label JDK vs JRE)#
- NanoServer (
nanoserver:ltsc2022) + JRE: Merupakan sistem operasi kontainer Windows paling ramping (~100โ170 MB). Base image menggunakan Eclipse Temurin JRE tanpa compilerjavac.exedan pustaka grafis Win32/GDI untuk menjaga ukuran image tetap ultra-ringan (< 450 MB). - Kompilasi JSP Tetap Bekerja: Apache Tomcat secara default menyertakan Eclipse Compiler for Java (
ecj-*.jar) di dalam direktorilib/, sehingga aplikasi tetap dapat mengompilasi berkas JSP secara runtime di lingkungan JRE murni. - Konvensi Penamaan Tag: Tag image diberi label
tomcat:9.0-jdk11/jdk17/jdk21semata-mata sebagai konvensi industri untuk mengindikasikan level platform bahasa Java yang didukung, bukan berarti di dalamnya terdapat paket JDK penuh (development kit).
4. Mengatasi Error “server gave HTTP response to HTTPS client”#
Jika saat menjalankan docker push atau docker pull muncul error:
Error response from daemon: Get "https://registry.internal.corp:5000/v2/": http: server gave HTTP response to HTTPS clientPenyebabnya adalah Docker client secara default selalu mencoba koneksi aman TLS/HTTPS. Daftarkan nama domain/IP registry tersebut ke dalam array insecure-registries pada C:\ProgramData\docker\config\daemon.json, kemudian restart daemon dengan perintah Restart-Service docker.
5. Jebakan Directory Shadowing & Strategi Menambah Metrik JMX Baru Tanpa Rebuild Citra#
Dalam ekosistem Windows Containers, terdapat dua aturan penting terkait bind mount dan JMX:
- Windows Containers Tidak Mendukung File Bind-Mount: Anda tidak dapat me-mount file tunggal seperti
-v C:\host\config.yaml:C:\jmx-exporter\config.yaml. - Bahaya Directory Shadowing: Jangan sekali-kali mencoba me-mount direktori host ke
C:\jmx-exporter(misal-v C:\host\jmx:C:\jmx-exporter), karena berkasjmx_prometheus_javaagent.jardi dalam image akan tertimpa dan lenyap (shadowed), menyebabkan JVM gagal start dengan erroragent library failed to init: instrument.
Solusi Zero-Rebuild saat Ingin Menambah Metrik Baru:
- Kasus A (Auto-Discovery MBean Baru): Image ini telah dilengkapi aturan wildcard
pattern: '.*'. Jika aplikasi menambahkan connection pool baru (misal HikariCP, DBCP), metrik Spring Boot, atau custom Java MXBean, metrik tersebut otomatis terdeteksi dan muncul di port 9404 tanpa perlu ubah konfigurasi apa pun. - Kasus B (Kustomisasi Format / Filter Aturan Khusus): Anda tidak perlu me-rebuild image. Berkat arsitektur Hierarchy Fallback, cukup letakkan berkas kustom Anda di dalam direktori host
conf\(misalC:\tomcats\<instance>\conf\jmx-config.yamlyang di-mount secara aman viaconf:ro). Skripsetenv.batakan otomatis memprioritaskan berkas tersebut dibandingkan konfigurasi bawaan image.
๐ Referensi Terkait#
- Panduan Praktis: Instalasi Docker Engine Community Edition (CE) v27+ di Windows Server
- Panduan Praktis: Build Monitoring Stack di Windows NanoServer
- Microsoft Windows Container Base Images Documentation
- Eclipse Temurin Official Container Images (Docker Hub)
- Prometheus JMX Exporter Official Repository
- Apache Tomcat Official Archive Downloads