Lewati ke konten
AggregaAggrega
Pilih Bahasa: Bahasa Indonesia
Halaman ini diterjemahkan oleh mesin. Baca versi asli dalam bahasa Inggris.

Compose Provider

Compose provider merender Aggrega Recipes menjadi sebuah file Docker Compose. Provider ini merakit per-(path, provider): setiap kontributor compose dari setiap batas dirutekan ke perakit yang dikunci pada directory: hasil evaluasi batas tersebut yang digabungkan dengan subDirectory: per komponen, dan perakit tersebut menghasilkan satu docker-compose.yaml yang memuat setiap kontributor pada path tersebut. Dua batas bersaudara yang dievaluasi ke path yang sama dilebur menjadi satu file compose gabungan — contoh kanonisnya adalah sebuah batas induk beserta dua batas anak dengan directory: "{{ .parent_boundary.directory }}" (pola compose-bridge).

Jenis input yang didukung

Provider compose menerima ketiga jenis input Recipe:

  • Mode sourced. Sebuah Recipe dengan source: yang menunjuk ke file compose yang sudah ada serta valuesMapping: yang menghasilkan dokumen overlay. File compose dasar dimuat, overlay dievaluasi, dan keduanya digabungkan secara mendalam (deep-merge) sesuai semantik overlay bawaan docker-compose.
  • Mode Workload. Sebuah Recipe dengan workload: (inline atau dimuat melalui $import:) mendeklarasikan dokumen Workload. Provider menyintesis satu atau beberapa layanan compose dari spesifikasi Workload.
  • Mode artifacts. Entri artifacts: dari sebuah Recipe dievaluasi menjadi fragmen compose, yang digabungkan ke dalam file hasil rakitan menurut aturan di Fragmen compose yang dihasilkan artifacts. Artifacts dapat menyertai source atau Workload, dan dapat pula menjadi seluruh keluaran sebuah Recipe: Recipe yang mendeklarasikan artifacts: tanpa source: maupun workload: dirender di sini, dengan menyumbangkan apa pun yang dideklarasikan fragmennya. Dengan cara itulah komponen yang hanya berupa sumber daya — satu set jaringan dan volume bersama, konfigurasi yang sudah diisi — mencapai deployment compose tanpa Workload pengganti yang mewakili komputasi yang tidak dimilikinya.

Ketiga jenis tersebut digabungkan secara aditif, dan Recipe yang tidak mendeklarasikan satu pun di antaranya ditolak saat dimuat. valuesMapping: tanpa source: di sampingnya juga ditolak saat Recipe dimuat, provider mana pun yang disebutkannya: tidak ada yang dapat dikenai overlay, dan diagnostiknya meminta Anda mendeklarasikan penunjuk source: atau menghapus valuesMapping:.

Pemetaan fitur Workload

Ketika sebuah Recipe mendeklarasikan workload:, provider menerjemahkan bentuk Workload milik platform ke dalam primitif compose. Pemetaan ini sengaja dibuat sempit — permukaan Compose lebih miskin bentuk daripada Kubernetes, dan beberapa fitur Workload turun ke padanan compose terdekat dengan kehilangan yang terdokumentasi.

Field container

Field WorkloadField Compose
imageimage
imagePullPolicy: Always / IfNotPresent / Neverpull_policy: always / if_not_present / never
commandentrypoint (bentuk list) — field ini menimpa entry point image, dan itulah kunci compose yang melakukannya
argscommand (bentuk list) — field ini memberikan argumen yang diterima entry point, dan itulah yang ditimpa oleh command milik compose
variablesenvironment (bentuk map)
attachments[as: env]entri environment dengan nilai kosong, dan sebuah peringatan yang menyebut entri tersebut (lihat What the compose provider does not deliver)
attachments[as: file]bind-mount bentuk panjang volumes, hanya-baca
volumeMountsprimitif compose yang menjadi padanan varian Volume yang dirujuk — entri bentuk panjang volumes, entri tmpfs: tingkat service, atau referensi configs: tingkat service (lihat Volumes)
portsimplisit (container compose mengekspos port yang didengarkan image)
restartPolicy: Alwaysrestart: unless-stopped
restartPolicy: OnFailurerestart: on-failure
restartPolicy: Neverrestart: "no"

variables dan attachments[as: env] masuk ke satu map environment, entri attachment lebih dahulu dan variables sesudahnya, masing-masing dalam urutan penulisannya — urutan yang ditulis oleh helm provider, sehingga satu Workload menghasilkan satu urutan environment di setiap target. Compose tidak mengekspansi referensi $(NAME) di antara entri environment sebuah service, sehingga di compose urutan itu tidak memiliki makna saat runtime. Karena map menyimpan setiap nama sekali saja, container yang memberikan satu nama sebagai entri variables sekaligus sebagai entri attachments yang dikirim as: env menghentikan build alih-alih mempertahankan salah satu dari dua nilai itu (lihat A container gives one environment variable two values (Sebuah container memberikan dua nilai untuk satu variabel environment)).

Resource container

resources sebuah container sampai ke blok deploy.resources milik compose, yang dihormati docker compose dalam mode non-swarm. requests Kubernetes menyatakan minimum yang dijamin, sehingga menjadi reservations compose; limits menyatakan batas keras, sehingga tetap menjadi limits.

Field WorkloadField ComposeTerjemahan
resources.requests.cpudeploy.resources.reservations.cpusJumlah core desimal. Jumlah core yang ditulis sebagai angka polos (2, 0.5) dikeluarkan sebagaimana ditulis; bentuk lain dikonversi dari nilainya (500m → 0.5, 1500m → 1.5, 5n → 0.000000005, 1e1 → 10)
resources.limits.cpudeploy.resources.limits.cpusKonversi yang sama
resources.requests.memorydeploy.resources.reservations.memoryJumlah byte yang tepat, dikonversi dari nilainya dalam bentuk apa pun ia ditulis — 8Gi menjadi 8589934592, 1.5Gi menjadi 1610612736, 1e3 menjadi 1000
resources.limits.memorydeploy.resources.limits.memoryKonversi yang sama
nvidia.com/gpu, di bawah resources.limits, resources.requests, atau keduanyadeploy.resources.reservations.devicesSatu entri perangkat NVIDIA pada service container — driver: nvidia, count: jumlah GPU, capabilities: [gpu]. Jumlahnya adalah jumlah limit jika limit ditulis — jumlah yang dijadwalkan Kubernetes untuk extended resource — dan jumlah request jika tidak. Jumlah 0 tidak meminta GPU dan tidak menulis entri
kunci extended resource lainnya — amd.com/gpu dan setiap <domain>/<name> lainnya—Tidak ada padanan compose host tunggal. Kunci tersebut dibuang dan build memunculkan peringatan unsupported-field yang menyebutnya, satu per kunci yang berbeda, berapa pun banyaknya requests dan limits yang memuatnya. Nilainya tidak dikeluarkan, sehingga tidak diperiksa

Setiap nilai cpu, memory, dan nvidia.com/gpu dibaca sebagai kuantitas, dalam bentuk yang dijelaskan di Workload → Resource quantities, pada Workload sebagaimana dievaluasi oleh template Recipe. Dua hal menghentikan build dengan TRANSLATION_ERROR, dan error tersebut menyatakan mana dari keduanya yang ditemui, dengan menyebut path container, apakah nilainya request atau limit, resource-nya, dan nilainya:

  • nilai yang bukan kuantitas — lots, 1.5 cores, atau m yang ditinggalkan template kosong dalam "{{ .infra.cpu }}m";
  • kuantitas yang tidak dapat direpresentasikan compose secara tepat — jumlah negatif; jumlah memori yang bukan bilangan bulat byte (1500m, 4u) atau lebih besar dari 9223372036854775807 byte (8Ei); jumlah cpu yang lebih halus dari sembilan desimal sebuah core, presisi terhalus yang dipertahankan kuantitas Kubernetes itu sendiri, atau lebih besar dari 9223372036.854775807 core; jumlah GPU yang bukan bilangan bulat perangkat (0.5, 500m).

Container yang request dan limit nvidia.com/gpu-nya meminta jumlah berbeda dihentikan dengan cara yang sama, dengan menyebut kedua path: compose mencadangkan satu jumlah untuk sebuah service, sehingga terjemahan harus memilih salah satunya jika tidak dihentikan. Tulis jumlah yang sama di keduanya, atau hanya limit.

Tidak ada yang dibulatkan, dan tidak ada nilai yang dikeluarkan dengan makna lain.

Request GPU mencadangkan GPU NVIDIA. Container Workload yang meminta nvidia.com/gpu: "1" menghasilkan service yang memuat reservasi ini, di samping cpus dan memory yang dicadangkan oleh request-nya:

deploy:
resources:
reservations:
devices:
- driver: nvidia
count: 1
capabilities:
- gpu

Docker Compose menyerahkan GPU yang dicadangkan ke container ketika host Docker memiliki GPU NVIDIA sebanyak itu dan dikonfigurasi untuk memberikannya ke container; build tidak dapat melihat host, sehingga file yang mencadangkan GPU dirakit dengan cara yang sama di mana pun ia akan dijalankan. Entri tersebut selalu menyatakan jumlahnya, karena Compose membaca entri perangkat tanpa jumlah sebagai seluruh GPU pada host. Hanya kunci NVIDIA yang diterjemahkan: amd.com/gpu dan kunci vendor lainnya tetap mendapat peringatan dari baris kunci yang dibuang. Baris runtimeClassName di Pod-level fields tidak berubah — compose tidak memiliki padanan runtime class, sehingga Workload yang menyebut runtime berkemampuan GPU diberi tahu bahwa runtime tersebut dihilangkan, sementara jumlah GPU-nya tetap dicadangkan.

Probe

Tiga slot probe sebuah Workload (live, ready, startup) diringkas menjadi satu healthcheck per service milik compose, dengan prioritas live > ready > startup (sinyal liveness paling kanonis yang menang). Ketika peringkasan itu membuang slot yang dideklarasikan penulis, build memunculkan peringatan unsupported-field yang menyebut slot yang diterjemahkan dan slot yang dibuang, sehingga maksud yang tidak mencapai bagian mana pun dari output dilaporkan alih-alih hilang. Blok health yang mendeklarasikan satu slot diterjemahkan tanpa kehilangan dan tidak memunculkan apa pun, kecuali jika slot tersebut menetapkan successThreshold: healthcheck compose tidak memiliki field untuknya, sehingga nilai yang ditulis — termasuk 1 — dihilangkan dengan peringatan unsupported-field yang menyebutnya (containers.<name>.health.<slot>.successThreshold), dan bagian slot lainnya diterjemahkan seperti yang ditunjukkan tabel di bawah.

Bentuk probe Workloadhealthcheck.test Compose
http: /path["CMD-SHELL", "curl -f http://localhost:<port>/path || exit 1"]
tcp: <port>["CMD-SHELL", "nc -z localhost <port>"]
exec: [cmd, ...]["CMD", cmd, ...]

Bentuk HTTP mengharuskan container mendeklarasikan setidaknya satu port bernama; synthesizer memilih nama port pertama menurut abjad dan menggunakan nomornya untuk membangun URL curl. Container tanpa port yang dideklarasikan tidak dapat menggunakan probe HTTP — compiler berhenti dengan TRANSLATION_ERROR yang menyebut probe yang bermasalah.

Field timeout probe dipetakan ke string durasi bergaya compose:

Field WorkloadField healthcheck Compose
periodSecondsinterval: <n>s
timeoutSecondstimeout: <n>s
failureThresholdretries: <n>
initialDelaySecondsstart_period: <n>s

Volume

Compose memiliki primitif config sendiri, dan itulah hasil terjemahan volume configmap. Compose tidak memiliki padanan Kubernetes untuk Secret atau templat volume per replika, sehingga varian-varian tersebut diturunkan ke primitif compose yang paling dekat:

