Przejdź do głównej zawartości
AggregaAggrega
Wybierz język: Polski
Ta strona została przetłumaczona maszynowo. Przeczytaj oryginał w języku angielskim.

Wielokluczowe poświadczenia w syntetyzowanym Deployment helm

Pojedyncza bezstanowa aplikacja renderowana w Kubernetes przez syntezę encji Workload dostawcy helm — bez zewnętrznego chartu. Aplikacja odczytuje dwa klucze danych z jednego sekretu: nazwę użytkownika i hasło. Oba obsługuje jeden slot poświadczeń, wypełniony wieloklucznym poświadczeniem, do którego można się odwoływać.

Generowanie przykładu

Ten przykład można zbudować za pomocą poniższych poleceń albo zlecić jego zbudowanie asystentowi AI.

Należy zapisać przykład w nowym folderze nazwanym tak jak on:

Terminal window
aggrega scaffold --example multikey-secret-synth

Następnie wypisuje polecenia do uruchomienia w dalszej kolejności. Pierwsze przechodzi do nowego folderu:

Terminal window
cd multikey-secret-synth

Kompilacja

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

Katalog jest rozwiązywany z dwóch źródeł wskazanych w .aggrega-config.yaml: własnego katalogu przykładu ./catalog (encja Component local/compute/app i jej syntetyzujący Recipe helm/app) oraz rejestru hub (Feature wieloklucznego poświadczenia, jego FeatureRecipe i Provider helm). --auto-pull zapisuje podczas budowania plik blokady, którego brakuje świeżemu klonowi. Trzy manifesty trafiają do dist/helm/helm/.

Z asystentem AI

Asystent AI skonfigurowany z narzędziami Aggrega może zrobić to samo: wystarczy wkleić mu ten prompt.

Używaj wyłącznie narzędzi Aggrega i nie twórz samodzielnie żadnego folderu. Jeśli folder obszaru roboczego nie zawiera jeszcze folderu `multikey-secret-synth`, wywołaj raz narzędzie `scaffold` z `example` ustawionym na `multikey-secret-synth` i bez `dir`: zapisuje ono przykład w nowym folderze `multikey-secret-synth`. Następnie wywołaj narzędzie `build` z `workspace_root` ustawionym na `multikey-secret-synth`, `release` ustawionym na `release.yaml`, `auto_pull` ustawionym na true i `write` ustawionym na true. Podaj, które pliki zapisała kompilacja; znajdują się w `multikey-secret-synth/dist/`.

Jeden slot, dwa klucze

Encja Component deklaruje jeden przezroczysty slot poświadczeń, app_credentials (inject: [env]). Encja Aggregate wypełnia go za pomocą core/referenced-secret-set — wieloklucznego poświadczenia, do którego można się odwoływać; materializuje ono jeden Secret Kubernetes zawierający zestaw kluczy danych dostarczony przez wywołującego i publikuje tylko lokalizator tego Secretu (provides.name). Tutaj wywołujący dostarcza dwa klucze:

aggregate.yaml
features:
app_credentials:
type: core/referenced-secret-set
values:
entries:
- key: db_username
value: appuser
- key: db_password
value: dev-pw-change-me

Encja Manifest mapuje core/referenced-secret-set na FeatureRecipe k8s-secret-set, który renderuje jeden Secret zawierający oba klucze:

app--app-zucredentials--app-secret-app-app-credentials.yaml
[… omitted: the apiVersion and the Secret kind]
metadata:
name: app-app-credentials
[… omitted: the labels and annotations every rendered document carries]
stringData:
db_username: "appuser"
db_password: "dev-pw-change-me"

Odwoływanie się do jednego slotu przez każdy klucz

Syntetyzujący Recipe odwołuje się do tego samego slotu dwukrotnie — raz na każdy klucz danych. Każdy wpis wskazuje odczytywany klucz danych przez pole key; kluczem mapy wpisu jest nazwa zmiennej środowiskowej:

# helm/app recipe workload
attachments:
APP_DB_USER:
from: app_credentials
as: env
key: db_username
APP_DB_PASSWORD:
from: app_credentials
as: env
key: db_password

Syntezator renderuje jeden secretKeyRef env na każdy wpis. Oba odwołują się do tego samego Secretu (provides.name), każdy z własnym kluczem danych:

# app-deployment.yaml (container env)
- name: APP_DB_USER
valueFrom:
secretKeyRef:
name: app-app-credentials # == the Secret's metadata.name
key: db_username
- name: APP_DB_PASSWORD
valueFrom:
secretKeyRef:
name: app-app-credentials # same Secret
key: db_password # different data key
[… omitted: the GREETING variable, set from the Aggregate's greeting value]

To pole key sprawia, że wieloklucznego sekretu można używać w syntetyzowanej encji Workload. Gdy wpis pomija key, odczytuje zamiast tego jedyny opublikowany klucz danych slotu — w ten sposób działa poświadczenie jednokluczowe (core/referenced-secret), które publikuje zarówno lokalizator, jak i klucz.

Wymiarowanie przez operatora

release.yaml realizuje filar wymiarowania przez operatora dla każdego środowiska: tag obrazu kontenera pochodzi z infra.image_tag (myapp:1.2). Encja Aggregate dewelopera nigdy nie zawiera tego pola.