Mencipta Imej Docker bagi Aplikasi Spring Boot menggunakan Buildpacks

pengenalan

Anda telah mencipta aplikasi Spring Boot. Ia berfungsi hebat pada mesin tempatan anda dan kini, anda perlu menggunakan aplikasi itu di tempat lain. Pada sesetengah platform, anda boleh menyerahkan terus fail balang dan ia akan digunakan. Di sesetengah tempat, anda boleh memutar mesin maya, memuat turun kod sumber di sana, membinanya dan menjalankannya. Tetapi, kebanyakan masa anda perlu menggunakan aplikasi menggunakan bekas. Selalunya, Docker digunakan untuk membina dan menjalankan imej dalam bekas. Selain itu, apabila anda memuat naik fail balang ke beberapa platform, aplikasi dijalankan di dalam bekas di bawah hud.

Jadi, dalam blog ini, kita akan melihat 3 cara berbeza untuk membina imej Docker untuk aplikasi Spring Boot yang diberikan. Jom mulakan:

Imej Bekas Asas

Cara yang naif dan tidak mencukupi untuk membina imej Docker untuk sebarang aplikasi adalah dengan menggunakan Dockerfile mudah yang menyalin fail jar di dalam imej dan menjalankannya menggunakan arahan java -jar.

Buat Dockerfile

Berikut ialah Dockerfile yang boleh anda letakkan pada akar projek:

FROM eclipse-temurin:21-jre-ubi9-minimal

ARG JAR_FILE

COPY ${JAR_FILE} application.jar

ENTRYPOINT ["java", "-jar", "/application.jar"]

Kami telah menetapkan satu hujah JAR_FILE yang merupakan lokasi fail balang untuk digunakan.

Membina Imej Docker

Selepas mencipta Dockerfile di atas, langkah di bawah digunakan untuk mencipta imej Docker:

1. Bina fail balang untuk projek Spring Boot:
   

   ./gradlew bootJar # For Gradle build system
   

   ATAU
   

   ./mvnw spring-boot:build-jar # For Maven build system
   

2. Gunakan Fail Docker untuk membina imej Docker menggunakan fail balang terkini. Dalam arahan di bawah gantikan {IMAGE_NAME} dengan nama imej yang diperlukan dan {JAR_FILE} dengan laluan ke fail jar yang dijana. Nama imej mengandungi teg juga, seperti - mycompany/product-service:0.0.1-SNAPSHOT:
   

   docker build --build-arg JAR_FILE={JAR_FILE} --tag {IMAGE_NAME} .
   

3. Sahkan jika imej Docker dibina menggunakan arahan berikut. Anda sepatutnya dapat melihat imej dengan nama yang dinyatakan dalam arahan di atas:
   

   docker images
   

Imej Bekas Cekap menggunakan Balang Berlapis

Walaupun boleh dan mudah untuk membungkus balang uber Spring Boot sebagai imej Docker (seperti yang dinyatakan dalam kaedah sebelumnya), terdapat banyak kelemahan untuk menyalin dan menjalankan balang gemuk sebagaimana adanya dalam imej Docker. Contohnya,

• Terdapat beberapa overhed tambahan apabila menjalankan balang uber tanpa membongkarnya.
• Meletakkan kod aplikasi dan semua kebergantungannya dalam satu lapisan adalah tidak optimum.

Memandangkan kami menyusun kod kami lebih kerap daripada menaik taraf versi Spring Boot, adalah lebih baik untuk memisahkan perkara lebih sedikit. Jika kita meletakkan fail jar tersebut (yang jarang ditukar) dalam lapisan sebelum lapisan aplikasi, maka Docker selalunya perlu menukar hanya lapisan bawah dan boleh memilih yang lain daripada cachenya.

Dayakan Balang Berlapis