Varian volume WorkloadTerjemahan ComposeCatatan kehilangan
ephemeralentri daftar tmpfs: di tingkat layanansizeLimit tidak dipertahankan (bentuk singkat tmpfs compose tidak memiliki ukuran). sizeLimit yang ditulis memunculkan peringatan unsupported-field yang menyebutkannya pada koordinat penulisannya (volumes.<name>.ephemeral.sizeLimit), baik ada maupun tidak ada kontainer yang memasang volume tersebut; menghilangkan bidang ini tidak memunculkan apa pun
configmapreferensi configs: di tingkat layanan yang menyebutkan configmap, dipasang pada path pemasangan volume🔴 Path pemasangan adalah path sebuah file tunggal, bukan direktori. Compose menulis konten config tepat ke path target, sedangkan target Kubernetes yang memasang ConfigMap pada suatu path menghasilkan direktori berisi satu file per kunci. Jadi path: yang sama berarti sebuah file di sini dan sebuah direktori di sana: arahkan pemasangan volume configmap ke nama file yang harus dibaca kontainer (/seed/config.json), bukan ke direktori yang akan memuatnya, dan Recipe yang ditulis untuk kedua target membawa path yang berbeda per target. Tidak ada bagian build yang dapat mendeteksi path yang ditulis untuk bentuk target lain — path adalah string buram yang diteruskan oleh compiler, dan keluaran yang dihasilkan valid dalam kedua kasus. Referensi dilakukan berdasarkan nama, persis seperti target Kubernetes mereferensikan resource ConfigMap — tidak ada yang membaca konten config. Entri configs: tingkat atas yang sesuai berasal dari masukan artifacts: milik Recipe, yang fragmen compose-nya mendeklarasikannya dengan content: inline; referensi tanpa entri tersebut menghentikan build (lihat Fragmen compose yang dihasilkan artifacts). Referensi configs: hanya membawa nama config dan path pemasangan, sehingga readOnly pada pemasangan tidak memiliki ekspresi tersendiri
secretbind-mount bentuk panjang volumes, hanya-bacaVolume secret sengaja tidak mengikuti terjemahan configmap: entri configs: inline akan menulis nilai secret ke dalam file compose yang dihasilkan dalam bentuk teks biasa, dan compiler tidak pernah menguraikan secret menjadi teks biasa — secret tetap berupa penunjuk di setiap tahap build. Sumber bind adalah nama source milik secret, yang diuraikan sebagai path yang dibuat dapat dijangkau oleh operator di host compose secara terpisah dari build
persistentvolume bernama + deklarasi volumes: { <volume-name>: {} } tingkat atas, dinamai sesuai Cara nama volume diturunkanKelas penyimpanan, mode akses, dan ukuran tidak dipertahankan (compose tidak memiliki bentuk yang setara). class atau accessModes yang ditulis memunculkan peringatan unsupported-field yang menyebutkannya pada koordinat tempat ia ditulis (volumes.<name>.persistent.class, volumes.<name>.persistent.accessModes); menghilangkan salah satunya tidak memunculkan apa pun. size yang wajib tidak memunculkan peringatan — lihat di bawah
persistentTemplatevolume bernama + deklarasi tingkat atas, dinamai dengan cara yang sama (sama seperti persistent)Pendamping form: stateful; compose tidak memiliki primitif templat volume per replika, sehingga perilaku per replika hilang, dan peringatan unsupported-field menyatakan bahwa volume tersebut menjadi satu volume yang digunakan bersama oleh setiap replika. Kelas penyimpanan, mode akses, dan ukuran tidak dipertahankan, persis seperti untuk persistent: class atau accessModes yang ditulis memunculkan peringatan unsupported-field di volumes.<name>.persistentTemplate.class atau volumes.<name>.persistentTemplate.accessModes, dan size yang wajib tidak memunculkan peringatan apa pun

subPath pada sebuah mount memasang sebagian volume jika compose memiliki bentuk untuknya. Entri volumeMounts yang menyebut volume persistent atau persistentTemplate dengan subPath menjadi entri volumes bentuk panjang yang membawa volume.subpath, sehingga mount melihat direktori atau file yang disebut di dalam volume, bukan akarnya, dan dua mount dari satu volume dengan dua nilai subPath yang berbeda melihat dua bagian volume yang berbeda:

volumes:
- type: volume
source: store--data
target: /var/lib/app/db
volume:
subpath: db
- type: volume
source: store--data
target: /var/lib/app/uploads
volume:
subpath: uploads

Mount yang ditulis tanpa subPath tidak membawa blok volume:. subPath pada mount volume ephemeral, configmap, atau secret menghentikan build dengan TRANSLATION_ERROR yang menyebut komponen, container, path mount yang ditulis (containers.<name>.volumeMounts[<i>]), volume, dan subPath: varian-varian tersebut sampai ke compose sebagai entri tmpfs, referensi configs:, dan bind mount, yang tidak satu pun memasang sebagian dari apa yang dikirimkannya, sehingga jika tidak dihentikan, mount akan melihat seluruh volume. Hapus subPath dari mount semacam itu, atau pasang volume persistent. Docker Compose membaca volume.subpath mulai rilis 2.26.0, pada Docker Engine 26.0 atau lebih baru; build tidak dapat melihat host yang akan menjalankan file, sehingga file yang membawanya dirakit dengan cara yang sama di mana pun file itu dijalankan.

Volume hanya menyatakan variannya, tidak lebih. Volume secret memiliki tepat satu terjemahan — bind mount hanya-baca di atas — dan volume tidak memiliki bidang as: untuk memilih terjemahan lain. Menyampaikan apa yang dipublikasikan sebuah slot sebagai variabel lingkungan dilakukan dengan entri attachments kontainer (as: env), bukan volume; apa yang dilakukan compose terhadapnya dijelaskan di Apa yang tidak disediakan provider compose.

Tiga varian membawa ukuran penyimpanan, dan hanya satu yang memperingatkan bahwa ukuran tersebut dibuang. Perbedaannya terletak pada apakah Anda memiliki pilihan. sizeLimit pada volume ephemeral bersifat opsional, sehingga menuliskannya adalah sebuah keputusan, dan peringatan memberi tahu Anda bahwa nilai tersebut tidak membentuk apa pun pada target ini dan dapat dihapus — peringatan ini bersifat saran dan di luar keluaran, file yang dihasilkan identik byte demi byte dengan file tanpanya, dan --no-unsupported-field-warnings membungkamnya bersama seluruh kelasnya. size pada volume persistent atau persistentTemplate wajib diisi, sehingga tidak ada versi dokumen yang menghilangkannya: peringatan per build di sana akan muncul pada setiap workload stateful tanpa menyebutkan apa pun yang dapat Anda ubah, sehingga perbedaannya dijelaskan di sini alih-alih dilaporkan pada setiap build. Saat menargetkan compose, size, class, dan accessModes pada volume persisten tidak membentuk apa pun di file yang dihasilkan — yang Anda dapatkan adalah volume bernama biasa, dengan ukuran dan backing sesuai bawaan driver volume host compose. class dan accessModes bersifat opsional, sehingga masing-masing yang Anda tulis dilaporkan seperti sizeLimit pada volume ephemeral: satu peringatan unsupported-field per bidang, bersifat saran dan di luar keluaran, dibungkam oleh flag yang sama. Tentukan ukuran penyimpanan dasar di host, atau pada target Kubernetes tempat bidang-bidang tersebut benar-benar mencapai keluaran.

Volume yang tidak dipasang oleh kontainer mana pun memunculkan peringatan unsupported-field yang menyebutkannya pada koordinat penulisannya (volumes.<name>), karena apa yang mencapai file yang dihasilkan sangat berbeda menurut varian. persistent dan persistentTemplate tetap menghasilkan deklarasi tingkat atasnya, sehingga volume dibuat tetapi tidak digunakan. ephemeral, configmap, dan secret tidak memiliki ekspresi di luar pemasangan itu sendiri — masing-masing diterjemahkan menjadi sesuatu yang ditulis pada path pemasangan, berturut-turut entri tmpfs, referensi configs, atau bind-mount — sehingga tanpa ada yang memasangnya, volume yang Anda deklarasikan tidak meninggalkan jejak sama sekali di keluaran. Kasus kedua itulah alasan peringatan ini ada: tanpanya, volume configmap yang pemasangannya terlupa akan begitu saja tidak ada, tanpa apa pun di file yang dihasilkan untuk diperhatikan. Setiap kontainer dalam workload dihitung sebagai pemasang, termasuk kontainer init, sehingga volume yang hanya dipasang oleh kontainer init sudah terhubung dan tidak memunculkan apa pun. Peringatan ini bersifat saran dan di luar keluaran — file yang dihasilkan identik byte demi byte dengan file tanpanya — dan --no-unsupported-field-warnings membungkam kelasnya.

Cara nama volume diturunkan

Volume persistent atau persistentTemplate menjadi volume bernama compose: satu entri volumes: tingkat atas, yang dirujuk oleh setiap kontainer yang me-mount-nya. Volume compose adalah penyimpanan bersama, dan blok volumes: tingkat atas menyatukan entri-entrinya berdasarkan nama — sehingga dua volume yang ditulis dan berakhir pada satu nama menjadi satu volume yang ditulisi oleh kedua kontainer, tanpa ada apa pun dalam file yang dihasilkan yang menunjukkan bahwa yang dimaksud adalah dua. Oleh karena itu, nama dibangun dari dua identitas yang bersama-sama menyatakan volume mana itu: <component> tempat volume tersebut berada, dan nama yang diberikan Workload kepada volume di bawah volumes:.

Nama volume compose menerima himpunan karakter yang lebih sempit daripada yang dapat dimuat oleh kedua identitas: huruf, digit, titik, garis bawah, dan tanda hubung. Alih-alih mengganti karakter yang tidak diterima compose, penurunan nama menuliskannya secara eksplisit, sehingga dua volume yang berbeda sedikit pun berakhir pada dua nama — dan nama yang telah dirakit dapat dibaca kembali menjadi dua identitas asal pembentukannya.

  • Huruf, digit, titik, dan garis bawah diteruskan persis seperti yang ditulis.
  • Tanda hubung dipertahankan seperti yang ditulis di mana pun karakter sesudahnya diteruskan secara langsung dan bukan huruf kecil z. Tanda hubung yang diikuti huruf kecil z membuka escape, sehingga tanda hubung yang ditulis pada posisi itu sendiri dituliskan secara eksplisit — api-zone menjadi api-zhzone, yang memungkinkan nama apa pun dibaca kembali tanpa menebak. Tanda hubung yang tidak diikuti apa pun dituliskan secara eksplisit dengan alasan yang sama, sehingga db- menghasilkan db-zh.
  • Setiap karakter lain ditulis sebagai -z diikuti huruf yang menamainya: s untuk pemisah path, h untuk tanda hubung yang tidak dipertahankan oleh aturan di atas. Selain itu — termasuk spasi dan huruf non-ASCII — ditulis sebagai x diikuti code point heksadesimal enam digit dari karakter tersebut, dan byte yang tidak mengawali karakter apa pun ditulis sebagai b diikuti nilainya sendiri dalam dua digit, sehingga nama yang bukan teks valid tetap dituliskan secara berbeda alih-alih digabungkan.
  • Nilai kosong ditulis -ze, yang tidak dapat dihasilkan oleh nilai tidak kosong mana pun.
  • Kedua identitas digabungkan dengan --. Satu identitas yang telah dienkode tidak pernah memuat pasangan itu, sehingga nama gabungan menyatakan tanpa ambiguitas di mana satu identitas berakhir dan yang lain dimulai.

Jadi, komponen store dengan volume yang oleh Workload dinamai data menghasilkan nama volume store--data, dan db-server dengan data menghasilkan db-server--data. Input yang identik selalu menghasilkan nama yang identik.

Penggabung ganda inilah yang membuat pasangan tersebut tidak ambigu, dan penggabung satu karakter tidak dapat melakukannya. Kedua identitas dapat memuat tanda hubung, sehingga penggabung satu tanda hubung menghasilkan nama yang dapat dibagi di lebih dari satu tempat: db dengan volume bernama data-cache dan db-data dengan volume bernama cache sama-sama akan dieja db-data-cache, dan karena blok tingkat atas menyatukan berdasarkan nama, kedua komponen akan berbagi satu volume tanpa ada apa pun dalam file yang dihasilkan yang menunjukkannya. Identitas yang telah dienkode tidak pernah memuat sepasang tanda hubung, sehingga penggabung ganda tidak memungkinkan pembacaan kedua: keduanya menjadi db--data-cache dan db-data--cache.

Mengubah salah satu identitas akan mengganti nama volume compose, dan compose tidak mengganti nama volume di tempat. Volume dibuat baru dengan nama baru sementara volume lama tetap tertinggal beserta datanya, sehingga kontainer berjalan dengan penyimpanan kosong dan isinya berada di volume yang tidak di-mount oleh apa pun. Ganti nama salah satu identitas hanya sebagai penggantian yang direncanakan — dicadangkan, disalin, atau dijadwalkan — bukan sebagai perubahan yang langsung diluncurkan.

Bentuk controller

form pada Workload memilih bentuk controller abstrak (lihat entities/workload.md). Compose merender stateless dan stateful (serta default kosong, yang diperlakukan sebagai stateless) sebagai layanan yang berjalan lama; bentuk stateful menambahkan volume bernama untuk pendamping persistentTemplate. Bentuk daemon, scheduled, dan task tidak memiliki pemetaan compose host tunggal yang bersih, sehingga Workload yang mendeklarasikan salah satunya dengan target boundary compose akan berhenti dengan TRANSLATION_ERROR yang menyebutkan bentuk tersebut dan himpunan yang didukung — compose tidak menurunkan bentuk yang tidak didukung menjadi layanan biasa yang salah merepresentasikan maksudnya. Workload reference mendeklarasikan endpoint eksternal dan tidak memiliki container, sehingga compose tidak menghasilkan layanan untuknya.

