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

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 memcached secara 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

BerkasPeran
aggregate.yamlMaksud Developer: satu komponen cache bertipe core/datastore/memcached, tanpa kredensial — cache berjalan tanpa autentikasi.
aggregate-auth.yamlCache 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.yamlCache yang sama dengan kredensial kata sandi yang dapat direferensikan, dilampirkan untuk jalur helm tersintesis. Build-nya berhenti.
manifest-compose.yamlMemetakan tipe Memcached ke Recipe Compose (compose/memcached) dan kredensial ke dotenv-secret.
manifest-helm-synth.yamlMemetakan tipe Memcached ke Recipe helm tersintesis (helm/memcached) dan kredensial ke k8s-secret-from-parameter.
release-compose.yaml / release-helm-synth.yamlRecord Operator untuk kedua realisasi.
release-negative-compose-auth.yaml / release-negative-helm-synth-auth.yamlCatatan 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 server biasa, bukan stateful-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 bernama memcached, Manifests merujuknya dengan cakupan provider sebagai compose/memcached dan helm/memcached.
  • Perlindungan yang tidak dapat diberikan sebuah realisasi akan ditolak, bukan diabaikan. Komponen ini mendeklarasikan slot opsional password. Image memcached tidak 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:

Terminal window
aggrega scaffold --example memcached-cache

Kemudian ia mencetak perintah yang dijalankan berikutnya. Perintah pertama berpindah ke folder baru:

Terminal window
cd memcached-cache

Build

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:

Terminal window
# 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-pull

Artefak 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:

Terminal window
aggrega build --release release-negative-compose-auth.yaml --auto-pull
aggrega build --release release-negative-helm-synth-auth.yaml --auto-pull

Masing-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 memcached
image this Recipe runs cannot enforce a password: it authenticates only through
SASL over the binary protocol or an ASCII authentication file, which the
catalog's Memcached clients do not use, so the cache would accept every client
anyway; remove the attachment, and restrict who can reach the cache through its
network

Penolakan 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.