S3 uyumlu nesne deposu — tek bileşen, iki hedef, zorunlu bir anahtar çifti
Bu örnek, tek bir S3 uyumlu nesne deposunu, yani core/storage/s3-object-store bileşenini, kendi barındırılan iki gerçekleştirimine derler:
- yerel geliştirme için
compose/s3-object-storeüzerinden Docker Compose ve - harici chart olmadan Kubernetes üzerinde sentezlenmiş helm Recipe
helm/s3-object-store.
Her ikisi de SeaweedFS’i (Apache-2.0), projesinin yayımladığı chrislusf/seaweedfs imajından, tek bir bucket tutan tek bir sunucu süreci olarak çalıştırır; bucket, sunucu hizmet vermeye başlamadan önce oluşturulur. Aynı bileşen Amazon S3 ve Google Cloud Storage üzerinde başka Recipes tarafından gerçekleştirilir; Manifest hangi gerçekleştirimi seçerse seçsin, tüketici aynı yayımlanmış uç noktayı, bucket’ı ve bölgeyi okur.
Bileşenin iki anahtar yuvası, access_key_id ve secret_access_key, isteğe bağlıdır; çünkü yönetilen bir hizmet bucket’tan anahtar almaz. SeaweedFS bu çifti sunucunun kendi S3 hesabı olarak alır ve onun için bir varsayılanı yoktur; bu nedenle yuvalardan biri boş olduğunda iki gerçekleştirimi de durur. aggregate.yaml hiçbir şey doldurmaz ve derlemenin durduğunu gösterir; diğer iki Aggregates her iki yuvayı da her hedefin onları teslim ettiği biçimde doldurur: Compose yolu için aggregate-auth.yaml (ortam değişkenleri olarak sunulan inject-value kimlik bilgileri) ve sentezlenmiş helm yolu için aggregate-helm-synth-auth.yaml (Kubernetes Secret’ları olarak somutlaştırılan başvurulabilir kimlik bilgileri).
Dosyalar
| Dosya | Rol |
|---|---|
aggregate.yaml | Geliştirici niyeti: media bucket’ını tutan, core/storage/s3-object-store türünde tek bir store bileşeni, ekli anahtar yok — bunun bir derlemesi, boş access_key_id yuvasını adlandırarak durur. |
aggregate-auth.yaml | Her iki anahtarı inject-value kimlik bilgileri olarak eklenmiş aynı depo (Compose yolu). |
aggregate-helm-synth-auth.yaml | Sentezlenmiş helm yolu için her iki anahtarı başvurulabilir kimlik bilgileri olarak eklenmiş aynı depo — her anahtar, StatefulSet’in başvurduğu bir Kubernetes Secret olarak somutlaştırılır. |
manifest-compose.yaml | Depo türünü Compose Recipe’ine (compose/s3-object-store), kimlik bilgisini ise dotenv-secret’e eşler. |
manifest-helm-synth.yaml | Depo türünü sentezlenmiş helm Recipe’ine (helm/s3-object-store), kimlik bilgisini ise k8s-secret-from-parameter’a eşler. |
release-compose.yaml / release-helm-synth.yaml | Hiçbir anahtar eklemeyen aggregate.yaml’ın iki gerçekleştirimi için operatör kayıtları; bu nedenle her derleme durur. |
release-compose-auth.yaml / release-helm-synth-auth.yaml | Her iki yuvayı da dolduran iki Aggregates için operatör kayıtları. |
Neyi gösteriyor
- Tek bileşen, birçok gerçekleştirim. Aggregate bucket’ı adlandırır ve sunucu hakkında hiçbir şey söylemez. Her Manifest depoyu nasıl gerçekleştireceğini söyler; bunun yerine yönetilen bir gerçekleştirimi seçen bir Manifest ise aynı Aggregate’i Amazon S3’e ya da Cloud Storage’a dağıtır.
- Bucket depoyla birlikte gelir. Geliştiricinin
values.bucketdeğeri, deponun tuttuğu ve yayımladığı bucket’tır. Kubernetes’te bir init konteyneri, Compose’da ise bir init hizmeti, sunucu hizmet vermeye başlamadan önce onu oluşturur ve mevcut bir bucket’ı olduğu gibi bırakır; böylece tüketici hiçbir zaman bucket’ı olmayan bir depoyla karşılaşmaz. SeaweedFS’in kabul etmediği bir bucket adı, kuralı adlandırarak derlemeyi durdurur. - Tek birim üzerinde durum bilgili bir sunucu. Kubernetes’te sentezlenmiş Recipe,
/datakonumuna bağlanmış bir birim talebiyle tek kopyalı bir StatefulSet, bir ClusterIP Service ve StatefulSet’in adlandırdığı headless Service işler; Compose’da hizmet aynı yola adlandırılmış bir birim bağlar ve S3 bağlantı noktasını ana makinede yayımlar. - Varsayılanı olmayan zorunlu bir anahtar çifti. Bir hesap mevcut olduğunda SeaweedFS her S3 isteğinde kimlik doğrular; bu nedenle kataloğun her okuyucusunun bildiği bir anahtar onun yerine geçemez. Her Recipe, herhangi bir şey işlenmeden önce boş bir yuvada durur ve yuvayı ve neyin ekleneceğini adlandırır. Eklenen çift sunucunun hesabı olur ve gizli anahtar aynı zamanda sunucunun filer imzalama anahtarıdır; bu nedenle S3 bağlantı noktasının yanındaki gRPC bağlantı noktası da kimliği doğrulanmamış hiçbir değişikliği kabul etmez.
- Bir tüketicinin okudukları. Depo
bucket,endpoint(Kubernetes’tehttp://store-default:8333, Compose’dahttp://store:8333),host,port8333,protocols3veregionus-east-1değerlerini yayımlar; bu bölge, S3 istemcilerinin bölge bildirmeyen bir sunucudan okuduğu bölgedir. Ona bağlanan bir tüketici S3 istemcisini uç noktaya yöneltir ve kendi bağlantısında bir anahtar çifti sunar.
Ö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:
aggrega scaffold --example s3-object-storeArdından sırada çalıştırılacak komutları yazdırır. İlki yeni klasöre geçer:
cd s3-object-storeDerleme
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:
# Local development (Docker Compose)aggrega build --release release-compose-auth.yaml --auto-pull
# Kubernetes (synthesized helm Recipe)aggrega build --release release-helm-synth-auth.yaml --auto-pullİşlenen yapıtlar dist/ altına yerleşir.
Hiçbir anahtar eklemeyen aggregate.yaml’ı derlemek, her iki hedefte de herhangi bir şey işlenmeden önce durur:
aggrega build --release release-helm-synth.yaml --auto-pull[… omitted: the pull's lines, which report the same halt, and a lint notice][CATALOG_ERROR E0033] Recipe/FeatureRecipe assertions caused by: Recipe "s3-object-store" instance "store" assertion "key_slots_filled": assertion "Recipe/s3-object-store/store/key_slots_filled": template: Recipe/s3-object-store/store/key_slots_filled:1:138: executing "Recipe/s3-object-store/store/key_slots_filled" at <fail (printf "the %s slot is empty, and SeaweedFS takes the access_key_id and secret_access_key pair as the account its S3 API authenticates every request by, so there is no default for either: attach a referenceable credential, such as core/referenced-secret, to %s" $slot $slot)>: error calling fail: assertion failed: the access_key_id slot is empty, and SeaweedFS takes the access_key_id and secret_access_key pair as the account its S3 API authenticates every request by, so there is no default for either: attach a referenceable credential, such as core/referenced-secret, to access_key_idrelease-compose.yaml aynı doğrulamada durur ve çözüm önerisi Compose yolunun aldığı biçimi adlandırır: “attach a credential to access_key_id delivering AWS_ACCESS_KEY_ID, such as core/secret-value with key AWS_ACCESS_KEY_ID and its origin a Compose variable reference such as ${AWS_ACCESS_KEY_ID}” (access_key_id’ye AWS_ACCESS_KEY_ID teslim eden bir kimlik bilgisi ekleyin; örneğin anahtarı AWS_ACCESS_KEY_ID olan ve origin’i ${AWS_ACCESS_KEY_ID} gibi bir Compose değişken başvurusu olan core/secret-value). Düzeltme, diğer iki Aggregates’in attığı adımdır: store bileşeninde features.access_key_id ve features.secret_access_key alanlarının her birinin altına bir kimlik bilgisi eklemek.
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 bir `s3-object-store` klasörü yoksa `scaffold` aracını `example` değeri `s3-object-store` olarak ayarlanmış ve `dir` olmadan bir kez çağırın: örneği yeni bir `s3-object-store` klasörüne yazar. Ardından `build` aracını her Release için bir kez, şu sırayla çağırın — `release-compose-auth.yaml` ve `release-helm-synth-auth.yaml` —, her seferinde `workspace_root` değeri `s3-object-store`, `release` değeri o dosya, `auto_pull` değeri true ve `write` değeri true olacak şekilde. Ardından `build` aracını aynı şekilde, `release` değeri `release-helm-synth.yaml` olarak çağırın: bu çağrının reddedilmesi beklenir, bu yüzden ret mesajını bana okuyun. İlk iki derlemenin hangi dosyaları yazdığını bana söyleyin; bunlar `s3-object-store/dist/` altındadır.Kimlik bilgisi teslimi notu
Compose yolunda her anahtar bir inject-value gizlisidir (aggregate-auth.yaml): değeri, bileşenin ortam hattı üzerinden values.key alanının adlandırdığı değişken olan AWS_ACCESS_KEY_ID veya AWS_SECRET_ACCESS_KEY altında teslim edilir; bunlar Recipe’in sunucuya verdiği değişkenlerdir ve başka herhangi bir ad altında teslim eden bir ek, yuvayı adlandırarak derlemeyi durdurur. Her origin bir Compose değişken başvurusudur; bu nedenle işlenen dosya anahtarı değil başvuruyu taşır:
environment: AWS_ACCESS_KEY_ID: ${S3_ACCESS_KEY_ID} AWS_SECRET_ACCESS_KEY: ${S3_SECRET_ACCESS_KEY} WEED_JWT_FILER_SIGNING_KEY: ${S3_SECRET_ACCESS_KEY}Sentezlenmiş helm yolu başvurulabilir kimlik bilgileri kullanır (aggregate-helm-synth-auth.yaml): her anahtar, bileşen ve yuvaya göre adlandırılmış bir Kubernetes Secret olarak somutlaştırılır ve StatefulSet ona bir env secretKeyRef aracılığıyla başvurur; bu nedenle anahtarların hiçbiri StatefulSet manifestinde görünmez — yalnızca Secret’larda bulunur:
env: - name: AWS_ACCESS_KEY_ID valueFrom: secretKeyRef: name: store-access-key-id key: access-key-id - name: AWS_SECRET_ACCESS_KEY valueFrom: secretKeyRef: name: store-secret-access-key key: secret-access-key - name: WEED_JWT_FILER_SIGNING_KEY valueFrom: secretKeyRef: name: store-secret-access-key key: secret-access-keyaggregate-helm-synth-auth.yaml içindeki origin değerleri geliştirme amaçlı yer tutuculardır ve üretilen Secret’lara olduğu gibi yazılır. Gerçek trafik taşıyan bir Release için bunun yerine core/referenced-secret’i k8s-existing-secret’e eşleyin; her origin, ad alanında zaten var olan ve anahtarı ekin key alanı altında tutan bir Secret’ı adlandırsın.
Çalıştırın (Compose)
aggrega build --release release-compose-auth.yaml --auto-pullexport S3_ACCESS_KEY_ID=<an access key identifier of your choosing>export S3_SECRET_ACCESS_KEY=<a secret key of your choosing>docker compose -f dist/app/compose/docker-compose.yaml up -dBucket hizmeti media’yı oluşturduktan sonra S3 API’si http://localhost:8333 adresinde yanıt verir. Dışa aktarılan anahtar çifti ve us-east-1 bölgesiyle herhangi bir S3 istemcisini bu adrese yöneltin. Kaldırmak için docker compose -f dist/app/compose/docker-compose.yaml down komutunu kullanın.