Karena tidak ada layanan yang dihasilkan untuk Workload reference, tidak ada yang membaca pipa pengiriman komponen yang direalisasikannya: kredensial yang dilampirkan ke komponen tersebut — yang dikirim di pipanya oleh dotenv-secret, atau oleh blok inject: milik attachment itu sendiri — tidak akan sampai ke file keluaran mana pun. Karena itu, setiap Compose Recipe pustaka standar yang merealisasikan layanan eksternal dengan cara ini, dan yang Component-nya mendeklarasikan slot kredensial, menolak kredensial yang mengisi slot tersebut: build berhenti dengan menyebut slot dan komponennya, alih-alih berhasil tanpa kredensial. Pada compose, kredensial untuk layanan eksternal dilampirkan ke komponen yang memanggilnya, di bawah variabel lingkungan yang dibaca komponen tersebut. Penolakan itu adalah asersi milik masing-masing Recipe, dan dijalankan sebelum provider ini merender apa pun. Provider ini juga menolak di node itu sendiri, dari katalog mana pun Recipe tersebut berasal: attachment pada node reference yang materialnya dideklarasikan sensitif — Feature-nya mendeklarasikan sebuah field sensitive: true, atau slot yang diisinya mendeklarasikannya — menghentikan build dengan TRANSLATION_ERROR (E0288), menyebut node dan setiap attachment semacam itu, terlepas dari ada atau tidaknya slot yang mendeklarasikan nama yang digunakan untuk melampirkannya. Attachment yang tidak membawa apa pun yang dideklarasikan sensitif tidak ditolak di sini. Components tersebut mendeklarasikan slot kredensialnya sebagai opsional, sehingga pada compose slot yang dibiarkan kosong tidak menghentikan apa pun. Jika realisasi Kubernetes memerlukan kredensial — Recipes helm untuk twilio, vonage, telnyx, bland, letta, retell, dan vapi — Recipe tersebut justru mewajibkan slot itu, dan menghentikan build dengan menyebutnya ketika kosong.

Eksposur layanan

Field type pada entri services Workload menentukan apakah compose memublikasikan port, dan pada alamat host mana:

Tipe layanan WorkloadPerilaku compose
ClusterIPTidak ada publikasi ports: — layanan hanya dapat dijangkau di jaringan compose
NodePortPublikasi ports: [<host>:<container>], pada setiap antarmuka host
LoadBalancerPublikasi ports: [<host>:<container>], pada setiap antarmuka host (compose tidak memiliki padanan load balancer terkelola; publikasi port host adalah analog terdekat)
LoopbackPublikasi ports: [127.0.0.1:<host>:<container>] — dapat dijangkau dari host itu sendiri dan tidak dari tempat lain
HeadlessTidak ada publikasi ports:

Nomor mana di sisi mana. Entri layanan menyebut port kontainer dan memberinya nomor, sebagaimana Service Kubernetes memetakan port-nya ke targetPort. Nomor entri adalah sisi <host> dari pasangan yang dipublikasikan, dan nomor port kontainer yang menjadi hasil resolusi nama tersebut adalah sisi <container>. Jadi kontainer yang mendeklarasikan http: 8080 dan entri NodePort yang menulis http: 8081 memublikasikan 8081:8080: port 8081 milik host mencapai port tempat kontainer melayani. Entri yang membawa nomor port kontainer itu sendiri memublikasikan nomor tersebut di kedua sisi, 8080:8080. Rekan di jaringan compose menjangkau layanan berdasarkan nama layanannya pada port kontainer, tidak pernah pada port yang dipublikasikan — port yang dipublikasikan adalah milik host — sehingga Recipe yang memublikasikan port pilihannya sendiri tetap menyerahkan port kontainer kepada konsumennya.

Entri Loopback hanya mengikat alamat loopback IPv4. Alamat loopback IPv6 ::1 tidak diikat: sintaks port compose memuat satu alamat host per entri, dan host yang antarmuka loopback-nya tidak memiliki alamat IPv6 tidak dapat mengikatnya, sehingga layanan tidak akan berjalan di sana. Klien di host menjangkau port tersebut di 127.0.0.1.

Ketika beberapa layanan pada satu Workload memublikasikan port kontainer yang sama dengan nomor yang sama, port tersebut dipublikasikan sekali, dan jangkauan terluas yang berlaku: rujukan NodePort atau LoadBalancer mana pun memublikasikannya pada setiap antarmuka host, bahkan jika entri Loopback juga menyebutkannya dan entri mana pun yang dideklarasikan lebih dulu; port yang hanya disebutkan oleh entri Loopback dipublikasikan di 127.0.0.1. Satu port kontainer yang dipublikasikan dengan dua nomor dipublikasikan dua kali, sekali untuk masing-masing nomor. Port yang dipublikasikan dicantumkan dalam urutan port kontainer, dan berdasarkan port yang dipublikasikan dalam satu port kontainer.

Transport port. Entri yang dipublikasikan membawa transport yang dideklarasikan pada port kontainer yang disebutkannya, sebagai sufiks /protocol compose: 53:53/udp, atau 127.0.0.1:53:53/udp untuk entri Loopback. Port yang tidak mendeklarasikan transport dipublikasikan sebagai <host>:<container> tanpa sufiks, sehingga default compose sendiri tetap berlaku. Compose mengeja transport port yang dipublikasikan sebagai tcp atau udp; port yang mendeklarasikan SCTP tidak memiliki ejaan compose, sehingga berhenti dengan TRANSLATION_ERROR alih-alih memublikasikan port yang akan membawa transport yang berbeda. Port kontainer yang tidak dipublikasikan oleh layanan mana pun sama sekali tidak mencapai bagian mana pun dari file compose, sehingga transport yang dideklarasikan pada port semacam itu tidak memiliki tempat untuk dieja dan tidak menyebabkan penghentian.

Workloads multi-container

Workload dengan beberapa container menjadi satu layanan utama ditambah satu layanan sidecar untuk setiap container non-utama. Container utama adalah container bernama main (jika ada) atau container pertama dalam urutan deklarasi. Sidecar berbagi namespace jaringan layanan utama melalui network_mode: "service:<main>" — primitif compose yang paling mendekati model jaringan bersama pada pod Kubernetes.

Cara layanan sidecar atau init diberi nama

Layanan utama membawa nama <component> apa adanya. Setiap layanan lain yang dihasilkan Workload — satu per sidecar, dan satu per kontainer init — dinamai dari dua identitas sekaligus: <component>, dan nama kontainer, yaitu kuncinya di bawah containers: untuk sidecar dan nilai name miliknya untuk kontainer init, atau init-<index> posisional yang diambil oleh entri init tanpa nama. Blok services: yang dirakit memuat satu layanan per nama, sehingga nama itu dibangun sedemikian rupa agar dua kontainer yang berbeda pada salah satu identitas selalu menghasilkan dua nama.

Setiap identitas ditulis persis seperti dua bagian dari sebuah nama volume — huruf, angka, titik, dan garis bawah sebagaimana ditulis, tanda hubung dipertahankan di tempat aturan di sana mempertahankannya, dan setiap karakter lain ditulis ulang — dan keduanya digabungkan dengan --, yang tidak terdapat dalam identitas tertulis ulang mana pun. Jadi komponen api dengan sidecar logger menjalankannya sebagai api--logger, kontainer init import-seed milik platform berjalan sebagai platform--import-seed, dan entri init pertama tanpa nama milik api berjalan sebagai api--init-0. Nama kontainer yang memuat karakter yang tidak diterima nama layanan ditulis ulang alih-alih dikeluarkan sebagaimana ditulis: kontainer init bernama warm cache/x milik api berjalan sebagai api--warm-zx000020cache-zsx.

Penggabungan ganda menjaga kontainer dari dua komponen tetap terpisah. api dengan kontainer warm-cache dan api-warm dengan kontainer cache berjalan sebagai api--warm-cache dan api-warm--cache, dua layanan, sedangkan penggabungan dengan satu tanda hubung akan mengeja keduanya sebagai api-warm-cache.

Sidecar dan kontainer init berbagi satu penamaan ini, sehingga entri containers dan entri initContainers yang memiliki nama yang sama menghasilkan nama layanan yang sama, dan build berhenti pada pasangan itu alih-alih menjalankan satu kontainer sebagai pengganti yang lain (lihat Init container).

Layanan milik komponen itu sendiri tidak mengambil salah satu nama ini. Layanan utama dinamai menurut komponennya, dan tanda hubung ganda yang ditulis dalam nama komponen juga ditulis ulang di sana — komponen bernama api--prep berjalan sebagai api-zh-prep — sehingga nama itu tidak pernah memuat penggabungan --. Jika layanan dari dua komponen berbeda tetap bertemu pada satu nama dalam satu berkas compose — misalnya melalui layanan yang dinamai sendiri oleh sebuah artefak — build berhenti dengan menyebutkan keduanya, sebagaimana dijelaskan dalam Keluaran per (path, provider).

Mengubah nama komponen atau nama kontainer akan mengganti nama layanan. Compose memperlakukan layanan dengan nama baru sebagai layanan baru, sehingga kontainernya dibuat ulang dari awal dengan nama baru.

Field tingkat pod

Field Workload tingkat pod hanya diterapkan pada layanan utama — sidecar berbagi namespace jaringan milik layanan utama — dan layanan init mengikuti aturan yang sama. Satu-satunya pengecualian adalah pengguna pod: pod menjalankan setiap container-nya sebagai podSecurityContext.runAsUser dan runAsGroup, sehingga keduanya mencapai setiap layanan yang dihasilkan Workload, termasuk layanan sidecar dan init.

Beberapa di antaranya dipetakan ke field layanan compose:

Field WorkloadField Compose
podSecurityContext.runAsUser / runAsGroupuser ("1000", atau 1000:3000 dengan grup) pada setiap layanan Workload. Container yang menetapkan securityContext.runAsUser miliknya sendiri berjalan sebagai pengguna tersebut pada layanannya sendiri, dengan runAsGroup miliknya sendiri jika ia menetapkannya
terminationGracePeriodSecondsstop_grace_period: <n>s
dnsConfig.nameservers / dnsConfig.searchesdns / dns_search
hostAliasessatu entri extra_hosts per hostname, sesuai urutan penulisan
hostNetwork: truenetwork_mode: host

Berjalan di jaringan node. Workload yang mendeklarasikan hostNetwork: true mendapatkan network_mode: host pada layanannya sendiri, dan layanan tersebut kemudian tidak dimasukkan ke jaringan boundary alih-alih dilampirkan padanya: compose menolak layanan yang mendeklarasikan networks: sekaligus network_mode:, sehingga keduanya merupakan alternatif, bukan tambahan. Konsekuensi praktisnya adalah yang selalu menyertai jaringan host — peer tidak lagi menjangkau layanan tersebut melalui nama layanan compose-nya di jaringan itu, karena layanan tersebut tidak lagi berada di sana; mereka menjangkaunya di alamat host itu sendiri, sesuai yang diminta oleh deklarasi tersebut. Layanan lain di boundary tidak terpengaruh.

Dua bentuk dapat dipadukan dengannya. Sidecar tetap merujuk layanan utama (network_mode: "service:<main>"), sehingga sidecar mengikuti layanan utama ke jaringan host tanpa mendeklarasikan apa pun sendiri — sama seperti container dalam pod Kubernetes berbagi satu namespace. Layanan init tidak demikian: layanan init bergabung ke jaringan boundary secara mandiri, karena berbagi namespace layanan utama akan membuat penantian layanan utama terhadapnya menjadi melingkar. Jadi, workload dengan hostNetwork dan initContainers sekaligus menjalankan layanannya sendiri di jaringan host sementara layanan init-nya tetap di jaringan boundary, yang lebih sempit daripada bentuk pod yang dimodelkannya; peringatan unsupported-field menyebutkan perbedaan tersebut alih-alih membiarkannya ditemukan saat runtime.

Sisanya tidak memiliki padanan host tunggal. Tidak ada yang dibuang secara diam-diam: setiap field yang ditulis memunculkan peringatan unsupported-field yang menyebutkan field tersebut, sehingga penulis mengetahui pengaturan mana yang tidak dapat dipenuhi target alih-alih menemukannya dari stack yang sedang berjalan.

Field WorkloadMengapa compose tidak dapat memenuhinya
schedulingPenempatan — nodeSelector, affinity, tolerations, topologySpreadConstraints — mengandaikan adanya scheduler yang memilih di antara node. Compose berjalan di satu host
replicasJumlah replika milik compose sendiri berada di bawah deploy: dan merupakan fitur mode swarm
runtimeClassNamePemilihan runtime container alternatif — misalnya yang mendukung GPU — tidak memiliki ekspresi di compose
priorityClassNameUrutan preemption mengandaikan adanya scheduler
serviceAccountIdentitas Workload adalah konsep klaster
imagePullSecretsKredensial registry pada host compose adalah status login host itu sendiri, bukan field dalam file
dnsPolicy, dnsConfig.optionsCompose menyediakan dns dan dns_search dan tidak ada yang lebih rinci
podSecurityContext.fsGroup, podSecurityContext.supplementalGroupsuser membawa satu pengguna dan satu grup; grup pemilik volume pod, dan grup tambahan untuk prosesnya, tidak diterjemahkan
podSecurityContext.runAsGroup, jika pod tidak menetapkan runAsUser, atau jika sebuah container — utama, sidecar, atau init — menetapkan runAsUser miliknya sendiri tanpa runAsGroupuser hanya menyebut grup di samping pengguna, dan pengguna milik container sendiri menggantikan pengguna pod, sehingga grup pod tidak mencapai layanan mana pun yang ditulis dengan cara itu