Untuk mencipta imej Docker berlapis, kita perlu mencipta balang berlapis terlebih dahulu. Pada masa kini, ia didayakan secara lalai dalam Gradle dan Maven. Anda boleh mendayakan atau melumpuhkan gelagat balang berlapis menggunakan tetapan berikut:

// build.gradle
tasks.named("bootJar") {
    layered {
        enabled = false
    }
}

// build.gradle.kts
tasks.named7e534d3bd056dd41a31367722242bb81("bootJar") {
   layered {
      enabled.set(false)
   }
}

7a7963d93b467c9ab002af7a44e64bd4
c70346ba2d7be186a93fef826469bd2f
   5ac54a929980b32fdd2e48b6a8da067c
      c4222ff3007372f15ec728b963e717b6
         33ca7039399a4759a8764ea38765dd46
            05a8acc5c31084a4f61ade01873802caorg.springframework.boot192ca2f7b8c770b01c8f81e6bdd5b947
            9bc4cbb67f66e148869423c0d27e5f90spring-boot-maven-pluginb68fb17cb904a46b73e6272850323873
            f9d9f4a8f32d97f3ef0c10742ed31240
               e72a6d14eb9b15c1c12186917135155b
                  d79c9ed277a80783d30ca709c63bc2d1true1d1b3b9680fd03597e1ed3fa2b627c20
               98a78221d1c969529e0b9f39a24b39b0
            4b1b9d85fe86862ae3eab7e2045cf8a0
         9424ec9162a9b85f34067d0c54f34b32
      f3567a435ac6132b26525998d793443b
   f82c24fb6fac67972f6e79c18ccef56a
1755c7176d4002e2a322de4f48c796fa

Anda juga boleh menala cara lapisan dibuat. Lihat dokumentasi untuk konfigurasi gradle atau maven.

Buat Dockerfile

Di bawah ialah Dockerfile, yang boleh digunakan untuk memanfaatkan balang berlapis dan untuk mencipta imej Docker berlapis bagi aplikasi Spring Boot.

# Perform the extraction in a separate builder container
FROM eclipse-temurin:21-jre-ubi9-minimal AS builder

WORKDIR /builder

