Bir git deposunda tutulan chart
Bir Helm chart’ının bir chart kayıt deposundan gelmesi gerekmez. Bu örnek, bir git deposunda bulunan bir chart’ı — Helm projesinin kendi hello-world
örnek chart’ını — kaynak olarak alır ve onu Kubernetes manifestlerine derler.
Geliştiricinin Aggregate’i bunların hiçbiri hakkında bir şey söylemez. Tek bir
core/compute/server bildirir; bu sunucunun paketlemesinin nereden geleceğine
Recipe’te karar verilir ve Manifest tarafından bağlanır.
Kaynak bloğu
source: kind: git-repository url: https://github.com/helm/examples.git ref: hello-world-0.1.0 module_subdir: charts/hello-worldÜç koordinat vardır ve her biri farklı bir soruyu yanıtlar:
url— klonlanacak depo.https://,ssh://vegit://kabul edilir. Özel bir depoya SSH aracısı üzerinden SSH ile ya da netrc dosyanızda ana makinesi için bir girdiyle HTTPS üzerinden ulaşılır —machine github.com login <user> password <token>. URL’nin kendisine yazılmış bir kimlik bilgisi, Kimlik doğrulama bölümünde açıklandığı gibi reddedilir.ref— deponun okunacağı referans: bir etiket, bir dal veya bir commit. Deponun kendi yazarları onu nasıl adlandırdıysa odur ve bu her zaman yalın bir sürüm değildir — burada etiket chart’ın adını da taşır.module_subdir— depo içinde chart olan dizin. Depo kendisi bir chart olmak yerine bu yol altında bir chart barındırır ve dizin, yapıtı ayırt eden şeyin bir parçasıdır: aynı commit’teki tek bir deponun iki dizini tek değil, iki yapıttır.
Kaynak türü biçimi değil, aktarımı ve konumu adlandırır. Aynı tür bir chart’ı, bir Terraform modülünü veya başka herhangi bir dosya dizinini getirir; dizinin ne içerdiği, onu tüketen provider’ın işidir.
Kilit dosyasının kaydettikleri
Yalnızca bir commit, sizden habersiz değişemeyecek bir içeriği adlandırır. Bir etiket veya dal,
deponun farklı bir commit’e yeniden yönlendirebileceği bir addır; bu yüzden aggrega pull
referansı çözümler ve ikisini birden kaydeder — yazdığınız referansı ve onun
çözümlendiği commit’i:
# 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.0Her iki yarı da yerini hak eder. Commit, derlemenin getirdiği şeydir; böylece derleme
yeniden üretilebilir olur. Referans ise derlemenin girdiyi arayarak bulduğu şeydir;
bu da Recipe’te ref: hello-world-0.1.0 yazmaya devam etmenizi ve yine de
kilit dosyası yazıldığında o etiketin işaret ettiği tam commit’e çözümlemenizi sağlar.
Ö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 chart-from-git-repositoryArdından sırada çalıştırılacak komutları yazdırır. İlki yeni klasöre geçer:
cd chart-from-git-repositoryDerleme
aggrega build --release release-chart.yaml --auto-pullBu örnek iki release içerir, bu nedenle derlenecek olanın adı verilir. İlk derleme
bir kilit dosyası gerektirir; burada --auto-pull verilmesinin nedeni budur;
önceden bir kez aggrega pull --release release-chart.yaml çalıştırmak aynı işi görür ve
sonraki tüm derlemelerin hiçbir bayrak olmadan çalışmasını sağlar.
Oluşturulan Deployment, Release’in sağladığı değerleri chart’ın kendi değer adlarına eşlenmiş olarak taşır:
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]Her derleme bir uyarı yazdırır:
warning: node "web": .infra key "compute" is read by no template in recipe "hello-world-git" — correct the spelling, or remove the keyBu doğrudur ve susturulmak yerine okunmaya değer. core/compute/server
Component’i bir CPU ve bellek boyutlandırma ayarı sunar; bu chart onun için hiçbir
değer sunmaz, bu yüzden Recipe oraya hiçbir şey eşlemez. Kaynak kullanan bir Recipe,
kaynak aldığı chart’ın gerçekte kabul ettiklerini eşler ve derleyici hiçbir yere ulaşmayan
değeri, yerine ulaşmış gibi davranmak yerine bildirir.
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 `chart-from-git-repository` klasörü yoksa `scaffold` aracını `example` değeri `chart-from-git-repository` olarak ayarlanmış ve `dir` olmadan bir kez çağırın: örneği yeni bir `chart-from-git-repository` klasörüne yazar. Ardından `build` aracını `workspace_root` değeri `chart-from-git-repository`, `release` değeri `release-chart.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 `chart-from-git-repository/dist/` altındadır.Referans değiştiğinde
Bir etiket depoda yeniden yönlendirilebilir. Bu olduğunda, bir sonraki sıradan
aggrega pull, referansın kaydettiği commit’ten başka bir yere çözümlendiğini görür ve
onu benimsemek yerine durur:
# 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>`Her iki commit’i de adlandırır; böylece karar vermeden önce neyin değiştiğini tam olarak görebilirsiniz. Kilit dosyası olduğu gibi bırakılır — durma, herhangi bir şey yazılmadan önce gerçekleşir — ve yeni commit’i benimsemek bilinçli bir eylemdir:
aggrega pull --upgrade --pin-sources --release release-chart.yamlDeğişmiş bir referans, --upgrade’in amaçlandığı durumdur: sıradan bir pull, kilit dosyasının
kaydettiği commit’i korur ve yalnızca bir upgrade, referansın şimdi işaret ettiği yeri
benimser. Yalın bir --upgrade kaydedilmiş tüm sabitlemeleri kaldırır, bu yüzden önce
onay ister. --pin-sources de gereklidir, çünkü bu Recipe kaynağının commit’ini
yanındaki entity.lock dosyasına da kaydeder: upgrade bu sabitlemeyi yeni commit’e
göre yeniden yazar; bayrak olmadan ise pull kilitte durur ve
aggrega pin komutunu adlandırır. Yeniden yazılan entity.lock dosyasını Recipe ile birlikte commit edin.
Bu çalışma alanında yapılan bir düzenleme, örneğin Aggregate’te veya Release’te, farklı türde
bir sapmadır: bir sonraki derleme bunu bildirir ve sıradan bir
aggrega pull --release release-chart.yaml onu temizler.
ref: içinde etiket yerine bir commit sabitlemek, aynı güvenceyi elde etmenin
diğer yoludur; bedeli ise hiçbir insanın okuyamayacağı bir koordinattır.
Koruma amaçlı release
release-negative.yaml dosyasının başarısız olması beklenir ve burada bulunmasının nedeni, yalnızca
sorunsuz yolunda denenen bir getirme yolunun korumaları hakkında size hiçbir şey söylememesidir.
Aynı Aggregate’i manifest-negative.yaml üzerinden dağıtır; bu dosya, referansı dışında
çalışan Recipe ile aynı olan bir Recipe bağlar — deponun içermediği bir etiketi
adlandırır:
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]Depoya erişilebilir ve klonlama başarılı olur; yalnızca içinde böyle bir referans yoktur, dolayısıyla sabitlenecek bir commit ve arşivlenecek bir şey yoktur.
Bu örneğin ağdan ihtiyaç duydukları
Buradaki çoğu çalışma alanının aksine, bu alan ilk derlemesinde gerçek bir depoyu klonlar;
bu yüzden o derleme, url içinde adı geçen ana makineye dışa doğru erişim gerektirir. Kilit
dosyası ve çözümleme önbelleği oluştuktan sonra, sonraki derlemeler önbellekten okur ve
hiç ağ olmadan çalışır — aggrega build --release release-chart.yaml --offline
aynı baytları yeniden derler.