securityContext tingkat container diterjemahkan sebagian: readOnlyRootFilesystem → read_only, capabilities.add / drop → cap_add / cap_drop, runAsUser / runAsGroup → user. runAsNonRoot dan allowPrivilegeEscalation tidak memiliki ekspresi di compose dan memunculkan peringatan unsupported-field yang sama, demikian pula runAsGroup container yang ditulis tanpa runAsUser di sampingnya: layanan tersebut lalu berjalan sebagai pengguna pod jika pod menetapkannya, tanpa grup itu.

Setiap peringatan di bagian ini bersifat anjuran dan di luar jalur utama: build berhasil, dan file yang dihasilkan identik byte demi byte dengan file tanpa peringatan tersebut. --no-unsupported-field-warnings membungkam kelas peringatan ini.

Init container

Entri initContainers milik sebuah Workload menjadi layanan tersendiri, menggunakan idiom run-to-completion milik compose. Setiap entri menambahkan satu layanan, yang dinamai dari <component> dan name milik entri melalui penamaan yang sama dengan yang digunakan sidecar — <component>--<container-name> untuk nama biasa; entri yang tidak menyertakan name mendapat nama posisional init-<index> yang didokumentasikan dalam referensi Workload, dan dinamai dari nama itu.

Urutan yang dijanjikan oleh kontrak penulisan — init container berjalan hingga selesai sesuai urutan penulisannya, dan setiap container lain baru dimulai setelah semuanya selesai — dinyatakan dengan bentuk panjang depends_on:

  • Setiap layanan init setelah yang pertama menunggu pendahulunya dengan condition: service_completed_successfully.
  • Layanan utama, dan setiap layanan sidecar, menunggu layanan init terakhir dengan kondisi yang sama. Menunggu yang terakhir sudah cukup karena layanan-layanan init membentuk rantai.
  • Setiap layanan init membawa restart: "no". Layanan init dijalankan sekali; layanan yang menyala kembali tidak akan pernah mencapai status selesai yang ditunggu oleh dependennya, sehingga restartPolicy yang ditulis pada init container tidak mengubah hal ini.
services:
platform:
image: platform:1.0
depends_on:
platform--verify-seed:
condition: service_completed_successfully
platform--import-seed:
image: platform:1.0
restart: "no"
platform--verify-seed:
image: platform:1.0
depends_on:
platform--import-seed:
condition: service_completed_successfully
restart: "no"

Init container diterjemahkan persis seperti container lainnya: image (termasuk penulisan ulang registry yang diterapkan anotasi aggrega.ai/image-registry), command, args, variables, attachments, volumeMounts, dan securityContext miliknya semuanya sampai ke layanan init. Hal inilah yang membuat konfigurasi yang dibawa init container — paling sering berupa file yang di-mount dan ditulisnya ke volume yang juga di-mount oleh container utama — tetap bertahan pada target compose alih-alih hilang bersama container. Bentuk yang tidak dapat dinyatakan compose gagal dengan cara yang sama bagi init container seperti bagi container biasa: lifecycle atau envFrom yang dideklarasikan akan berhenti dengan TRANSLATION_ERROR yang menyebutkan init container asalnya.

Dua perbedaan dari layanan utama muncul karena layanan init adalah layanan non-utama:

  • Field Workload tingkat pod tidak diterapkan, aturan yang sama yang diikuti sidecar — kecuali pengguna pod, yang mencapai setiap layanan seperti dijelaskan dalam Field tingkat pod.
  • Layanan init bergabung langsung ke jaringan boundary-nya alih-alih berbagi namespace jaringan layanan utama seperti yang dilakukan sidecar. Hal ini harus demikian: layanan utama menunggu layanan init, dan berbagi namespace itu sendiri merupakan dependensi pada layanan utama, yang akan menutup penantian tersebut menjadi siklus yang ditolak compose untuk dijalankan. Karena itu, init container menjangkau layanan lain pada jaringan boundary melalui nama layanan, tetapi tidak berbagi localhost milik layanan utama.

Layanan init dan layanan sidecar berbagi satu namespace nama, karena satu penamaan menamai keduanya, sehingga entri initContainers dan entri containers tidak boleh memiliki nama yang sama. Jika demikian, compiler berhenti dengan TRANSLATION_ERROR yang menyebutkan node, nama container, dan nama layanan yang diinginkan keduanya, alih-alih membiarkan satu layanan diam-diam menggantikan yang lain.

Menghasilkan kondisi penyelesaian tidak menaikkan versi minimum Compose. condition dan nilainya termasuk dalam Compose Specification dasar — tidak seperti field restart dan required di sampingnya dalam blok bentuk panjang yang sama, yang dikaitkan spesifikasi dengan rilis Compose tertentu. Setiap versi minimum yang diminta keluaran provider compose datang bersama konstruksi yang membutuhkannya: ≥ 2.23.1 untuk configs.content inline, ≥ 2.26.0 untuk subPath sebuah mount (lihat Volume), dan 2.38 untuk model. Yang pertama berlaku bagi setiap keluaran compose yang membawa config dengan content: inline, yang merupakan cara tibanya file di balik volume configmap maupun config di balik edge lintas jaringan yang dijembatani — bukan satu jalur penulisan saja.

Jaringan yang diikuti sebuah layanan

Setiap layanan bergabung ke sebuah jaringan Docker; sidecar mewarisinya melalui referensi network_mode mereka ke layanan utama. Jaringan tempat sebuah node berada dibaca dari anotasi aggrega.ai/namespace pada node tersebut, dengan path file compose sebagai cadangan apabila node tidak memiliki anotasi tersebut — yaitu direktori tempat file ditulis di bawah direktori output build, seperti bridge/compose untuk boundary yang directory:-nya adalah bridge. Jadi setiap node tanpa anotasi dalam satu file compose bergabung ke satu jaringan yang dinamai menurut path file tersebut, di boundary mana pun node itu berada: boundary tanpa anotasi yang berbagi satu file compose berbagi jaringan itu, dan aggrega.ai/namespace adalah yang memisahkan mereka. Node yang memiliki anotasi berbeda ditempatkan pada satu jaringan per anotasi yang berbeda. Cara nama jaringan diturunkan adalah nama yang dihasilkan oleh identitas tersebut.

Cara nama jaringan diturunkan

Jaringan compose adalah konektivitas L3 bersama, dan blok tingkat atas networks: menggabungkan entri-entrinya berdasarkan nama — sehingga dua identitas yang menghasilkan satu nama menjadi satu jaringan tempat kedua kelompok layanan berada, saling menjangkau melalui nama layanan, tanpa ada apa pun dalam berkas yang dihasilkan yang menunjukkan bahwa yang dimaksud adalah dua jaringan. Oleh karena itu, nama dibangun dari identitas yang menyatakan jaringan mana yang dimaksud: anotasi aggrega.ai/namespace milik node, atau path file compose apabila node tidak memilikinya.

Nama jaringan compose menerima himpunan karakter yang lebih sempit daripada yang dapat dimuat oleh kedua identitas tersebut: huruf, angka, titik, garis bawah, dan tanda hubung. Alih-alih mengganti karakter yang tidak diterima compose, penurunan nama menuliskannya secara eksplisit, sehingga dua identitas yang berbeda sedikit pun menghasilkan dua jaringan — dan sebuah nama dapat dibaca kembali menjadi identitas asal pembentukannya.

  • Huruf, angka, titik, dan garis bawah diteruskan persis seperti yang ditulis, dalam huruf besar atau kecil sesuai penulisannya. Jadi prod dan Prod adalah dua jaringan, bukan satu.
  • Tanda hubung dipertahankan seperti yang ditulis di mana pun karakter sesudahnya diteruskan secara langsung dan bukan huruf kecil z. Tanda hubung yang diikuti huruf kecil z membuka escape, sehingga tanda hubung yang ditulis pada posisi itu sendiri dituliskan secara eksplisit — api-zone menjadi api-zhzone, yang memungkinkan nama apa pun dibaca kembali tanpa menebak. Tanda hubung yang tidak diikuti apa pun dituliskan secara eksplisit dengan alasan yang sama, sehingga db- menghasilkan db-zh.
  • Setiap karakter lainnya ditulis sebagai -z diikuti huruf yang menamainya: s untuk pemisah jalur, h untuk tanda hubung yang tidak dipertahankan oleh aturan di atas. Selain itu — termasuk spasi dan huruf non-ASCII — ditulis sebagai x diikuti titik kode heksadesimal enam digit dari karakter tersebut, dan byte yang tidak mengawali karakter apa pun sebagai b diikuti nilai dua digitnya sendiri, sehingga identitas yang bukan teks valid tetap dituliskan secara berbeda alih-alih diciutkan.
  • Identitas yang sama sekali tidak ada — node tanpa anotasi aggrega.ai/namespace dalam file compose tanpa path — ditulis -ze, yang tidak dapat dihasilkan oleh identitas apa pun yang ditulis penulis. Oleh karena itu, jaringan tanpa identitas tidak pernah berbagi konektivitas dengan jaringan yang identitasnya dieja dengan cara tertentu.

Jadi namespace prod menghasilkan jaringan prod, core-net menghasilkan core-net, dan file compose di dist/app/compose menghasilkan dist-zsapp-zscompose. Masukan yang identik selalu menghasilkan nama yang identik.

Namespace dan path file compose dituliskan ke dalam ruang yang sama. Keduanya adalah dua cara menamai hal yang sama — jaringan tempat sebuah node berada — sehingga node yang namespace-nya app/compose dan node tanpa namespace dalam file compose di app/compose sengaja ditempatkan pada satu jaringan, persis seperti dua boundary yang memiliki anotasi aggrega.ai/namespace yang sama. Apabila Anda ingin dua node terpisah, berikan identitas yang berbeda kepada keduanya.

Mengubah identitas node akan mengganti nama jaringan compose, dan compose tidak mengganti nama jaringan di tempat. Jaringan dibuat baru dengan nama baru dan setiap layanan di dalamnya dibuat ulang untuk terhubung ke jaringan tersebut, sementara jaringan lama tetap tertinggal sampai ada yang menghapusnya. Jaringan tidak menyimpan data, sehingga tidak ada yang hilang — tetapi kontainer di dalamnya memang dimulai ulang, dan apa pun yang memegang koneksi selama perubahan akan mengalami pemutusan. Perlakukan perubahan anotasi namespace, atau direktori tempat file compose ditulis, sebagai redeployment yang perlu direncanakan, bukan sebagai nilai yang disesuaikan di tempat.

Ketika dua boundary diciutkan ke dalam satu jalur assembly (directory: bersama), node-node mereka yang tanpa anotasi aggrega.ai/namespace berbagi satu-satunya jaringan milik berkas; berikan setiap boundary anotasi aggrega.ai/namespace miliknya sendiri, dan docker-compose.yaml hasil penggabungan mendeklarasikan satu entri tingkat atas networks: per anotasi. Layanan dari boundary yang berbeda dalam berkas compose yang sama dapat berkomunikasi melalui nama layanannya dalam resolusi DNS bawaan compose, dengan tunduk pada aturan keterjangkauan lintas jaringan milik compose sendiri. Perutean L4 lintas jaringan dalam satu berkas compose adalah hal yang dimungkinkan oleh Feature compose-bridge dari pustaka standar, sebagai konten katalog yang logikanya sama sekali tidak dimiliki provider ini: dipasang pada boundary leluhur bersama, FeatureRecipe-nya menurunkan gateway dari edge uses milik boundary yang kedua ujungnya dirakit ke dalam berkas compose milik boundary itu sendiri dan berada pada jaringan berbeda di dalamnya — layanan aggrega-gw yang konfigurasi nginx stream-nya mem-proxy setiap edge yang dijembatani (satu blok server per edge, pada port target dengan cadangan tabrakan portBase) — dan injectMapping miliknya sendiri menulis ulang variabel env host setiap konsumen menjadi aggrega-gw:<port>, atau menjadi aggrega-gw dengan variabel port ditulis ulang menjadi port listen apabila koneksi yang sama mengirimkan keduanya. Penulisan ulang tersebut menggantikan nilai yang dikirimkan oleh koneksi milik konsumen itu sendiri; jika Feature lain yang terpasang pada konsumen mengirimkan variabel yang sama, build berhenti dengan menyebutkan keduanya alih-alih menggantikannya. valuesMapping milik FeatureRecipe menulis konfigurasi tersebut sebagai konfigurasi compose yang di-mount — entri tingkat atas configs: dengan content: inline, dirujuk dari gateway dan di-mount pada /etc/nginx/nginx.conf; hal ini bukan urusan mount oleh operator — dan menyebut setiap endpoint yang dijembatani di bawah x-aggrega-networks-of milik gateway, yang di-resolve provider ini menjadi jaringan tempat endpoint tersebut ditempatkan (di bawah). Edge yang kedua ujungnya dirakit ke dalam dua berkas compose tidak dijembatani dan mempertahankan nama target sendiri; boundary yang tidak memiliki apa pun untuk dijembatani tetap membawa gateway yang menganggur, tanpa konfigurasi dan tanpa jaringan selain miliknya sendiri; dan jembatan yang dipasang pada boundary yang berkas compose-nya tidak memuat komponen apa pun menghentikan build alih-alih menulis gateway ke tempat yang tidak ada. Konfigurasi stream memuat direktif resolver dan mem-proxy melalui variabel per edge (set $uN <host>; proxy_pass $uN) sehingga setiap upstream di-resolve pada saat koneksi, bukan sekali saat startup — proxy_pass polos ke target yang belum berjalan akan menggagalkan gateway saat boot. ($ dalam variabel tersebut di-escape menjadi $$ di dalam configs.content sehingga interpolasi $ milik Docker Compose sendiri menyisakan $ literal untuk nginx.) configs.content inline memerlukan Docker Compose ≥ 2.23.1. Lihat pola compose-bridge.

