Cara Menggunakan Docker Buildx Bake untuk Membuat Pipa Pembuatan Gambar Kompleks

Grup perintah docker buildx menggunakan BuildKit untuk mengekspos kemampuan pembuatan gambar tingkat lanjut. Build yang dipanggang adalah fitur tingkat tinggi yang dapat digunakan untuk menentukan pipeline build otomatis. Mereka memungkinkan Anda menghasilkan banyak gambar dari satu operasi build.

Alur kerja yang dipanggang sangat membantu saat Anda ingin memublikasikan berbagai varian gambar Anda atau membuat beberapa proyek tertaut secara paralel. Dalam artikel ini kita akan membahas fitur utama dari docker buildx bake dan bagaimana Anda dapat menggunakannya untuk merampingkan build yang kompleks.

Mulai

Perintah docker buildx bake mengeksekusi beberapa "target" build yang masing-masing menghasilkan gambar container. Target berjalan secara paralel jika memungkinkan untuk memaksimalkan kinerja. Target juga dapat secara langsung merujuk pendahulunya untuk membuat jalur pipa sekuensial.

Target build dapat ditentukan menggunakan beberapa mekanisme berbeda termasuk file Docker Compose yang ada. Buildx akan secara otomatis membangun semua gambar yang diidentifikasi dalam file.

Fitur yang lebih canggih ditampilkan saat Anda mencantumkan target build dalam file JSON atau HCL. Variabel pendukung, fungsi, dan interpolasi nilai ini untuk menyesuaikan build Anda.

Perintah buildx bake mencari file berikut secara berurutan:

• docker-compose.yml
• docker-compose.yaml
• docker-bake.json
• docker-bake.override.json
• docker-bake.hcl
• docker-bake.override.hcl

Anda dapat menentukan file yang berbeda dengan flag perintah -f .

Bangun Target

Target build merangkum semua konfigurasi yang terkait dengan build Anda. Mereka termasuk rincian seperti

• jalur ke Dockerfile untuk membangun
• membangun jalur konteks, mendefinisikan konten yang tersedia di dalam Dockerfile Anda
• tag dan label untuk dilampirkan ke gambar keluaran
• platform untuk menghasilkan gambar.

Daftar lengkap bidang konfigurasi yang didukung tersedia di dokumentasi. Sebelumnya Anda mungkin telah menyediakan pengaturan ini sebagai flag baris perintah ke docker buildx build (atau bahkan docker build biasa), memaksa Anda untuk mengingat nilai yang benar setiap kali. Dengan buildx bake Anda dapat dengan andal menggunakan nilai yang sama dengan mendefinisikannya di file panggang yang dikontrol versi Anda.

Berikut adalah contoh sederhana dari perintah docker-bake.hcl yang mendefinisikan satu target build:

 target "default" { dockerfile = "app/Dockerfile" contexts = { app = "app/src" shared = "shared-components/src" } tags = ["my-app:latest", "docker.io/my-org/my-app:latest"] }

Menjalankan docker buildx bake dengan file bake ini akan memuat app/Dockerfile Dockerfile dari direktori kerja Anda. Itu akan memiliki akses ke direktori app/src dan shared-components/src sebagai konteks build. Gambar yang dihasilkan akan diberi dua tag.

