İçeriğe geç
AggregaAggrega
Dil seçin: Türkçe
Bu sayfa makine çevirisiyle çevrilmiştir. İngilizce orijinalini okuyun.

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

catalog/recipe/helm/hello-world-git/1.0.0/recipe.yaml
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:// ve git:// 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.lock
source_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

Her 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:

Terminal window
aggrega scaffold --example chart-from-git-repository

Ardından sırada çalıştırılacak komutları yazdırır. İlki yeni klasöre geçer:

Terminal window
cd chart-from-git-repository

Derleme

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

Bu ö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:

dist/app/helm/web-deployment-web-hello-world.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
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 key

Bu 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:

Terminal window
aggrega pull --upgrade --pin-sources --release release-chart.yaml

Değ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:

Terminal window
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.