Чарт, що зберігається в git-репозиторії
Helm-чарт не обов’язково має походити з реєстру чартів. Цей приклад отримує чарт,
який міститься в git-репозиторії — власний приклад чарта проєкту Helm hello-world
— і збирає його в маніфести Kubernetes.
Aggregate розробника нічого про це не каже. Він оголошує один
core/compute/server, а звідки береться пакування цього сервера, вирішується
в Recipe і прив’язується в Manifest.
Блок джерела
source: kind: git-repository url: https://github.com/helm/examples.git ref: hello-world-0.1.0 module_subdir: charts/hello-worldТри координати, і кожна відповідає на окреме питання:
url— репозиторій для клонування. Приймаютьсяhttps://,ssh://іgit://. До приватного репозиторію звертаються через SSH за допомогою SSH-агента або через HTTPS із записом для його хоста у вашому файлі netrc —machine github.com login <user> password <token>. Облікові дані, записані в саму URL-адресу, відхиляються, як описано в розділі Автентифікація.ref— посилання, за яким читається репозиторій: тег, гілка або коміт. Це те, як його назвали самі автори репозиторію, і це не завжди просто версія — тут тег містить також назву чарта.module_subdir— каталог усередині репозиторію, який і є чартом. Репозиторій містить чарт за цим шляхом, а не є ним, і каталог входить до того, що робить артефакт окремим: два каталоги одного репозиторію на одному коміті — це два артефакти, а не один.
Вид джерела називає транспорт і розташування, а не формат. Той самий вид отримує чарт, модуль Terraform або будь-який інший каталог файлів; що міститься в каталозі — справа провайдера, який його споживає.
Що записує lock-файл
Лише коміт називає вміст, який не може змінитися без вашого відома. Тег або гілка — це
назва, яку репозиторій може перенаправити на інший коміт, тому aggrega pull розв’язує
посилання і записує обидва — посилання, яке ви написали, і коміт, до якого воно
розв’язалося:
# release-chart.locksource_artifacts: - kind: git-repository url: https://github.com/helm/examples.git module_subdir: charts/hello-world pinned_version: f3dc419e558e6ccebce2ed447384e5d2e11de2f9 digest: sha256:2bee62cfc2efccc61d8e17efeb72f9f77ad7bd87f3ea4e50b1e4219c8d5a2c78 mediatype: application/gzip referenced_by: - entity: recipe uri: helm/hello-world-git:1.0.0 field: spec.source requested_ref: hello-world-0.1.0Обидві половини потрібні. Коміт — це те, що отримує збирання, тож збирання
відтворюване. Посилання — це те, за чим збирання шукає запис, і саме
це дає змогу й далі писати ref: hello-world-0.1.0 у Recipe і все одно
розв’язуватися до точного коміту, на який вказував цей тег, коли записувався lock-файл.
Створення прикладу
Цей приклад можна зібрати командами нижче або доручити збирання вашому ШІ-асистенту.
Запишіть приклад у нову теку, названу за ним:
aggrega scaffold --example chart-from-git-repositoryПотім вона виводить команди, які слід виконати далі. Перша переходить у нову теку:
cd chart-from-git-repositoryЗбирання
aggrega build --release release-chart.yaml --auto-pullЦей приклад містить два релізи, тож реліз для збирання вказується явно. Першому збиранню
потрібен lock-файл, тому тут передається --auto-pull; одноразовий запуск
aggrega pull --release release-chart.yaml заздалегідь робить те саме і
дає змогу всім наступним збиранням працювати без прапорця.
Згенерований Deployment містить значення, надані сутністю Release, відображені на власні назви значень чарта:
apiVersion: apps/v1kind: Deploymentmetadata: name: web-hello-world [… omitted: the chart's own labels, and the labels and annotations every rendered document carries]spec: replicas: 2 [… omitted: the selector and the pod template's own labels] spec: serviceAccountName: web-hello-world securityContext: {} containers: - name: hello-world securityContext: {} image: "nginx:1.27.3" imagePullPolicy: IfNotPresent [… omitted: the container port and the two probes]Кожне збирання виводить одне попередження:
warning: node "web": .infra key "compute" is read by no template in recipe "hello-world-git" — correct the spelling, or remove the keyВоно точне, і його варто прочитати, а не заглушити. Component core/compute/server
пропонує параметр розміру CPU і пам’яті; цей конкретний чарт не надає для нього
значень, тож Recipe нічого туди не відображає. Recipe з джерелом відображає те, що
чарт, який він отримує, справді приймає, а компілятор повідомляє про значення, яке нікуди не потрапило,
замість того щоб удавати, ніби воно застосувалося.
З ШІ-асистентом
ШІ-асистент, налаштований з інструментами Aggrega, може зробити те саме: вставте йому цей промпт.
Використовуйте лише інструменти Aggrega і не створюйте жодної теки самостійно. Якщо тека робочого простору ще не містить теки `chart-from-git-repository`, викличте один раз інструмент `scaffold`, задавши для `example` значення `chart-from-git-repository` і не задаючи `dir`: він запише приклад у нову теку `chart-from-git-repository`. Потім викличте інструмент `build`, задавши для `workspace_root` значення `chart-from-git-repository`, для `release` — `release-chart.yaml`, для `auto_pull` — true і для `write` — true. Скажіть мені, які файли записала збірка; вони лежать у `chart-from-git-repository/dist/`.Коли посилання переміщується
Тег можна перенаправити в репозиторії. Коли це стається, наступний звичайний
aggrega pull виявляє, що посилання розв’язується не до того коміту, який він
записав, і зупиняється замість того, щоб прийняти його:
# aggrega pull --release release-chart.yaml## [E0130]# lockfile: out of date; it no longer matches what its Release resolves to# ---# source-artifact kind=git-repository url=https://github.com/helm/examples.git# module_subdir=charts/hello-world: reference "hello-world-0.1.0" moved — the# lockfile pins 03f4a18d3c2b77b7ecd91d0324a95910d4f04152, and it now resolves to# f3dc419e558e6ccebce2ed447384e5d2e11de2f9; adopt where it now points with# `aggrega pull --upgrade --release <release>`Він називає обидва коміти, тож ви можете точно побачити, що змінилося, перш ніж вирішувати. Lock-файл залишається як був — зупинка відбувається до будь-якого запису — і прийняття нового коміту є свідомою дією:
aggrega pull --upgrade --pin-sources --release release-chart.yamlПереміщене посилання — це саме той випадок, для якого призначено --upgrade: звичайний pull утримує
коміт, записаний у lock-файлі, і лише оновлення приймає те, куди посилання вказує
тепер. Голий --upgrade скидає всі записані закріплення, тому спершу просить
підтвердження. Потрібен також --pin-sources, бо цей Recipe також записує коміт свого
джерела в entity.lock поруч із собою: оновлення переписує це закріплення на
новий коміт, а без прапорця pull зупиняється на lock-файлі й називає
aggrega pin. Закомітьте переписаний entity.lock разом із Recipe.
Зміна, внесена в цьому робочому просторі, наприклад до Aggregate чи Release, — це дрейф
іншого роду: наступне збирання повідомляє про нього, а звичайний
aggrega pull --release release-chart.yaml його усуває.
Закріплення коміту в ref: замість тегу — інший спосіб отримати ту саму
гарантію ціною координати, яку жодна людина не прочитає.
Захисний реліз
release-negative.yaml має завершитися невдачею, і він тут тому, що шлях отримання,
перевірений лише на успішному сценарії, нічого не каже про свої захисти. Він
розгортає той самий Aggregate через manifest-negative.yaml, який прив’язує Recipe,
ідентичний робочому, за винятком посилання — воно називає тег, якого
репозиторій не містить:
aggrega build --release release-negative.yaml --auto-pull# exits non-zero# [E0137]# auto-pull: resolving the source of each Recipe and FeatureRecipe the Release# uses: resolve: resolve source for recipe# "helm/hello-world-git-missing-ref:1.0.0": sourceresolver: kind=git-repository# url=https://github.com/helm/examples.git version=: oci: artifact not found at# remote source (cause: reference not found)[… omitted: the rest of that line, a remediation naming the URL and version to check]Репозиторій доступний, і клонування вдається; просто такого посилання в ньому немає, тож немає коміту для закріплення і нічого архівувати.
Що цьому прикладу потрібно від мережі
На відміну від більшості робочих просторів тут, цей клонує справжній репозиторій під час першого
збирання, тож цьому збиранню потрібен вихідний доступ до хоста, вказаного в url. Щойно
з’являються lock-файл і кеш розв’язання, наступні збирання читають із кешу і
працюють зовсім без мережі — aggrega build --release release-chart.yaml --offline
відтворює ті самі байти.