Bergabung ke jaringan komponen lain — x-aggrega-networks-of

Layanan yang ditulis sebuah fragmen — file compose bersumber setelah overlay-nya digabungkan, atau body artifacts: — dapat bergabung ke jaringan komponen lain yang dirakit ke dalam file compose yang sama dengan menyebutkannya di bawah kunci ekstensi x-aggrega-networks-of: daftar id komponen, yaitu id yang diberikan Aggregate kepada komponennya, yang dibaca oleh FeatureRecipe berlingkup boundary sebagai kunci .boundary.components dan sebagai source dan target dari daftar edge .boundary miliknya. Provider me-resolve setiap id menjadi jaringan tempat komponen tersebut ditempatkan dalam file ini, dengan penempatan yang sama yang diterima setiap node, dan menambahkan jaringan-jaringan itu ke layanan, masing-masing sekali dan dalam urutan nama, di depan jaringan milik layanan sendiri, yang tetap diikutinya. Kunci itu sendiri tidak dimasukkan ke file hasil perakitan. Provider membaca id tersebut sebagai referensi yang perlu di-resolve dan tidak membaca apa pun tentang apa yang dilakukan layanan, sehingga Recipe atau FeatureRecipe mana pun dapat menggunakan kunci ini; gateway compose bridge bergabung ke jaringan endpoint yang dijembataninya dengan cara ini.

# written by a FeatureRecipe attached at the boundary `bridge`, whose file holds adminer (namespace frontend) and db (namespace backend)
services:
probe-svc:
image: busybox
x-aggrega-networks-of: ["adminer", "db"]
# dist/bridge/compose/docker-compose.yaml (abridged)
services:
probe-svc:
image: busybox
networks:
- backend
- frontend
- bridge-zscompose

Tiga hal menghentikan build dengan TRANSLATION_ERROR ketika file dirakit, masing-masing dengan menyebutkan layanannya:

  • Id yang tidak dimiliki komponen mana pun yang dirakit ke dalam file ini — misalnya komponen yang dirakit ke dalam file compose lain. Jaringan milik satu file, sehingga pesan menyebutkan id tersebut dan file tempat layanan berada. Sebutkan hanya komponen yang dirakit ke dalam file yang sama, atau hapus id tersebut.
  • Nilai yang bukan daftar string. Kunci ini menerima daftar id komponen, bahkan untuk satu id.
  • Kunci ini pada layanan yang menulis network_mode. Compose tidak mengizinkan layanan dengan network_mode bergabung ke jaringan; hapus salah satu dari keduanya.

Inferensi depends_on

Provider compose menurunkan depends_on secara otomatis dari edge uses milik IR. Untuk setiap edge yang sumber dan targetnya sama-sama menyumbangkan service ke file compose gabungan, provider menambahkan depends_on: [<target>] ke service sumber.

Dependensi ditempatkan pada service milik komponen sumber itu sendiri, dan tidak pada service lain yang disumbangkan komponen tersebut. Komponen yang juga mendeklarasikan init container menyumbangkan satu service yang berjalan hingga selesai untuk setiap entri, dan tidak satu pun dari service tersebut menerima dependensi yang diturunkan dari edge — edge menyebut nama komponen, sedangkan service init memiliki namanya sendiri. Jadi, init container yang perlu menjangkau target edge, misalnya migrasi skema terhadap database yang di-uses oleh komponen, tidak memiliki pengurutan terhadap target tersebut dan dapat berjalan sebelum target dapat dijangkau, sementara service milik komponen itu sendiri menunggu hingga rantai init selesai dan hingga target telah dimulai.

Entri yang diturunkan dari edge diemisikan tanpa gerbang: entri tersebut memiliki semantik service_started terlepas dari apakah target mendeklarasikan healthcheck. Menggerbangkannya pada kesehatan target — yang akan membuat runtime compose menahan startup hingga healthcheck target melaporkan sehat — dapat diekspresikan, dan edge uses tidak memintanya. Wave yang menyebut pasangan yang sama adalah satu-satunya hal yang mengubah kondisi pada entri yang diturunkan dari edge, dan hal itu terjadi karena wave memintanya, bukan karena edge memintanya.

Entri yang diturunkan dari edge diemisikan dalam urutan alfabetis target demi stabilitas output. Edge yang sumber atau targetnya dilayani oleh provider lain (helm atau helm-chart) dilewati — depends_on hanya berlaku di dalam subset Release yang dilayani compose.

depends_on sebuah service diemisikan dalam salah satu dari dua bentuk compose, tidak pernah campuran keduanya, karena compose mewajibkan kondisi pada setiap entri bentuk panjang:

  • Daftar bentuk pendek (depends_on: [<service-name>]) jika tidak ada entri pada service tersebut yang membawa kondisi. Ini berlaku untuk setiap service yang seluruh dependensinya berasal dari edge uses.
  • Mapping bentuk panjang jika ada entri yang membawa kondisi — yang terjadi ketika service juga menunggu init container, atau ketika deployment wave mengurutkannya. Dalam hal itu, entri yang diturunkan dari edge diemisikan dengan condition: service_started secara eksplisit, yang oleh Compose Specification didefinisikan sebagai padanan bentuk pendek, sehingga maknanya tidak berubah.

Di dalam sebuah service, setiap sumber mempertahankan urutannya sendiri dan tidak saling berselang-seling: penantian rantai init, yang urutannya mengikuti urutan daftar yang ditulis penulis, diemisikan terlebih dahulu, kemudian entri yang diturunkan dari edge dalam urutan alfabetis, lalu entri yang diturunkan dari wave dalam urutan alfabetis.

Pengurutan gelombang deployment

Nilai syncWave: dari sebuah batas Release mengurutkan layanan-layanan dalam file compose yang dirender oleh batas tersebut. Setiap komponen dalam batas mewarisi gelombang batas itu, dan jika beberapa batas berbagi satu directory: — sehingga kontribusinya digabungkan menjadi satu docker-compose.yaml — file gabungan memuat lebih dari satu gelombang dan provider menyatakan urutan di antaranya sebagai depends_on.

Setiap layanan menunggu setiap layanan dari gelombang tepat sebelumnya yang memiliki layanan, dan tidak menunggu gelombang yang lebih awal dari itu. Compose menyelesaikan sisanya secara transitif: layanan di gelombang 2 menunggu gelombang 1, yang menunggu gelombang 0, sehingga seluruh urutan teratur sementara daftar milik setiap layanan tetap seukuran satu gelombang, bukan seukuran seluruh file. Gelombang tidak perlu berurutan tanpa celah, dan nilai negatif adalah hal biasa — -1 merupakan pilihan umum untuk migrasi yang dijalankan sebelum yang lainnya.

Kondisinya bergantung pada apa yang dapat dipenuhi oleh target. Gelombang berarti kelompok yang lebih awal sudah aktif sebelum kelompok berikutnya dimulai, yaitu kesiapan, bukan sekadar peluncuran proses, sehingga:

  • jika layanan target mendeklarasikan healthcheck, penantiannya adalah condition: service_healthy;
  • jika tidak, penantiannya adalah condition: service_started, karena layanan tanpa healthcheck tidak pernah dapat melaporkan status sehat dan penantian berbasis kesehatan terhadapnya tidak akan pernah terpenuhi — file tidak akan pernah aktif.

Kondisi yang lebih lemah terlihat dalam file yang dihasilkan di samping kondisi yang lebih kuat, dan build juga menyebutkan setiap layanan semacam itu dalam sebuah peringatan, sehingga penulis yang mengharapkan pengurutan kesiapan mengetahui bagian mana dari gelombang yang dideklarasikannya hanya menjadi pengurutan start. Peringatan ini bersifat anjuran: build berhasil dan byte yang dirender persis sama seperti tanpa peringatan itu. Menambahkan blok health: pada kontainer tersebut adalah cara meningkatkan penantiannya. --no-unsupported-field-warnings membungkam kelas peringatan ini.

Gelombang tetap dicatat sebagai label. Pengurutan ditambahkan di samping label aggrega.ai/sync-wave, bukan menggantikannya: label itulah tempat pembaca yang memeriksa file yang dihasilkan melihat dari gelombang mana sebuah layanan berasal, hal yang tidak dinyatakan oleh entri depends_on.

Jika sebuah gelombang dan sebuah edge uses menyebut pasangan yang sama, satu entri memuat keduanya. Compose menerima satu entri per dependensi, sehingga layanan yang sekaligus uses sebuah target dan berada satu gelombang setelahnya menghasilkan satu entri dengan kondisi gelombang — persyaratan gelombang adalah yang lebih kuat di antara keduanya dan itulah yang dinyatakan.

Batas yang semua komponennya berada dalam satu gelombang tidak menghasilkan apa pun dari sini. Begitu pula Release yang sama sekali tidak mendeklarasikan syncWave: setiap kontributor membawa nilai default field tersebut, yaitu 0, file gabungan memuat satu gelombang, dan keluarannya persis sama seperti jika provider tidak menyatakan pengurutan gelombang apa pun.

Pengurutan lintas dua file compose tidak dapat dinyatakan, dan tidak didekati. depends_on menyebut layanan di dalam file yang sama, dan batas-batas yang dievaluasi ke jalur perakitan berbeda menghasilkan file docker-compose.yaml berbeda yang diperlakukan runtime compose sebagai proyek independen. Jadi sebuah gelombang mengurutkan setiap layanan dalam file tempat ia dirender dan tidak ada yang di luarnya. Mengurutkan dua proyek compose adalah urusan operator, sama seperti perutean lintas file; mendeklarasikan directory: bersama adalah cara menyatukan dua batas ke dalam satu file, dan itu merupakan keputusan bentuk keluaran yang diambil karena alasannya sendiri, bukan untuk memperoleh pengurutan.

Edge uses yang menunjuk ke gelombang yang lebih akhir dikeluarkan sebagaimana ditulis, dan dilaporkan. depends_on yang dikeluarkan mencerminkan apa yang dideklarasikan — baik edge uses maupun gelombang. Edge yang konsumennya berada di gelombang yang lebih awal daripada target yang digunakannya menyatakan kebalikan dari apa yang dinyatakan gelombang: edge membuat konsumen menunggu target, sedangkan gelombang membuat target menunggu konsumen, melalui setiap gelombang di antara keduanya. File gabungan menyatakan keduanya, yang merupakan himpunan dependensi melingkar yang ditolak untuk dijalankan oleh Docker Compose. Build menyebutkan setiap edge semacam itu dalam peringatan yang menyatakan kedua layanan dan kedua gelombang, sehingga siklus tersebut muncul saat Anda melakukan build, bukan saat docker compose up. Peringatan ini bersifat saran — build berhasil dan byte yang dirender persis sama seperti tanpa peringatan itu — dan --no-unsupported-field-warnings tidak membungkamnya, karena tidak ada yang dibuang: kedua deklarasi masing-masing dinyatakan, dan bersama-sama keduanya tidak dapat dijalankan. Peringatan ini hanya mencakup pasangan langsung: peringatan menyebutkan dua layanan yang dihubungkan oleh satu edge alih-alih menelusuri seluruh siklus. Setiap siklus yang dibangun dari edge uses dan gelombang bersama-sama melewati setidaknya satu edge semacam itu, sehingga selalu dilaporkan; siklus yang dibentuk oleh edge uses saja, tanpa melibatkan gelombang, dan siklus yang ditutup oleh entri depends_on yang ditulis dalam file compose yang disediakan Recipe, dikeluarkan sebagaimana ditulis dan tidak dilaporkan. Jaga agar arah edge dan urutan gelombang konsisten: tempatkan konsumen di gelombang target atau gelombang yang lebih akhir, atau target di gelombang konsumen atau gelombang yang lebih awal.

