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

MariaDB (chart Bitnami) — jeden wieloKluczowy Secret z poświadczeniami

Pojedyncza baza danych MariaDB realizowana przez chart Helm firmy Bitnami, której hasła dostarcza jeden wielokluczowy sekret, do którego można się odwołać (core/referenced-secret-set).

Chart Bitnami uwierzytelnia się na podstawie pojedynczego obiektu Secret Kubernetes wskazanego przez auth.existingSecret i oczekuje, że ten Secret będzie zawierał stałe klucze danych — mariadb-root-password oraz, gdy ustawiony jest niestandardowy użytkownik, mariadb-password (wdrożenie z replikacją dodaje mariadb-replication-password). Nie ma ustawienia pozwalającego zmienić nazwy tych kluczy; są one ustalone przez chart.

Zamiast pozwalać, by Recipe bazy danych zgadywał nazwę obiektu Secret, programista dołącza wielokluczowe poświadczenie zawierające dokładnie te stałe klucze, a Recipe odczytuje nazwę wytworzonego obiektu Secret z .features.root_password.provides.name. Nazwa odwołania i metadata.name wygenerowanego obiektu Secret to jedna wartość — nie ma ponownego wyprowadzania ani konwencji, co do której obie strony musiałyby się zgodzić.

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 mariadb-bitnami-credential-set

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

Terminal window
cd mariadb-bitnami-credential-set

Kompilacja

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

--auto-pull zapisuje podczas budowania plik blokady, którego brakuje świeżemu klonowi.

Recipe mariadb-bitnami jest rozwiązywany z własnej lokalnej kopii catalog/ tego przykładu — lokalnego Recipe napisanego przez przedsiębiorstwo — natomiast Component core/datastore/mariadb i features poświadczeń są rozwiązywane z hub.aggrega.ai, domyślnego rejestru wskazanego w .aggrega-config.yaml; lokalny catalog/ jest tam wymieniony w catalog_dirs. Chart Bitnami jest pobierany ze swojego źródła OCI.

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 `mariadb-bitnami-credential-set`, wywołaj raz narzędzie `scaffold` z `example` ustawionym na `mariadb-bitnami-credential-set` i bez `dir`: zapisuje ono przykład w nowym folderze `mariadb-bitnami-credential-set`. Następnie wywołaj narzędzie `build` z `workspace_root` ustawionym na `mariadb-bitnami-credential-set`, `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 `mariadb-bitnami-credential-set/dist/`.

Co wytwarza poświadczenie

Komponent db dołącza core/referenced-secret-set do swojego wymaganego slotu root_password, dostarczając stałe nazwy kluczy chartu jako dane. Manifest mapuje to poświadczenie na k8s-secret-set, który materializuje jeden obiekt Secret Kubernetes i publikuje jego nazwę jako provides.name:

dist/app/helm/db--root-zupassword--db-secret-db-root-password.yaml
[… omitted: the apiVersion and the Secret kind]
metadata:
name: db-root-password
[… omitted: the labels and annotations every rendered document carries]
stringData:
mariadb-root-password: "dev-root-pw-change-me"
mariadb-password: "dev-user-pw-change-me"

Do czego odwołuje się chart

Recipe mariadb-bitnami ustawia auth.existingSecret na podstawie nazwy opublikowanej przez slot, więc wyrenderowany StatefulSet montuje ten sam Secret, który wytworzyło poświadczenie — obie strony odczytują .features.root_password.provides.name:

# dist/app/helm/db-statefulset-default-db-mariadb.yaml (credential volume)
- name: mariadb-credentials
secret:
secretName: db-root-password # == the produced Secret's metadata.name
items:
- key: mariadb-root-password # a fixed key the chart reads
path: mariadb-root-password
- key: mariadb-password
path: mariadb-password

Ponieważ ustawiono auth.existingSecret, chart nie generuje własnego obiektu Secret — jedynym obiektem Secret w buildzie jest ten, który wytworzyło poświadczenie.

Jednokluczowy odpowiednik

core/referenced-secret (zob. przykład credential-secretkeyref) to jednokluczowy członek tej samej rodziny: opakowuje jeden klucz danych nazwany przez wywołującego i publikuje zarówno nazwę zasobu, jak i ten klucz, dla konsumenta, który odwołuje się do jednego klucza przez secretKeyRef. Zamiast niego należy użyć core/referenced-secret-set, gdy cel konsumujący odczytuje stały zestaw kluczy z jednego obiektu Secret, który wskazuje jako całość, jak robi to chart Bitnami.