Entitas berdasarkan peran
Setiap jenis entitas memiliki peran yang biasanya menulisnya. Halaman ini adalah peta lengkapnya — gunakan saat Anda tahu kepentingan Anda tetapi belum tahu di file mana tempatnya. Penetapan peran adalah panduan, bukan penegakan oleh compiler (lihat Persona); penetapan ini menyebut siapa yang biasanya memiliki sebuah jenis dalam penyiapan yang terfaktorisasi dengan baik.
Peta sekilas
| Peran | Jenis entitas | Kepentingan |
|---|---|---|
| Developer | Aggregate | Intensi aplikasi: apa aplikasinya dan apa yang dibutuhkannya |
| Arsitek platform | Component, Feature | Kontrak katalog yang dapat digunakan ulang dan berversi |
| Operasi platform | Recipe, FeatureRecipe, Plugin perender provider | Penerjemahan khusus Provider ke infrastruktur yang dirender |
| Operator platform | Manifest, Release | Routing dan perangkaian deployment |
| Dukungan lintas sektoral | SchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibrary, Plugin, Workload | Bentuk bersama, kode ekstensi, dan jenis compiler milik platform |
Developer
Aggregate — satu-satunya permukaan penulisan developer dan satu-satunya sumber kebenaran untuk topologi aplikasi. Aggregate mendeklarasikan komponen-komponen yang membentuk aplikasi, values yang diterima setiap komponen, Features yang perilakunya merupakan intensi aplikasi (beserta values-nya), parameters yang diekspos untuk variasi per lingkungan, dan sisi uses yang merangkai komponen satu sama lain. Aggregate sengaja tetap agnostik terhadap infrastruktur fisik: tidak ada apa pun dalam Aggregate yang menyebut cloud, cluster, atau provider. Keagnostikan terhadap kapabilitas inilah yang memungkinkan satu Aggregate di-deploy di mana saja.
Arsitek platform
Component — kontrak yang dapat digunakan ulang dan berversi untuk satu jenis blok bangunan. Component mendeklarasikan, melalui JSON Schema, values yang boleh diberikan developer; output provides yang disalurkannya ke konsumen; dan soket usesSchema yang diekspos untuk perangkaian. Components membawa label semantik yang menggerakkan kebijakan dan render. Arsitek menjaga kontrak Component tetap stabil agar developer dapat mengandalkannya.
Feature — kapabilitas yang dapat dilampirkan yang dapat ditambahkan developer atau operator ke sebuah komponen: exporter metrik, penyamaran teks sensitif pada gateway AI, binding kredensial. Feature mendeklarasikan apa yang dibutuhkannya dan apa yang tidak kompatibel dengannya; cara Feature direalisasikan — sumber daya yang dihasilkannya, atau pengaturan yang ditulisnya ke dalam apa yang sudah dirender komponennya — berada di FeatureRecipe-nya.
Operasi platform
Recipe — realisasi khusus provider dari sebuah Component. Recipe memetakan nilai yang dideklarasikan Component ke output provider konkret — release Helm, layanan Compose, modul Terraform — melalui template, dan menyalurkan nilai provides ke konsumen. Recipe tidak pernah mengubah nilai yang dihadapi developer yang dideklarasikan sebuah Component; Recipe hanya menentukan bagaimana nilai tersebut dirender.
FeatureRecipe — realisasi khusus provider dari sebuah Feature, diterapkan pada waktu binding. FeatureRecipe menghasilkan sumber daya yang tersirat dari lampiran sebuah Feature untuk provider tertentu, atau menulis pengaturan yang tersirat ke dalam apa yang sudah dirender oleh komponen yang dilampiri.
Plugin perender Provider — provider adalah guest Wasm yang mengubah input sebuah Recipe menjadi manifes native provider. Provider dikirimkan sebagai Plugin dengan pluginType: provider yang mendeklarasikan nama provider yang direndernya dan kontrak soket provider-nya. Operasi (atau penulis plugin) menyediakan provider agar Recipes memiliki provider untuk merender. Lihat Ikhtisar Providers untuk provider yang disertakan dan kontraknya.
Membaca kredensial dengan aman dalam Recipe
Kredensial mencapai Recipe melalui pipa inject, .context.inject.env, sebagai teks apa pun yang dipilih penulisnya, sehingga kredensial itu dapat memuat karakter yang tidak dapat ditulis template ke dalam YAML apa adanya. Di dalam skalar berkutip ganda, tanda kutip ganda mengakhiri nilai lebih awal dan garis miring terbalik memulai escape: build berhenti, atau garis miring terbalik itu hilang tanpa pemberitahuan. Lakukan escape pada keduanya di tempat nilai ditulis:
variables: {{- $env := optional (default dict .context.inject) "env" dict }} DB_PASSWORD: "{{ optional $env "DB_PASSWORD" "" | replace "\\" "\\\\" | replace "\"" "\\\"" }}"optional membaca kunci dari map milik pipa dengan fallback kosong, sehingga kata sandi yang tidak dikirim oleh apa pun dirender sebagai teks kosong. Kedua panggilan replace melakukan escape pada garis miring terbalik terlebih dahulu, lalu pada tanda kutip, dalam urutan itu agar escape milik tanda kutip tidak di-escape lagi, dan membiarkan setiap karakter lain seperti semula. Nilai yang dibaca melalui index, yang berhenti ketika kunci tidak ada, menerima dua panggilan replace yang sama tanpa perubahan.
Satu karakter yang tidak dapat dibawa bentuk ini adalah jeda baris. YAML melipat jeda baris di dalam skalar berkutip ganda menjadi spasi, sehingga kredensial yang memuatnya dikirim dengan spasi di tempat jeda itu berada. FeatureRecipe yang menulis kredensial ke dalam injectMapping miliknya menuliskannya melalui toJson sebagai gantinya, yang membawa tanda kutip, garis miring terbalik, dan jeda baris dengan sama baiknya, seperti yang ditunjukkan referensi FeatureRecipe.
FeatureRecipe tersebut menulis kredensial di bawah mekanisme tempat Recipe membacanya — env: untuk .context.inject.env, file:, arg:, atau mekanisme milik komponen itu sendiri dengan namanya sendiri. .context.inject.all dibangun dari mekanisme-mekanisme tersebut dan tidak pernah dari output sebuah mapping, sehingga mapping yang menulis di bawah all: tidak akan mengirimkan apa pun; sebagai gantinya, build berhenti karenanya, dengan menyebut lampiran, kunci, dan FeatureRecipe tersebut.
Operator platform
Manifest — lapisan routing. Manifest memberi tahu compiler Recipe mana yang merealisasikan setiap Component untuk target tertentu, sehingga Aggregate yang sama dapat diarahkan ke implementasi berbeda di berbagai lingkungan — Recipe cloud untuk produksi, Recipe Compose untuk pengujian lokal — tanpa perubahan apa pun pada file developer.
Release — satu-satunya input kompilasi, yang mencatat apa yang di-build oleh satu lingkungan. Release menunjuk ke Aggregate dan Manifest, memenuhi parameters yang diekspos developer, melampirkan Features yang input-nya bersifat operasional, menentukan ukuran dengan infra untuk Features yang dilampirkan developer, dan merangkai sisi miliknya sendiri di dalam soket yang dideklarasikan arsitek. Release memenuhi titik variasi yang diekspos; Release tidak dapat memperkenalkan values aplikasi baru atau komputasi baru — keduanya hanya berasal dari Aggregate.
Jenis dukungan lintas sektoral
Jenis-jenis ini melayani penulis lintas peran alih-alih menjadi milik satu peran.
SchemaLibrary — pustaka bersama berisi bentuk skema yang berulang di banyak Components dan Features. Ketika struktur yang sama (misalnya blok sumber daya pod) muncul di banyak entitas, arsitek memfaktorkannya ke dalam entri SchemaLibrary agar didefinisikan dan diperbarui sekali saja.
MappingLibrary — pustaka bersama berisi logika pemetaan yang dapat digunakan ulang yang dimanfaatkan oleh Recipes dan FeatureRecipes, sehingga pola terjemahan umum memiliki satu sumber alih-alih disalin.
WorkloadLibrary — pustaka bersama berisi konten Workload yang dapat digunakan ulang, sehingga bentuk deployment yang berulang di banyak Recipes dideklarasikan sekali dan diimpor ke setiap blok workload:.
ArtifactLibrary — pustaka bersama berisi bundle artefak yang dapat digunakan ulang: kumpulan bernama file output tambahan yang saling terkait, seperti CRD beserta RBAC-nya. Sebuah Recipe atau FeatureRecipe mengimpor bundle pada satu entri artifacts: dan mengeluarkan setiap file di dalamnya.
Plugin — jenis ekstensi. Selain render provider, Plugins mengemas kode WebAssembly yang menyediakan kecerdasan khusus domain — validasi kebijakan, mutasi, linting, dan soket lainnya. Penulisan Plugin adalah urusan tim platform yang mendukung setiap peran lainnya.
Workload — jenis compiler milik platform, bukan file yang ditulis secara manual oleh developer atau operator sebagai entitas tingkat atas. Workload dikonsumsi di dalam blok workload: milik sebuah Recipe, tempat provider yang digunakan Recipe untuk merender menerjemahkan bentuk workload yang dinormalisasi ke bentuk native-nya. Penulis Recipe berinteraksi dengannya melalui blok tersebut; referensi Workload mendokumentasikan bentuknya.
Selanjutnya
- Menulis file Aggrega — siklus penulisan, dari awal hingga akhir.
- Persona — peran di balik peta ini.