# release.yaml fragment — three boundaries collapsing onto one compose file
boundaries:
data:
directory: ./dist/cluster
syncWave: -1
components:
migrator: {} # no health: block
core:
directory: ./dist/cluster
syncWave: 0
components:
store: {} # declares health:
edge:
directory: ./dist/cluster
syncWave: 1
components:
frontend: {} # uses: store
# dist/cluster/compose/docker-compose.yaml (abridged)
services:
frontend:
labels:
aggrega.ai/sync-wave: "1"
depends_on:
store:
condition: service_healthy # store declares a healthcheck
migrator:
labels:
aggrega.ai/sync-wave: "-1" # lowest wave: waits on nothing
store:
depends_on:
migrator:
condition: service_started # migrator declares no healthcheck
healthcheck:
test: [CMD-SHELL, "nc -z localhost 5432"]

frontend tidak menyebut migrator: pengurutan menjangkau gelombang tepat sebelumnya dan compose merangkai sisanya melalui store.

Mode bersumber

source: milik provider compose menamai sebuah file YAML docker-compose yang dapat dibaca dan diurai oleh provider, dan menerima kedua bentuk yang diambil oleh field source:: sebuah string path filesystem polos, dan sebuah objek terstruktur yang url:-nya membawa lokasi. Di mana pun lokasi itu berupa path filesystem, path tersebut berjangkar pada direktori yang memuat recipe.yaml yang mendeklarasikannya, bukan pada direktori tempat build dijalankan, dan harus tetap berada di dalam direktori itu: path yang keluar darinya, atau path absolut, ditolak, karena setiap file yang dibawa oleh sebuah publikasi Recipe diambil dari direktorinya — lihat entities/recipe.md “Content paths stay inside the Recipe’s own directory”. File yang dinamai dengan cara ini dipublikasikan bersama Recipe, sedangkan file di samping Recipe yang tidak dinamai oleh apa pun yang dideklarasikannya tidak dipublikasikan.

spec:
capability: compose
source: ./docker-compose.base.yaml # filesystem path to the base compose file
valuesMapping: |
services:
api:
image: "{{ .values.image }}"

Dalam bentuk terstruktur, apa yang dibawa url: menentukan apakah sesuatu diambil. Fragmen yang dipublikasikan melalui https:// diambil dan disematkan dengan kind: compose-https-fragment; aggrega pull memperolehnya dan build membacanya dari cache. url: yang menamai path filesystem tidak diambil — path itu dibaca dari disk, berjangkar persis seperti bentuk string polos di atas, dan aggrega pin mencatat digest file yang dinamainya dalam entity.lock di samping Recipe, yang kemudian dibandingkan oleh build sebelum fragmen dibaca. Menyalin fragmen jarak jauh secara lokal (vendoring) dan mengarahkan source: ke salinan tersebut didukung sebagai alternatif pengambilan, dan tidak diwajibkan. Skema menerima objek terstruktur terbuka.

Recipe dengan source: <path-to-compose-file> dan valuesMapping: menjalankan pipeline berikut:

  1. File compose dasar di <path> dibaca dan diurai sebagai YAML.
  2. Template valuesMapping dievaluasi terhadap konteks template milik Recipe. Keluarannya diperlakukan sebagai dokumen overlay compose — file compose parsial yang menambah atau menimpa field dalam file dasar.
  3. Dasar dan overlay digabungkan secara mendalam (deep-merge) menggunakan semantik overlay bawaan docker-compose.

Aturan deep-merge:

  • Skalar: overlay menang. Ketika dasar dan overlay sama-sama menetapkan field skalar yang sama, nilai overlay menggantikan nilai dasar.
  • Map: digabungkan secara rekursif. Ketika dasar dan overlay sama-sama menetapkan field map yang sama, penggabungan masuk secara rekursif ke dalam map. Kunci yang ada di keduanya mengikuti aturan yang sama; kunci yang hanya ada di salah satunya dipertahankan apa adanya.
  • List: diganti. Ketika dasar dan overlay sama-sama menetapkan field list yang sama, list overlay menggantikan list dasar sepenuhnya (tanpa penggabungan per elemen atau penambahan). Ini sesuai dengan perilaku docker compose -f base.yaml -f overlay.yaml config.
  • null: menggantikan, dan tetap ada. Kunci yang ditetapkan overlay ke null pada sebuah service — salah satu kunci milik service itu sendiri, seperti user, command, atau healthcheck, entri environment, label, atau kunci tepat di bawah healthcheck atau deploy — menggantikan nilai dasar seperti skalar lainnya dan ditulis ke dalam file compose sebagai key: null; kunci itu tidak dihapus. Apabila provider menulis nilainya sendiri ke dalam kunci tersebut, file justru memuat nilai provider: labels: null menyisakan label asal-usul yang dibubuhkan provider, dan networks: null menyisakan jaringan yang dipasangnya. null yang ditulis di tempat lain mana pun dalam overlay berada di luar aturan ini. Arti null selanjutnya adalah tafsiran Compose atas atribut tersebut — misalnya, entri environment tanpa nilai mengambil nilainya dari lingkungan tempat docker compose dijalankan.

Setiap label yang ditulis penulis sebuah layanan tetap dipertahankan. labels: sebuah layanan di file dasar atau overlay dapat ditulis sebagai map atau sebagai daftar entri key=value milik Compose, dan setiap label sampai ke file compose di samping label provenans yang dicap provider. Entri daftar dibaca seperti Compose membacanya: teks sebelum = pertamanya menamai label dan teks sesudahnya adalah nilainya, dan entri tanpa = adalah label dengan nilai kosong. Angka atau nilai true/false ditulis sebagai teksnya, sehingga replicas-hint: 2 sampai ke file sebagai replicas-hint: "2", dan label yang ditulis sebagai null tetap null. Jika label yang ditulis penulis dan label provenans memakai kunci yang sama, file membawa nilai provenans. Nilai labels: yang bukan map maupun daftar, dan entri daftar yang bukan teks, menghentikan build dengan menyebut file sumber dan layanannya. Label layanan dalam body artifacts: memakai bentuk map: daftar di sana menghentikan build dengan menyebut artefak dan layanannya.

Dokumen hasil penggabungan kemudian mengalir ke penggabungan tingkat Release bersama kontribusi mode sintesis lainnya, dengan jaringan per batas dan inferensi depends_on yang sama.

Mengecualikan service, volume, dan config. Overlay tidak dapat menghapus apa pun dari file dasar — nilai overlay menggantikan, tidak pernah menghapus — sehingga untuk file yang diambil yang menyertakan service yang tidak boleh dijalankan oleh Release, itulah kegunaan entri omits: dari sebuah Recipe atau FeatureRecipe. Provider ini mematuhinya dalam mode ini dan tidak dalam mode lain: Workload yang disintesis dan body artifacts: di-render tanpanya. Sebuah entri menamai satu unit tingkat atas dari file berdasarkan kind-nya — service, volume atau config — dan name-nya, yaitu kunci unit di bawah services:, volumes: atau configs:, yang dibandingkan secara persis. File compose tidak memiliki namespace, sehingga entri yang membawa namespace, seperti entri yang menamai kind lain, menghentikan build ketika komponen di-render, dengan menyebut entri tersebut dan kind yang diterima provider ini; setiap entri diperiksa sebelum apa pun dikecualikan. Entri dicocokkan terhadap file setelah overlay di atas digabungkan ke dalamnya, sehingga unit yang ditambahkan overlay dikecualikan persis seperti unit yang dideklarasikan file dasar, dan sebelum provider menambahkan apa pun miliknya sendiri, sehingga entri tidak pernah menamai hal itu. Unit yang dinamai entri dihapus, dan bagian yang seluruh unitnya dikecualikan ikut dihapus; setiap unit lain ditulis persis seperti tanpa entri tersebut. Entri hanya menjangkau file dari Recipe atau FeatureRecipe yang mendeklarasikannya dan tidak yang lain: apa yang dikontribusikan komponen lain atau Feature yang terpasang ke docker-compose.yaml yang sama tidak tersentuh, termasuk unit dengan kunci yang sama. Provider melaporkan berapa banyak unit yang dikecualikan oleh setiap entri, dan entri yang tidak mengecualikan apa pun menghentikan build; lihat An omits entry left out nothing the source rendered (Entri omits tidak mengecualikan apa pun yang di-render oleh sumber).

Unit yang dikecualikan tidak boleh tetap dinamai oleh apa yang tersisa, karena compose menolak file yang menamai service, volume, atau config yang tidak dideklarasikannya. Setelah unit dihapus, setiap referensi yang masih dibuat file ke salah satunya menghentikan build, dan pesannya menyebut setiap service atau job yang merujuk, unit yang dinamainya, dan field tempat referensi itu berada. Referensi adalah apa yang didefinisikan Compose Specification sebagai satu entri file yang menamai entri lain:

  • sebuah service, dinamai oleh depends_on dalam bentuk mana pun, oleh links (SERVICE atau SERVICE:ALIAS), oleh volumes_from (SERVICE atau SERVICE:MODE), oleh network_mode, ipc, pid atau uts yang ditetapkan ke service:<name>, oleh extends yang menamai service dari file yang sama, atau oleh nilai build.additional_contexts service:<name>;
  • sebuah volume, dinamai sebagai sumber entri volumes: — bentuk pendek SOURCE:TARGET di mana sumbernya berupa nama, bukan path, dan bentuk panjang type: volume;
  • sebuah config, dinamai oleh entri configs:, dalam bentuk mana pun.

Hook pre_start milik service dan setiap entri tingkat atas jobs: juga dibaca, untuk referensi yang diizinkan spesifikasi untuk dibawa masing-masing. Beberapa nilai hanya tampak seperti referensi dan tidak dibaca sebagai referensi: entri volumes_from atau network_mode yang diawali container: menamai sebuah container, external_links menamai container yang tidak dideklarasikan file ini, extends dengan file: menamai service dari file lain, dan credential_spec.config dapat menamai config yang dipegang platform, bukan file. Setiap nilai dibandingkan sebagaimana tertulis, sehingga referensi yang ditulis melalui ${VARIABLE} tidak terlihat oleh pemeriksaan ini, dan referensi ke unit yang tidak pernah dideklarasikan file dibiarkan apa adanya.

Pemeriksaan hanya membaca file milik Recipe atau FeatureRecipe yang mendeklarasikan, sehingga referensi ke service yang dikecualikan menghentikan build bahkan jika kontributor lain di path assembly yang sama mendeklarasikan service dengan nama itu. Untuk mempertahankan referensi, pertahankan unitnya. Untuk menghapusnya, ubah entri yang merujuk melalui valuesMapping: — list di sana menggantikan list file dasar, sehingga depends_on: [] mengosongkannya — atau kecualikan juga service yang merujuk.

Keluaran per-(path, provider)

Setiap jalur perakitan compose menghasilkan satu docker-compose.yaml. Batas yang dievaluasi menjadi jalur yang berbeda menghasilkan file compose yang berbeda; batas yang berbagi jalur hasil evaluasi yang sama menghasilkan satu file compose gabungan yang memuat setiap kontributor pada jalur tersebut. Jalur tersebut adalah directory: milik batas yang digabungkan dengan subDirectory: per komponen (yang secara bawaan bernilai {{ .capability }} sehingga kontributor compose secara bawaan ditempatkan di bawah subfolder compose/).

Tabrakan nama layanan dalam satu jalur perakitan menghentikan build. Ketika dua node berbeda menyumbangkan layanan dengan ID instans yang sama pada tuple (path, provider) yang sama, kompiler berhenti dan diagnostiknya menyebutkan setiap tuple (boundary, node) yang berkontribusi dalam urutan abjad. Penulis menyelesaikan tabrakan tersebut dengan mengganti nama salah satu kontributor (biasanya dengan menyesuaikan pengenal node agar synthesizer menghasilkan nama layanan yang berbeda), atau dengan mengarahkan kontributor ke jalur yang berbeda melalui deklarasi directory: yang berbeda.

Volume tingkat atas digabungkan (union) dalam satu jalur perakitan, dan dua kontributor boleh mendeklarasikan satu nama asalkan keduanya sepakat tentang nama itu. Kontributor adalah fragmen, sehingga dua fragmen dari satu komponen — file compose miliknya sendiri dan entri artifacts:, atau dua entri artifacts: — adalah dua kontributor, persis seperti dua komponen. Volume bernama adalah satu volume fisik, sehingga dua deklarasi yang identik sama-sama menggambarkan tepat entri yang akhirnya ada dalam file hasil perakitan, dan volume itu tetap memiliki satu entri di bawah nama tersebut. Volume yang diturunkan oleh provider tidak memiliki isi, sehingga dua volume semacam itu otomatis sepakat, dan bagaimanapun keduanya tidak dapat bertemu (lihat Cara nama volume diturunkan).

