İçeriğe geç
AggregaAggrega
Dil seçin: Türkçe
Bu sayfa makine çevirisiyle çevrilmiştir. İngilizce orijinalini okuyun.

APISIX yığını — modül olarak oluşturulmuş dinamik bir API ağ geçidi

Bu örnek, küçük ve gerçek bir yığını — bir dinamik API ağ geçidini — Developer tarafından yazılmış tek bir Aggregate’ten sentezlenmiş Kubernetes manifestlerine derler.

Ağ geçidi tek bir bileşen değildir. Bir modüldür: iki tek iş yüklü bileşeni bir araya getiren, yeniden kullanılabilir bir alt aggregate —

  • istemci trafiğini proxy portunda sonlandıran ve yerel durum tutmayan bir ağ geçidi ve
  • ağ geçidinin yapılandırmasını tutan ve bunu bir birimde kalıcı olarak saklayan bir depo, etcd.

Modül, ağ geçidinden depoya giden kendi iç kenarını bağlar ve ağ geçidini proxy genel uç noktası olarak dışa aktarır. Üst düzey Aggregate, modülü adıyla içe aktarır ve oluşturulan yığını işler; operatör, modülün iç bileşenlerini Release’te boyutlandırır.

Dosyalar

DosyaRol
aggregate.yamlDeveloper amacı: API ağ geçidi modülünü (core/apisix) içe aktarır ve ona ağ geçidinin Admin API anahtarını kendi parametrelerinden birinden iletir.
manifest-helm-synth.yamlAğ geçidi ve depo türlerini synth helm Recipes’ine, modülün eklediği kimlik bilgisi Feature’ını da namespace’te zaten bulunan bir Secret’ı okuyan gerçekleştirmeye eşler.
release-helm-synth.yamlKubernetes hedefi için operatör kaydı. Admin API anahtarını tutan Secret’ı adlandırır ve modülün iç bileşenlerini modül kapsamlı kimlikleriyle boyutlandırır; geri kalan her şey şema varsayılanlarına bırakılır.

Neyi gösteriyor

  • Modül olarak bileşim. Çok iş yüklü bir yetenek — aslında bir proxy ile bir yapılandırma deposundan oluşan bir API ağ geçidi — tek bir yekpare bileşen olarak değil, iki tek iş yüklü bileşeni bir araya getiren bir alt aggregate olarak paketlenir. Modül adıyla içe aktarılır ve ağ geçidi gereken her yerde yeniden kullanılır.
  • Modül içinde bir iç kenar. Ağ geçidi, depoyu kullandığını bildirir; depo Recipe’inin provides ana makinesi ve portu ağ geçidine aktarılır ve onun etcd bağlantısında birleştirilir. Derleyici bu dizeleri yorumlamadan yönlendirir.
  • Genel bir uç nokta. Modül, ağ geçidini proxy olarak dışa aktarır; bu, bir tüketicinin bağlandığı kararlı genel addır — modülün iç bileşen adlarından bağımsızdır.
  • İç bileşenlerin operatör tarafından boyutlandırılması. Release, işlem kaynaklarını ayarlamak için modülün iç bileşenlerini modül kapsamlı kimlikleriyle (gateway.store, gateway.gateway) adresler; geliştiricinin Aggregate’inin fiziksel boyutlandırmayı yeniden belirtmesi gerekmez.
  • Çalışma zamanında yazılan dosyaların yanına bağlanan bir yapılandırma dosyası. Ağ geçidi, yapılandırmasını başlangıçta kendisinin de yazdığı bir dizindeki bir dosyadan okur. Recipe bu yapılandırmayı bir ConfigMap olarak üretir ve tek bir dosya olarak bağlar; böylece ağ geçidinin oraya yazdığı dosyaları gizlemeden ağ geçidini yapılandırır.
  • Bir Secret’tan okunan Admin API anahtarı. Ağ geçidi rotalarını bir Admin API üzerinden yönetir ve anahtarı ağ geçidindeki bir kimlik bilgisi yuvası aracılığıyla gelir; buradaki gibi models soketine hiçbir şey bağlı değilken ağ geçidi bu yuvayı zorunlu tutar, bu nedenle varsayılan bir anahtar yoktur. Modül anahtarı admin_key parametresi olarak alır ve core/referenced-secret kimlik bilgisi Feature’ını bununla yuvaya ekler; bu Aggregate kendi parametresini bildirip aşağı iletir ve Release onu karşılar. Manifest, Feature’ı k8s-existing-secret’a eşler; böylece değer, namespace’te zaten bulunan bir Secret’ın adıdır: derleme hiçbir anahtar okumaz ve işlemez, ağ geçidi anahtarı başlarken o Secret’tan okur. Değer sağlamayan bir Release, parametreyi adlandırarak derlemeyi durdurur.
  • Yeniden üretilebilir imajlar. Hem ağ geçidi hem de depo açık imaj etiketlerini sabitler; böylece işlenen manifestler kararlı imajlara başvurur.