# This points to the built jar file in the target folder
# Adjust this to 'build/libs/*.jar' if you're using Gradle
ARG JAR_FILE=target/*.jar

# Copy the jar file to the working directory and rename it to application.jar
COPY ${JAR_FILE} application.jar

# Extract the jar file using an efficient layout
RUN java -Djarmode=tools -jar application.jar extract --layers --destination extracted

# This is the runtime container
FROM eclipse-temurin:21-jre-ubi9-minimal

WORKDIR /application

# Copy the extracted jar contents from the builder container into the working directory in the runtime container
# Every copy step creates a new docker layer
# This allows docker to only pull the changes it really needs
COPY --from=builder /builder/extracted/dependencies/ ./
COPY --from=builder /builder/extracted/spring-boot-loader/ ./
COPY --from=builder /builder/extracted/snapshot-dependencies/ ./
COPY --from=builder /builder/extracted/application/ ./

# Start the application jar - this is not the uber jar used by the builder
# This jar only contains application code and references to the extracted jar files
# This layout is efficient to start up and CDS friendly
ENTRYPOINT ["java", "-jar", "application.jar"]

Membina Imej Docker

Langkah-langkah untuk membina imej Docker berlapis adalah sama seperti membina imej Docker asas. Sila rujuk di sana.

Pek Binaan Asli Awan

Bagaimana jika saya memberitahu anda bahawa anda boleh mencipta imej Docker tanpa membuat fail Docker? Kita boleh membina imej docker terus daripada pemalam Gralde atau Maven menggunakan Cloud Native Buildpacks. Sesetengah platform (seperti Heroku atau Cloud Foundry) menggunakan Buildpacks untuk menukar fail balang yang disediakan kepada imej boleh jalan.

Spring Boot termasuk sokongan buildpack secara langsung untuk Maven dan Gradle. Kami tidak perlu memasukkan sebarang pemalam tambahan. Jalankan sahaja arahan di bawah:

./gradlew bootBuildImage # For gradle build system

ATAU

./mvnw spring-boot:build-image # For maven build system

Arahan di atas menjana imej dengan nama lalai {PROJECT_NAME}:${PROJECT_VERSION}. Jika anda ingin mengkonfigurasi nama imej yang dijana, anda boleh mengikuti langkah di bawah:

Konfigurasikan nama imej untuk sistem binaan Gradle

Kami boleh mengkonfigurasi tugas bootBuildImage untuk menetapkan nama imej, seperti ini:

// For build.gradle.kts
val imagePrefix = "javarush"
val dockerImageName = "docker-example"
tasks.named2e00f062267875fb651ebdd74d6c6eb1("bootBuildImage") {
   imageName.set("${imagePrefix}/${dockerImageName}:${version}")
}

// For build.gradle
def imagePrefix = "javarush"
def dockerImageName = "docker-example"
tasks.named("bootBuildImage") {
   imageName = "${imagePrefix}/${dockerImageName}:${version}"
}

Konfigurasikan nama imej untuk sistem binaan Maven

Kami boleh mengkonfigurasi spring-boot-maven-plugin untuk menggunakan nama imej lain, seperti ini:

a01741acb88936e4cea4237317380dd9
   d025b153d4d19d25710ee358f3c66eafjavarush515db9ab99a6918e33f7eeaddd64c8cf
86cd8b5c0fbd401fb69261955cf13796

...

c70346ba2d7be186a93fef826469bd2f
    5ac54a929980b32fdd2e48b6a8da067c
        c4222ff3007372f15ec728b963e717b6
            33ca7039399a4759a8764ea38765dd46
                05a8acc5c31084a4f61ade01873802caorg.springframework.boot192ca2f7b8c770b01c8f81e6bdd5b947
                9bc4cbb67f66e148869423c0d27e5f90spring-boot-maven-pluginb68fb17cb904a46b73e6272850323873
                f9d9f4a8f32d97f3ef0c10742ed31240
                    dc0870658837139040642baa5555a380
                        8a11bc632ea32a57b3e3693c7987c420${imagePrefix}/${project.artifactId}:${project.version}df406f776eecbaf16b62325323196f14
                    f8e950ebc6c1ea27f76cf997b9216fe6
                4b1b9d85fe86862ae3eab7e2045cf8a0
            9424ec9162a9b85f34067d0c54f34b32
        f3567a435ac6132b26525998d793443b
    f82c24fb6fac67972f6e79c18ccef56a
1755c7176d4002e2a322de4f48c796fa

Konfigurasikan nama imej semasa menjalankan arahan

Kita juga boleh menentukan nama imej semasa menjalankan arahan untuk membina imej.

./gradlew bootBuildImage --imageName=javarush/docker-example:1.0.0 # For grade build system

./mvnw spring-boot:build-image -Dspring-boot.build-image.imageName=javarush/docker-example:1.0.0 # For maven build system

You can see the documentation to further configure Gradle or Maven plugin.
This is my go-to method to create a Docker image for any Spring Boot application.

Running Docker Container

Once you create a docker image, you need to make sure that it works as expected. After you make sure that the image is created, you can directly run it using the docker run command. For example,

docker run -p "8080:8080" {IMAGE_NAME}

But, this is not how images are used in production applications. Docker Compose is used to run and manage multiple docker images.

Conclusion

In this blog, we have seen how to build Docker images for Spring Boot applications using different methods. Being able to build docker images for your apps is a must skill to know because the image is what gets delivered. Thanks for reading the article till the end. I appreciate it. I will meet you in the next one. As always, all feedback and suggestions are welcome.

Atas ialah kandungan terperinci Mencipta Imej Docker bagi Aplikasi Spring Boot menggunakan Buildpacks. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!