Entri volumes: yang ditulis sendiri adalah yang perlu diperhatikan, karena entri ini dapat memiliki isinya sendiri — driver, driver_opts, atau labels. Jika dua kontributor mendeklarasikan satu nama dengan isi yang berbeda, build berhenti dengan TRANSLATION_ERROR, dengan menyebutkan volume tersebut dan setiap tuple (boundary, node, fragment) yang berkontribusi. Dua penulis yang berselisih tentang satu volume tidak memiliki jawaban yang dapat dipilih oleh assembler: mempertahankan salah satu isi akan membuang apa yang ditulis penulis lainnya, dari build yang seharusnya berhasil. Selesaikan dengan membuat kedua deklarasi identik, jika kedua penulis memaksudkan volume yang sama, atau dengan mengganti nama salah satunya, jika mereka memaksudkan dua volume. Jaringan tingkat atas adalah satu per anotasi aggrega.ai/namespace yang berbeda, ditambah satu yang dinamai menurut path file compose untuk node yang tidak memiliki anotasi, dinamai sesuai Cara nama jaringan diturunkan; dua batas yang berkontribusi dengan anotasi aggrega.ai/namespace yang sama digabung menjadi satu jaringan yang digunakan bersama oleh keduanya, demikian pula dua batas tanpa anotasi yang berbagi file tersebut.

Setiap kunci yang ditulis fragmen dibawa atau ditolak

Sebuah fragmen — file compose bersumber setelah overlay-nya digabungkan, atau body artifacts: yang dievaluasi menjadi YAML compose — mencapai docker-compose.yaml hasil perakitan hanya melalui kunci yang dibawa provider, dan himpunan itu tetap. Setiap kunci yang ditulis fragmen dibawa ke file hasil perakitan sebagaimana ditulis atau ditolak dengan menyebut namanya; tidak ada yang dikecualikan tanpa keterangan. Fragmen adalah satu file compose, sehingga ia merupakan satu dokumen YAML.

  • Dibawa. Di tingkat atas: services, volumes, configs, dan models. Pada sebuah layanan: image, pull_policy, command, entrypoint, environment, env_file, ports, labels, volumes, tmpfs, networks, network_mode, depends_on, healthcheck, restart, user, working_dir, privileged, read_only, cap_add, cap_drop, configs, models, deploy, stop_grace_period, dns, dns_search, extra_hosts, dan profiles. Di dalam blok yang dijelaskan provider: deploy.resources dengan limits (cpus, memory) dan reservations (cpus, memory, devices, serta driver, count, device_ids, capabilities, dan options milik setiap entri perangkat) miliknya; test, interval, timeout, retries, dan start_period milik healthcheck; type, source, target, read_only, dan volume.subpath milik entri volumes: bentuk panjang; source dan target milik entri configs: bentuk panjang; condition milik entri depends_on: bentuk panjang; driver, driver_opts, dan labels milik volume tingkat atas; content milik config tingkat atas. Body sebuah model dan entri models: bentuk panjang milik layanan membawa setiap anggota, seperti dijelaskan dalam Model. Anggota ekstensi — kunci yang diawali x- — dibawa di tingkat atas dan pada layanan, seperti dijelaskan dalam Anggota ekstensi.
  • Ditolak. Kunci lain mana pun — stdin_open pada layanan, secrets: atau name: tingkat atas, deploy.replicas, restart: atau required: di dalam entri depends_on: bentuk panjang, kunci x- di dalam body volume tingkat atas atau healthcheck — menghentikan build dengan TRANSLATION_ERROR, dengan menyebut setiap kunci tersebut, path-nya dalam fragmen (services.migrate.stdin_open), fragmen, dan komponennya, serta menyebut dua tempat asal kunci semacam itu. Yang pertama adalah fragmen itu sendiri, dan perbaikannya adalah menghapus kunci tersebut darinya. Yang lain adalah Recipe bersumber yang tidak mendeklarasikan valuesMapping:: nilai node kemudian ditimpakan ke file compose apa adanya, sehingga setiap kunci nilai tiba sebagai kunci tingkat atas fragmen, dan perbaikannya adalah mendeklarasikan valuesMapping: yang menempatkan setiap nilai di bawah kunci yang dibawa provider. Kunci yang dibawa ke dalam blok oleh kunci merge YAML (<<: *anchor) dinilai di tempat ia mendarat, seolah-olah ditulis di sana. Fragmen yang di-render dari sumber dinamai <component>.compose-fragment.yaml; fragmen artifacts: dinamai sesuai nama yang diberikan Recipe-nya.
  • Ditolak secara keseluruhan: jaringan milik fragmen sendiri. Entri di bawah networks: tingkat atas milik fragmen menghentikan build dengan TRANSLATION_ERROR apa pun isi body-nya — entri kosong, driver, atau apa pun lainnya — dengan menyebut entri tersebut (networks.back), fragmen, dan komponennya, karena file hasil perakitan hanya memuat jaringan yang diturunkan provider (lihat Jaringan yang diikuti sebuah layanan). Hapus entri tersebut: layanan bergabung ke jaringan komponennya sendiri tanpa deklarasi apa pun, anotasi aggrega.ai/namespace memilih jaringan yang diikuti komponen, layanan menyebut komponen yang jaringannya juga diikutinya di bawah x-aggrega-networks-of, dan Feature compose-bridge merutekan antara layanan di jaringan yang berbeda. networks: {} yang kosong tidak mendeklarasikan apa pun dan tidak ditolak, dan daftar networks: milik layanan sendiri dibawa seperti di atas.
  • Ditolak secara keseluruhan: fragmen yang terdiri dari lebih dari satu dokumen. Body artifacts: yang memuat dua dokumen YAML atau lebih yang dipisahkan --- menghentikan build dengan TRANSLATION_ERROR, dengan menyebut fragmen, komponen, dan jumlah dokumen yang dimuatnya, karena penggabungan membaca fragmen sebagai satu file compose dan setiap dokumen setelah yang pertama akan hilang dari file hasil perakitan. Tulis fragmen sebagai satu dokumen, atau berikan setiap dokumen entri artifacts: miliknya sendiri. Dokumen yang tidak memuat apa pun — dokumen kosong yang dibuka oleh --- di akhir — tidak dihitung. File compose bersumber yang terdiri dari beberapa dokumen tidak pernah menjadi fragmen semacam itu: file tersebut ditolak ketika dibaca.

Provider tidak membaca makna kunci apa pun: sebuah kunci dibawa karena ada dalam himpunan di atas dan ditolak karena tidak ada di dalamnya.

Anggota ekstensi dibawa sebagaimana ditulis

Compose Specification mencadangkan kunci yang diawali x- untuk ekstensi: data yang dapat digunakan oleh alat yang membaca file dan diabaikan oleh Compose sendiri. Anggota ekstensi sebuah fragmen di tingkat atas dan pada sebuah layanan mencapai file hasil perakitan sebagaimana ditulis, setelah setiap kunci yang dimodelkan provider pada tingkat itu, dalam urutan yang dimuat fragmen; provider tidak membaca apa pun di dalamnya, kecuali x-aggrega-networks-of milik sebuah layanan, yang di-resolve menjadi jaringan yang diikuti layanan tersebut dan dikeluarkan dari file hasil perakitan (lihat Bergabung ke jaringan komponen lain). Isi artifacts: memuatnya dalam urutan penulisannya. Kunci file compose bersumber mencapai fragmennya dalam urutan nama setelah overlay-nya digabungkan, sehingga anggota ekstensinya ditulis dalam urutan nama.

# an artifacts: body
x-owner: team-b
services:
migrate:
image: example/migrate:1
x-schedule: manual

Anggota yang dicapai melalui alias YAML ditulis secara lengkap, dan tidak ada anchor yang dibawa, sehingga file hasil perakitan tidak pernah memuat alias yang anchor-nya tidak ada; inilah yang memungkinkan anggota tingkat atas memuat anchor yang dibawa masuk oleh merge key sebuah layanan (<<: *base). Anggota sebuah layanan ikut berpindah bersama layanannya. Anggota tingkat atas digabungkan (union) dalam satu jalur perakitan dengan aturan yang diikuti volume: dua fragmen yang menulis satu anggota dengan konten yang sama menyisakan satu entri, baik ditulis dalam gaya block maupun flow, dan dua yang menulisnya dengan konten berbeda menghentikan build dengan TRANSLATION_ERROR, dengan menyebutkan anggota tersebut dan setiap tuple (boundary, node, fragment) yang berkontribusi — termasuk dua fragmen dari satu komponen. Buat kedua deklarasi identik, atau beri salah satunya nama yang berbeda.

profiles menempatkan layanan di balik profil Compose. Layanan yang mencantumkan profiles: tidak dijalankan oleh docker compose up kecuali salah satu profilnya diaktifkan, dan dijalankan oleh docker compose run --rm <service> sesuai permintaan — bentuk compose dari tugas yang dijalankan sesuai kebutuhan. Daftar itu dibawa sebagaimana ditulis fragmen, dalam urutannya:

# a sourced compose file
services:
migrate:
image: example/migrate:1
profiles: [manual]

Model

Bagian models: tingkat atas dalam file compose mendeklarasikan model AI yang digunakan oleh layanan-layanan dalam file tersebut, dan sebuah layanan diberi akses ke suatu model melalui entri models: miliknya sendiri. Provider membawa keduanya dari sebuah fragmen ke dalam docker-compose.yaml hasil perakitan, dengan ejaan Compose sendiri, baik fragmen itu berupa file compose bersumber maupun isi artifacts: yang dievaluasi menjadi YAML compose. Workload tidak mendeklarasikan model, sehingga Recipe mode Workload tidak menyumbangkan model apa pun.

  • Isi model ditulis sebagaimana fragmen menuliskannya. model — pengenal artefak OCI untuk model tersebut — context_size, dan runtime_flags mempertahankan namanya, dan setiap anggota lainnya, termasuk ekstensi x-, dibawa di sampingnya. Di dalam sebuah model, ketiga anggota bernama itu ditempatkan lebih dulu dan sisanya menyusul dalam urutan kunci, dan model-model ditulis dalam urutan nama, sehingga masukan yang identik menghasilkan file yang identik byte demi byte. Provider tidak membaca apa pun dalam isi tersebut: provider tidak memeriksa pengenal, dan tidak mengetahui apa pun tentang apa yang akan melayani model itu.
  • Referensi layanan mempertahankan bentuknya. Bentuk pendek mencantumkan nama model (models: [llm]); bentuk panjang memetakan setiap model ke endpoint_var dan model_var, yaitu nama variabel yang menerima alamat model runner dan pengenal model. Keduanya ditulis dalam bentuk dan urutan yang digunakan fragmen, dan ikut bersama layanannya. Jika bentuk panjang membiarkan suatu variabel tanpa nama, Compose memberinya nama saat menjalankan file.
  • Model digabungkan (union) dalam satu jalur perakitan, dengan aturan yang sama seperti volume. Dua kontributor yang mendeklarasikan satu nama model dengan isi yang menghasilkan keluaran identik menyisakan satu entri di bawah nama itu; dua yang mendeklarasikannya dengan isi berbeda menghentikan build dengan TRANSLATION_ERROR, dengan menyebutkan model tersebut dan setiap tuple (boundary, node, fragment) yang berkontribusi. Dua fragmen dari satu komponen juga merupakan dua kontributor di sini. Buat deklarasinya identik jika kedua kontributor memaksudkan satu model, atau beri salah satunya nama yang berbeda.
  • Setiap referensi menyebutkan model yang dideklarasikan. Setelah fragmen-fragmen jalur perakitan digabungkan, layanan yang diberi akses ke model yang tidak dideklarasikan oleh kontributor mana pun pada jalur itu menghentikan build dengan TRANSLATION_ERROR, dengan menyebutkan layanan dan model tersebut. Pemeriksaan dijalankan atas gabungan yang sudah lengkap, sehingga satu komponen dapat memberi layanannya akses ke model yang dideklarasikan komponen lain pada jalur perakitan yang sama.
  • Entri omits: tidak dapat mengecualikan model. service, volume, dan config adalah jenis yang diterima provider ini, dan entri yang menyebutkan model menghentikan build seperti entri yang menyebutkan jenis lainnya.

Model dilayani saat file dijalankan, bukan saat file di-build. Docker Compose 2.38 atau yang lebih baru, pada platform yang mendukung model Compose seperti Docker Model Runner, menarik dan menjalankan setiap model yang diberikan kepada suatu layanan, dengan mengabaikan model lainnya kecuali dijalankan dengan --all-resources, dan menetapkan, di setiap layanan yang diberi akses ke model itu, variabel yang disebutkan referensinya ke alamat model runner dan pengenal model. Build tidak dapat melihat host yang akan menjalankan file, sehingga build tidak memeriksa versi Compose maupun platformnya: file yang memuat model dirakit dengan cara yang sama apa pun yang menjalankannya.

Feature yang dilampirkan ke komponen berkontribusi pada file yang sama

Feature yang dilampirkan ke sebuah komponen menyumbangkan layanannya ke docker-compose.yaml tempat komponen induknya dirakit, dengan ketentuan yang sama seperti Recipe milik komponen induk itu sendiri. Tidak ada file kedua di sampingnya: satu jalur perakitan menghasilkan satu dokumen, sehingga layanan Feature yang dilampirkan berada dalam dokumen itu atau tidak di-deploy sama sekali. Melepas Feature menghapus tepat layanan-layanan tersebut dan membiarkan layanan milik komponen induk tetap utuh.

