Memcached — satu Aggregate, dua target, dan kata sandi yang ditolak
Contoh ringkas ini mengompilasi satu cache dalam memori Memcached dari satu Aggregate yang ditulis oleh Developer menjadi dua realisasi:
- Docker Compose untuk pengembangan lokal, dan
- Recipe helm tersintesis yang menjalankan image upstream resmi
memcachedsecara langsung di Kubernetes (tanpa chart eksternal).
Recipe helm tersintesis adalah jalur Kubernetes yang diutamakan: jalur ini hanya bergantung pada tag image resmi, bukan chart pihak ketiga, dan kumpulan resource yang dirender persis sama dengan yang dideklarasikan workload.
aggregate.yaml yang sama menggerakkan keduanya. Hanya lapisan Recipe yang dipilih oleh Manifest yang berubah per realisasi. Dua Aggregate lainnya melampirkan kata sandi ke cache, dan Releases-nya adalah contoh negatif: build berhenti, karena tidak ada realisasi yang dapat menegakkan kata sandi Memcached.
Berkas
| Berkas | Peran |
|---|---|
aggregate.yaml | Maksud Developer: satu komponen cache bertipe core/datastore/memcached, tanpa kredensial — cache berjalan tanpa autentikasi. |
aggregate-auth.yaml | Cache yang sama dengan kredensial kata sandi inject-value yang dilampirkan ke slot opsional password milik komponen (jalur Compose). Build-nya berhenti. |
aggregate-helm-synth-auth.yaml | Cache yang sama dengan kredensial kata sandi yang dapat direferensikan, dilampirkan untuk jalur helm tersintesis. Build-nya berhenti. |
manifest-compose.yaml | Memetakan tipe Memcached ke Recipe Compose (compose/memcached) dan kredensial ke dotenv-secret. |
manifest-helm-synth.yaml | Memetakan tipe Memcached ke Recipe helm tersintesis (helm/memcached) dan kredensial ke k8s-secret-from-parameter. |
release-compose.yaml / release-helm-synth.yaml | Record Operator untuk kedua realisasi. |
release-negative-compose-auth.yaml / release-negative-helm-synth-auth.yaml | Catatan operator atas dua Aggregate berkata sandi. Setiap build diharapkan gagal. |
Apa yang didemonstrasikan
- Satu permukaan penulisan, banyak target. Satu Aggregate menjadi sumber kebenaran tentang apa stack tersebut. Setiap Manifest menyatakan bagaimana merealisasikannya.
- Datastore tanpa status. Memcached menyimpan entri di memori dan tidak menyimpan
apa pun secara permanen, sehingga komponen diberi tipe
serverbiasa, bukanstateful-server. Di Kubernetes, Recipe merender Deployment, bukan StatefulSet, dan tidak meminta persistent volume; di Compose, service tidak mendeklarasikan volume data. - Sintesis Workload (Kubernetes). Recipe helm tersintesis mendeklarasikan Workload — sebuah Deployment ditambah Service ClusterIP yang menjalankan image resmi
memcached— yang diterjemahkan oleh provider helm menjadi manifest Kubernetes tanpa chart eksternal. Kumpulan resource yang dirender persis sama dengan yang dideklarasikan Workload. Karena Recipe Compose dan Recipe helm tersintesis sama-sama bernamamemcached, Manifests merujuknya dengan cakupan provider sebagaicompose/memcacheddanhelm/memcached. - Perlindungan yang tidak dapat diberikan sebuah realisasi akan ditolak, bukan diabaikan. Komponen ini mendeklarasikan slot opsional
password. Imagememcachedtidak menegakkan kata sandi apa pun: dua mode autentikasinya adalah SASL, yang hanya digunakan melalui protokol biner, dan berkas autentikasi ASCII, sementara klien Memcached di katalog tidak menggunakan keduanya. Recipe yang menerima lampiran tersebut akan merender cache yang menjawab setiap klien sementara Aggregate menyatakan cache itu terlindungi, sehingga setiap Recipe justru menghentikan build dan menyebut slot tersebut.
Membuat contoh
Anda dapat mem-build contoh ini dengan perintah di bawah, atau meminta asisten AI Anda mem-build-nya untuk Anda.
Tulis contoh ke folder baru yang dinamai sesuai contoh itu:
aggrega scaffold --example memcached-cacheKemudian ia mencetak perintah yang dijalankan berikutnya. Perintah pertama berpindah ke folder baru:
cd memcached-cacheBuild
Workspace ini tidak memuat .aggrega-config.yaml, sehingga entitas pustaka standar di-resolve dari registry hub, hub.aggrega.ai, dan flag katalog tidak diperlukan; --auto-pull menulis lockfile yang tidak dimiliki clone baru selama build:
# Local development (Docker Compose)aggrega build --release release-compose.yaml --auto-pull
# Kubernetes (synthesized helm Recipe, official image)aggrega build --release release-helm-synth.yaml --auto-pullArtefak yang dirender ditempatkan di bawah dist/.
Dengan asisten AI
Asisten AI yang disiapkan dengan tool Aggrega dapat melakukan hal yang sama: tempelkan prompt ini ke asisten tersebut.
Gunakan hanya alat Aggrega, dan jangan membuat folder sendiri. Jika folder ruang kerja belum berisi folder `memcached-cache`, panggil alat `scaffold` sekali dengan `example` diatur ke `memcached-cache` dan tanpa `dir`: alat ini menulis contoh ke folder `memcached-cache` yang baru. Kemudian panggil alat `build` sekali untuk setiap Release, dengan urutan ini — `release-compose.yaml` dan `release-helm-synth.yaml` — setiap kali dengan `workspace_root` diatur ke `memcached-cache`, `release` diatur ke file tersebut, `auto_pull` diatur ke true, dan `write` diatur ke true. Beri tahu saya file mana yang ditulis oleh setiap build; file tersebut berada di bawah `memcached-cache/dist/`.Kontrol: kata sandi yang tidak dapat ditegakkan oleh cache
Dua Release negatif mem-build Aggregate berkata sandi, dan setiap build diharapkan gagal:
aggrega build --release release-negative-compose-auth.yaml --auto-pullaggrega build --release release-negative-helm-synth-auth.yaml --auto-pullMasing-masing berhenti di Recipe Memcached, sebelum apa pun ditulis, dan penghentian itu diakhiri dengan pesan milik Recipe itu sendiri:
a password is attached to the password slot of "cache", but the memcachedimage this Recipe runs cannot enforce a password: it authenticates only throughSASL over the binary protocol or an ASCII authentication file, which thecatalog's Memcached clients do not use, so the cache would accept every clientanyway; remove the attachment, and restrict who can reach the cache through itsnetworkPenolakan didasarkan pada lampiran itu sendiri, bukan pada cara kredensial dikirim, sehingga setiap Feature yang dapat mengisi slot berhenti dengan cara yang sama. Realisasi terkelola berperilaku serupa: Amazon ElastiCache tidak menawarkan autentikasi Memcached, dan Recipes-nya juga berhenti pada lampiran tersebut. Oleh karena itu, cache Memcached dilindungi oleh siapa yang dapat menjangkaunya — jaringan tempat cache ditempatkan — dan bentuk yang perlu di-build adalah aggregate.yaml dasar.