Örneği oluşturun

Bu örneği aşağıdaki komutlarla derleyebilir ya da yapay zekâ asistanınıza sizin için derletebilirsiniz.

Örneği, adını taşıyan yeni bir klasöre yazın:

Terminal window
aggrega scaffold --example apisix-stack

Ardından sırada çalıştırılacak komutları yazdırır. İlki yeni klasöre geçer:

Terminal window
cd apisix-stack

Derleme

Bu çalışma alanında .aggrega-config.yaml bulunmaz; bu nedenle standart kütüphane varlıkları hub kayıt defteri hub.aggrega.ai üzerinden çözümlenir ve katalog bayrağına gerek yoktur; --auto-pull, yeni bir klonda eksik olan kilit dosyasını derleme sırasında yazar:

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

İşlenen yapıtlar dist/ altına yerleşir. Kubernetes hedefi düz manifestleri çevrimdışı işler — chart çekmek gerekmez.

Bunları uygulamadan önce, Release’in adlandırdığı apisix-admin-key Secret’ını hedef namespace’te, admin-key veri anahtarı altında kendi anahtarınızı tutacak şekilde oluşturun. Anahtar boş olmamalıdır, çünkü bu ağ geçidini başlangıçta durdurur; ayrıca APISIX’in sayı ya da true veya false olarak okuduğu bir değer, örneğin yalnızca rakamlardan oluşan bir anahtar olmamalıdır, çünkü APISIX bu durumda onu bir isteğin sunduğu anahtarla hiçbir zaman eşleştirmez.

Bir yapay zekâ asistanıyla

Aggrega araçlarıyla kurulmuş bir yapay zekâ asistanı da aynısını yapabilir: bu istemi ona yapıştırın.

Yalnızca Aggrega araçlarını kullanın ve kendiniz hiçbir klasör oluşturmayın. Çalışma alanı klasöründe henüz `apisix-stack` klasörü yoksa `scaffold` aracını `example` değeri `apisix-stack` olarak ayarlanmış ve `dir` olmadan bir kez çağırın: örneği yeni bir `apisix-stack` klasörüne yazar. Ardından `build` aracını `workspace_root` değeri `apisix-stack`, `release` değeri `release-helm-synth.yaml`, `auto_pull` değeri true ve `write` değeri true olarak ayarlanmış şekilde çağırın. Derlemenin hangi dosyaları yazdığını bana söyleyin; dosyalar `apisix-stack/dist/` altındadır.

Oluşturulan yığın nasıl görünür

Ağ geçidi, durum bilgisi olmayan bir Deployment ile proxy portunda bir ClusterIP Service olarak işlenir. Yapılandırması, kapsayıcının conf dizinine tek bir dosya olarak bağlanan bir ConfigMap olarak teslim edilir; yapılandırma, deponun küme içi Service adını ve Admin API anahtarının yerinde, APISIX’in dosyayı yüklerken anahtarı okuduğu ortam değişkeninin adını taşır:

apisix:
node_listen: 9080
deployment:
role: traditional
role_traditional:
config_provider: etcd
admin:
[… omitted: the client range the Admin API accepts]
admin_key:
- name: admin
key: ${{APISIX_ADMIN_KEY}}
role: admin
admin_listen:
ip: 0.0.0.0
port: 9180
etcd:
host:
- "http://gateway-zdstore-default:2379"
prefix: "/apisix"
timeout: 30

Deployment bu değişkeni Secret’tan sağlar, böylece anahtar işlenen hiçbir dosyada görünmez:

env:
- name: APISIX_ADMIN_KEY
valueFrom:
secretKeyRef:
name: apisix-admin-key
key: admin-key

Depo, /etcd-data konumuna bağlanan kalıcı bir birime sahip bir StatefulSet ile bir ClusterIP Service ve bir headless Service olarak işlenir.