Layanan-layanan tersebut adalah kontributor pada jalur perakitan itu seperti kontributor lainnya, sehingga semua hal di atas berlaku untuknya tanpa perubahan — aturan nama layanan, dan ketentuan bahwa dua kontributor yang mendeklarasikan satu nama volume atau config tingkat atas harus sepakat tentang apa itu. Layanan-layanan tersebut juga bergabung ke jaringan yang sama dengan bagian lain dari batas itu, sehingga sebuah komponen dan Feature yang dilampirkan kepadanya dapat saling menjangkau melalui nama layanan tanpa perlu mendeklarasikan apa pun lagi.

Setiap layanan yang disumbangkan Feature membawa identitas yang disusun untuk lampiran tersebut, bukan identitas komponen induk, sehingga keduanya tetap dapat dibedakan di dalam dokumen yang disumbang oleh keduanya. Label dan anotasi menjelaskan cara identitas tersebut dibangun.

Ini adalah mekanisme yang berbeda dari blok attachments: tingkat kontainer milik Workload, dan keduanya mudah dianggap sama karena menggunakan kata yang sama. Melampirkan Feature ke sebuah komponen menambahkan layanan ke dokumen hasil perakitan; entri attachments: milik kontainer membaca kredensial yang dipublikasikan sebuah slot ke dalam kontainer tersebut saja, dan dijelaskan di Field kontainer.

Fragmen compose yang dihasilkan oleh artifacts

Ketika blok artifacts: milik sebuah Recipe dievaluasi menjadi YAML compose — sebuah fragmen yang membawa blok services:, volumes:, configs:, models:, atau networks: miliknya sendiri (setiap entri ditulis inline atau dimuat per entri dengan $import:) — penggabungan ke dalam perakitan per-(path, provider) mengikuti aturan yang spesifik untuk tiap bentuk:

  • services: dari artifacts digabungkan ke dalam file compose hasil perakitan bersama layanan per komponen. Nama layanan yang disumbangkan oleh dua komponen berbeda pada jalur perakitan yang sama menghentikan build, dan diagnostiknya menyebutkan setiap kontributor. Tabrakan di dalam satu komponen — antara fragmen artefak milik komponen itu sendiri dan layanan yang disintesis untuknya — tidak terdeteksi, dan kontribusi yang belakangan menggantikan yang sebelumnya, jadi jaga agar nama layanan yang ditulis di artefak berbeda dari nama <component> dan <component>--<container-name> yang dihasilkan oleh synthesizer (lihat Cara layanan sidecar atau init dinamai).
  • volumes: dari artifacts digabungkan ke dalam blok volumes: tingkat atas. Dua entri yang mencapai satu nama menyisakan satu entri di bawah nama itu jika keduanya mendeklarasikannya secara identik, sesuai aturan yang sama dengan volume per komponen; dua entri yang mendeklarasikannya secara berbeda menghentikan build, baik keduanya berasal dari dua komponen maupun dari dua fragmen satu komponen — dua entri artifacts:-nya, atau salah satunya dan file compose milik komponen itu sendiri. Karena fragmen artefak menulis isinya sendiri, inilah jalur yang paling mungkin membuat dua kontributor tidak sepakat. Jaga agar nama volume yang ditulis di artefak berbeda dari nama lain pada jalur perakitannya, termasuk dari bentuk <component>--<volume-name> yang dihasilkan oleh derivasi — kecuali dua kontributor memang dimaksudkan untuk mendeskripsikan satu volume bersama, dan dalam hal ini deklarasi keduanya harus sama.
  • configs: dari artifacts digabungkan ke dalam blok configs: tingkat atas. Dengan cara inilah file di balik volume configmap mencapai perakitan: volume tersebut menjadi referensi configs: tingkat layanan yang menyebutkan configmap, dan fragmen artefak mendeklarasikan entri dengan nama itu beserta content: inline. Setelah fragmen-fragmen pada jalur perakitan digabungkan, setiap referensi tingkat layanan harus ter-resolve ke entri yang dideklarasikan, atau build berhenti dengan TRANSLATION_ERROR yang menyebutkan setiap referensi yang tidak ter-resolve — layanan, nama config, dan jalur mount. Pemeriksaan dijalankan atas gabungan yang sudah lengkap, bukan per komponen, sehingga satu komponen dapat mereferensikan config yang dideklarasikan oleh komponen lain pada jalur perakitan yang sama. Gabungan tersebut merekonsiliasi berdasarkan nama jika para kontributor sepakat: dua kontributor yang mendeklarasikan satu nama config dengan content: yang identik menyisakan satu entri yang dideskripsikan keduanya. Dua kontributor yang mendeklarasikan satu nama dengan content: yang berbeda menghentikan build di bawah TRANSLATION_ERROR, dengan menyebutkan config tersebut dan setiap tuple (boundary, node, fragment) yang berkontribusi, termasuk dua fragmen dari satu komponen — entri config selalu membawa konten, sehingga mempertahankan salah satu deklarasi akan membuang file yang ditulis seorang penulis. Jaga agar nama config berbeda di antara semua kontributor pada jalur perakitannya, atau buat deklarasinya identik jika dua kontributor dimaksudkan untuk menyediakan satu file bersama.
  • models: dari artifacts digabungkan ke dalam blok models: tingkat atas, dan referensi models: milik sebuah layanan ikut bersama layanannya, sesuai aturan di Model: dua kontributor yang mendeklarasikan satu nama model harus mendeklarasikannya secara identik, dan setiap referensi harus menyebutkan model yang dideklarasikan oleh suatu kontributor pada jalur perakitan tersebut.
  • networks: dari artifacts ditolak. Provider compose menurunkan jaringan dari anotasi boundary (satu jaringan per anotasi aggrega.ai/namespace yang berbeda, ditambah satu yang dinamai menurut path file compose yang diikuti setiap node tanpa anotasi itu, masing-masing dinamai sesuai Cara nama jaringan diturunkan), sehingga deklarasi jaringan yang disediakan artefak tidak memiliki tempat dalam file hasil perakitan: entri apa pun menghentikan build, dengan menyebutkan entri dan fragmennya, berdasarkan aturan dalam Setiap kunci yang ditulis fragmen dibawa atau ditolak. Hapus entri tersebut dan bentuk jaringan melalui anotasi aggrega.ai/namespace, atau buat layanan bergabung ke jaringan komponen yang disebutkan melalui x-aggrega-networks-of; penulis yang memerlukan perutean lintas jaringan dalam satu file compose menggunakan Feature compose-bridge.
  • Anggota ekstensi dari artifacts dibawa. Kunci x- tingkat atas ditulis setelah bagian-bagian lain file hasil perakitan, dalam urutan penulisannya, berdasarkan aturan dalam Anggota ekstensi dibawa sebagaimana ditulis.
  • Kunci tingkat atas lain apa pun dari artifacts menghentikan build. services:, volumes:, configs:, models: dan anggota ekstensi adalah keseluruhan yang dibawa assembler dari sebuah fragmen. Blok secrets: dan name: tingkat atas masing-masing menghentikan build dengan menyebutkan kunci dan fragmennya, berdasarkan aturan dalam Setiap kunci yang ditulis fragmen dibawa atau ditolak.
  • Isi artifacts: adalah satu dokumen. Isi yang memuat beberapa dokumen YAML menghentikan build dengan menyebutkan fragmen dan jumlah dokumen yang dimuatnya; beri setiap dokumen entri artifacts: tersendiri.

Asimetri antara empat blok pertama dan networks: bersifat struktural: services:, volumes:, configs: dan models: membawa konten per-Recipe yang diakumulasikan assembler ke dalam file hasil perakitan; networks: adalah infrastruktur per boundary yang diturunkan assembler dari status boundary. Artifacts dapat memperluas yang pertama; hanya anotasi boundary yang dapat membentuk yang kedua, itulah sebabnya entri jaringan milik artefak sendiri ditolak. Anggota ekstensi adalah data yang didefinisikan Compose Specification untuk alat lain, sehingga dibawa sebagaimana ditulis. Segala sesuatu yang lain adalah bentuk yang tidak memiliki tempat dalam dokumen hasil perakitan, itulah sebabnya ia ditolak alih-alih digabungkan.

Hal yang tidak disediakan oleh provider compose

  • Perutean L4 lintas jaringan dalam satu file compose. Provider menempatkan setiap node pada jaringannya dan menggabungkan layanan ke jaringan yang disebutkan x-aggrega-networks-of, dan tidak merutekan apa pun antarjaringan dengan sendirinya. Sebuah layanan di jaringan A yang menjangkau layanan di jaringan B dengan cara apa pun selain DNS bawaan docker-compose memerlukan Feature compose-bridge, yang FeatureRecipe-nya menulis gateway dan penulisan ulangnya.
  • Perutean lintas file compose. Boundary yang dievaluasi ke jalur perakitan yang berbeda menghasilkan file docker-compose.yaml yang berbeda; runtime compose memperlakukannya sebagai proyek yang independen, dan Feature compose-bridge membiarkan koneksi antara dua file sebagaimana ditulis. Komunikasi lintas file menjadi urusan operator (memublikasikan port host, berbagi jaringan eksternal, atau menggabungkan boundary ke satu jalur melalui directory: bersama).
  • Mengambil variabel lingkungan dari attachment. Compose tidak memiliki primitif untuk hal ini, sehingga entri attachments pada Workload dengan as: env menghasilkan nama variabel dengan nilai kosong, bukan referensi yang diresolusi saat runtime. Placeholder ini disengaja — variabel yang ada tetapi kosong terlihat oleh siapa pun yang men-debug kontainer, sedangkan variabel yang tidak ada tidak meninggalkan apa pun untuk diperiksa — dan build menyatakannya alih-alih membiarkannya ditemukan sendiri: setiap entri semacam itu memunculkan peringatan unsupported-field yang menyebut entri tersebut pada koordinat penulisannya (containers.<name>.attachments.<KEY>, atau initContainers[<i>].attachments.<KEY>), sehingga penulis mengetahui variabel mana yang tiba dalam keadaan kosong dan kontainer mana pemiliknya. Peringatan ini bersifat anjuran: build tetap berhasil, dan file yang dirender identik byte demi byte dengan file tanpa peringatan tersebut. --no-unsupported-field-warnings membungkam kelas peringatan ini. Entri attachments dengan as: file tidak terpengaruh — compose melakukan bind-mount terhadapnya, dan tidak ada peringatan yang dimunculkan.
  • Konten deploy: mode swarm. Replika, batasan penempatan, dan strategi pembaruan di bawah deploy: adalah fitur mode swarm, dan provider compose hanya menargetkan compose host tunggal, sehingga tidak satu pun dari fitur tersebut dihasilkan. Provider ini tetap menghasilkan deploy.resources — reservasi dan batas yang dipetakan dari resources sebuah kontainer, yang dihormati docker compose dalam mode non-swarm (lihat Sumber daya kontainer).
  • depends_on yang dibatasi kondisi kesehatan dari edge uses. Dependensi yang diturunkan dari edge uses dihasilkan tanpa pembatas, dengan semantik service_started; dependensi ini tidak menunggu healthcheck target melaporkan status sehat. Hal ini berkaitan dengan makna edge uses, bukan dengan bentuk yang tidak dapat dihasilkan provider: bentuk panjang dihasilkan untuk penantian init container, dan gelombang deployment memang menunggu kesehatan target apabila target mendeklarasikan healthcheck.

Contoh penulisan

Deployment compose dengan dua layanan dan sebuah edge depends_on yang diturunkan dari uses:

# release.yaml fragment
spec:
boundaries:
production:
annotations:
aggrega.ai/namespace: prod
components:
api: {}
db: {}
# api Recipe
apiVersion: aggrega.ai/v1beta1
kind: Recipe
metadata:
name: api
version: 1.0.0
spec:
capability: compose
implements: example/compute/api:1.0.0
workload: |
apiVersion: aggrega.ai/v1beta1
kind: Workload
containers:
main:
image: api:1.0
ports:
http: 8080
health:
live:
http: /healthz
services:
public:
type: NodePort
ports:
http: 8080
# Aggregate fragment — api uses db, on a socket api's Component declares
apiVersion: aggrega.ai/v1beta1
kind: Aggregate
spec:
components:
api:
type: example/compute/api:1.0.0
uses:
backend:
db:
target: db
db:
type: example/datastore/db:1.0.0

Provider compose menghasilkan satu docker-compose.yaml pada path boundary yang telah dievaluasi (bawaannya dist/boundaries/production/compose/docker-compose.yaml, karena directory: sebuah boundary secara bawaan bernilai dist/boundaries/<name> dan subDirectory: bernilai {{ .capability }}) yang berisi:

  • services.api (layanan api utama, jaringan prod, port 8080:8080, healthcheck melalui curl, depends_on: [db])
  • services.db (layanan db utama, jaringan prod)
  • networks.prod (jaringan docker milik boundary)