Target default dibangun secara otomatis saat Anda menjalankan docker buildx bake . Anda juga dapat menentukan target bernama yang dapat dibangun sesuai permintaan:

 target "app" { // ... }

 $ docker buildx bake app

Menggunakan Beberapa Target

Anda dapat membuat gambar lain secara bersamaan dengan mendefinisikannya sebagai target baru di dalam file panggang Anda:

 group "default" { targets = ["app", "api"] } target "app" { dockerfile = "app/Dockerfile" contexts = { app = "app/src" shared = "shared-components/src" } tags = ["my-app:latest", "docker.io/my-org/my-app:latest"] } target "api" { dockerfile = "api/Dockerfile" contexts = { src = "api/src" } tags = ["my-api:latest", "docker.io/my-org/my-api:latest"] }

Gambar-gambar ini dapat dibuat secara bersamaan karena disarangkan ke dalam grup. Gambar api dan app akan dibuat secara paralel setiap kali Anda menjalankan perintah docker buildx bake karena grup default dipilih secara otomatis. Anda dapat menggunakan grup bernama mirip dengan contoh target bernama di atas.

Bangun Warisan Target

Target build dapat saling mewarisi untuk menggunakan kembali konfigurasi. Satu skenario di mana ini bisa berguna menyangkut gambar yang perlu disesuaikan untuk lingkungan yang berbeda. Anda mungkin ingin menambahkan file konfigurasi tambahan ke varian gambar yang ditujukan untuk penggunaan pengembangan. Inilah docker-bake.hcl yang mendemonstrasikan model ini:

 group "default" { targets = ["backend", "backend-dev"] } target "backend" { dockerfile = "backend/Dockerfile" contexts = { src = "api/src" config = "api/config" } tags = ["backend:latest"] } target "backend-dev" { inherits = ["backend"] contexts = { config = "api/config-dev" } tags = ["backend:dev"] }

Target backend-dev mewarisi semua properti dari target backend tetapi menimpa konteks config dan menerapkan tag yang berbeda.

Anda dapat melihat pratinjau struktur file yang digabungkan dengan menjalankan perintah bake dengan flag --print :

 $ docker buildx bake --print ... "backend-dev": { "context": ".", "contexts": { "config": "api/config-dev", "src": "api/src" }, "dockerfile": "backend/Dockerfile", "tags": [ "backend:dev" ] } ...

Menggunakan Target Sebelumnya sebagai Gambar Dasar

Terkadang Anda mungkin ingin target build menggunakan gambar yang dibuat oleh target sebelumnya sebagai basisnya sendiri. Ini adalah alternatif untuk pembangunan multi-tahap yang dapat digunakan ketika file Docker Anda saling bergantung tetapi tidak dapat digabungkan bersama, mungkin karena mereka ada di proyek yang berbeda.

 group "default" { targets = ["org-base-image", "api"] } target "org-base-image" { dockerfile = "docker-base/Dockerfile" tags = ["org-base-image:latest"] } target "api" { dockerfile = "api/Dockerfile" contexts = { base = "target:org-base-image" } tags = ["api:latest"] }

Contoh pertama membangun target org-base-image . Ini dapat berisi beberapa utilitas yang umum untuk beban kerja kemas organisasi Anda. Target api kemudian dibangun dengan output dari target org-base-image dapat diakses sebagai konteks build base . API Dockerfile sekarang dapat mereferensikan konten di dalam gambar dasar:

 COPY --from=base /utilities/example /usr/bin/example-utility

Ini adalah pola yang kuat yang memungkinkan Anda membuat tautan ketergantungan antara gambar sambil mempertahankan Dockerfiles terpisah.

Mengganti Properti Target pada Waktu Pembuatan

Perintah docker buildx bake memungkinkan Anda mengganti properti target saat menjalankan build:

 $ docker buildx bake --set api.dockerfile="api/Dockerfile-dev"

Contoh ini mengubah Dockerfile dari target api . Wildcard * didukung saat mengidentifikasi target yang akan diubah. * sendiri memilih setiap target sementara api* akan memodifikasi semua target yang dimulai dengan api .

Mengatur Variabel

File HCL dapat menentukan variabel yang dapat Anda rujuk dalam target build Anda. gunakan blok variable untuk mengaturnya:

 variable "TAG" { default = "latest" } group "default" { targets = ["app"] } target "app" { dockerfile = "src/Dockerfile" tags = ["my-app:${TAG}"] }

Menjalankan docker buildx bake dengan konfigurasi ini akan menandai target app sebagai my-app:latest . Anda dapat mengubah nilai variabel TAG dengan menyetel variabel lingkungan sebelum menjalankan perintah:

 $ TAG=v1 docker buildx bake

Anda dapat menggunakan semua interpolasi variabel dan kemampuan perbandingan bahasa HCL untuk membuat target build Anda dapat digunakan kembali. Fungsi juga tersedia untuk menguraikan dan mengubah nilai Anda.

Ringkasan

Buildx Buildx yang dipanggang memungkinkan Anda merangkum konfigurasi build image sebagai "target" yang ditentukan dalam file. Saat Anda menjalankan buildx bake , gambar untuk semua target yang direferensikan dibuat secara paralel.

Target dapat mewarisi dan bergantung satu sama lain. Anda juga dapat menggunakan variabel dan fungsi untuk membuat pipeline build yang sangat kompleks dan dapat dikonfigurasi.

Perintah docker buildx bake adalah operasi tingkat tinggi yang tidak diperlukan di setiap alur kerja. Anda tidak perlu menggunakannya saat membuat gambar sederhana tanpa ketergantungan lintas proyek. Menggunakan docker compose build adalah alternatif yang lebih baik untuk sebagian besar kasus penggunaan yang menyimpan konfigurasi build di file docker-compose.yml Anda. Beralih ke build yang dipanggang harus dipertimbangkan saat Anda membuat banyak gambar secara bersamaan menggunakan variabel, platform, konteks build, dan penggantian konfigurasi yang berbeda.