İsteğe bağlı çalıştırılan bir görev: bir Aggregate, dört hedef
core/manual-trigger taşıyan ve Kubernetes, Docker Compose, Terraform ve CloudFormation üzerinde başlatılmadan dağıtılan bir görev, hiçbir şey taşımayan bir görevin yanında, her hedefte bir çalıştırmayı başlatan komutla birlikte.
Bazı işler yalnızca biri istediğinde tamamlanana kadar çalışır: tek seferlik bir veri düzeltmesi, istek üzerine bir yedekleme. core/manual-trigger bunun için olan Feature’dır. Zamanlaması olmayan bir core/compute/task’e eklendiğinde görevi başlatmadan dağıtır ve her çalıştırma, birinin hedefin kendi komutuyla elle başlattığı bir çalıştırmadır.
Bu çalışma alanı dört hedef için tek bir Aggregate derler — Helm aracılığıyla Kubernetes, Docker Compose, Terraform ve CloudFormation — ve her birinde eklemenin işlenmiş çıktıda neyi değiştirdiğini ve bir çalıştırmayı başlatan komutu gösterir. İkinci görev ekleme taşımaz, bu yüzden fark aynı derlemede görülebilir. İki ek Releases’in durması beklenir ve sayfa her birinin yazdırdığını alıntılar.
Ne oluşturur
| örnek | katalog Component’i | ekleme | bir çalıştırmayı ne başlatır |
|---|---|---|---|
data-fix | core/compute/task | core/manual-trigger | biri, elle, her hedefte |
report | core/compute/task | yok | zamanlaması ya da Docker Compose’da yığının başlaması |
Ekleme, değiştirdiği görevin yanında, Aggregate’in içinde durur: isteğe bağlı çalışmak data-fix’in ne olduğunun bir parçasıdır, bu yüzden onu geliştirici yazar ve Feature hiçbir değer ve hiçbir infra almaz. Release onun için hiçbir şey yazmaz.
report’un zamanlaması bir parametredir, report_schedule; Aggregate bunu boş bir varsayılanla bildirir ve görevin schedule değerine okur:
spec: parameters: report_schedule: type: string default: "" [… omitted: the parameter's description]
components: [… omitted: data-fix with its attachment, and the comment above each task] report: type: core/compute/task values: schedule: "{{ .parameters.report_schedule }}"Bir parametredir, çünkü dört hedef eklemesi olmayan bir görev konusunda farklı davranır. Kubernetes onu bir zamanlama varsa CronJob olarak zamanlamaya göre, yoksa dağıtımda bir kez çalıştırır. Docker Compose’un zamanlayıcısı yoktur, bu yüzden görevi yığın her başladığında bir kez çalıştırır ve zamanlamayı reddeder. AWS’de Terraform ya da CloudFormation uygulandığında hiçbir şey bir Amazon ECS görevini çalıştırmaz, bu yüzden oradaki bir görev bir zamanlamaya ya da eklemeye ihtiyaç duyar ve ikisi de yoksa reddedilir. Bu nedenle Kubernetes, Terraform ve CloudFormation Releases’i report_schedule’u karşılar, Docker Compose Release’i ise onu boş bırakır.
data-fix dördünde de aynı şekilde, zamanlama ve parametre olmadan derlenir.
Altı Releases
| Release | Manifest | report_schedule | derleme |
|---|---|---|---|
release-helm.yaml | manifest-helm.yaml | 30 2 * * 1-5 | tamamlanır |
release-compose.yaml | manifest-compose.yaml | boş | tamamlanır |
release-terraform.yaml | manifest-terraform.yaml | 30 2 * * 1-5 | tamamlanır |
release-cloudformation.yaml | manifest-cloudformation.yaml | 30 2 * * 1-5 | tamamlanır |
release-compose-scheduled.yaml | manifest-compose.yaml | 30 2 * * 1-5 | durur |
release-terraform-unscheduled.yaml | manifest-terraform.yaml | boş | durur |
Her Manifest, core/compute/task’i hedefinin Recipe’ine eşler ve core/manual-trigger’ı hedefinin FeatureRecipe’ine bağlar: helm/task ve helm/manual-trigger, compose/task ve compose/manual-trigger, terraform/task-ecs ve terraform/manual-trigger ile cloudformation/task-ecs ve cloudformation/manual-trigger. Ekleme için hiçbir FeatureRecipe bağlamayan bir Manifest, onu adlandırarak derlemeyi durdurur.
core/compute/task hiçbir yazılım paketlemediği için her Release, her görevin çalıştırdığı imajı infra.image altında adlandırır. AWS Releases’i ayrıca infra.overrides altında her görevin birlikte çalıştığı kümeyi, alt ağları, güvenlik gruplarını ve yürütme rolünü ve report’un bir zamanlaması olduğu yerde zamanlamanın her çalıştırmayı başlatırken kullandığı rolü adlandırır. Oradaki hesaba özgü her değer bir yer tutucudur.
Ö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 task-run-on-demandArdından sırada çalıştırılacak komutları yazdırır. İlki yeni klasöre geçer:
cd task-run-on-demandDerleme
Çalışma alanı, standart kitaplık kataloğunu .aggrega-config.yaml dosyasının adlandırdığı hub kayıt defterinden okur. Buradaki her Recipe yalnızca katalogdan işlenir, bu yüzden kilit dosyası çözümlendikten sonra her derleme çevrimdışı çalışır.
aggrega build --release release-helm.yaml --auto-pull # one ReleaseBelgelendirme deposunun bir çalışma kopyasında — aggrega scaffold --example tarafından yazılan bir kopyanın içermediği ortak derleme yardımcı betiğini barındırır — ./check.sh altı Releases’in tümünü derler ve her sonucu denetler. Her Release için bir satır yazdırır ve yalnızca her biri bu sayfanın açıkladığı gibi sona erdiğinde 0 ile çıkar:
RELEASE EXIT EXPECTED VERDICT----------------------------------------------------------------------------------------------------release-helm.yaml 0 complete OK: completed, the files the README showsrelease-compose.yaml 0 complete OK: completed, the files the README showsrelease-terraform.yaml 0 complete OK: completed, the files the README showsrelease-cloudformation.yaml 0 complete OK: completed, the files the README showsrelease-compose-scheduled.yaml 1 halt OK: halted with the expected refusalrelease-terraform-unscheduled.yaml 1 halt OK: halted with the expected refusal
check: every build ended as expected.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 bir `task-run-on-demand` klasörü yoksa `scaffold` aracını `example` değeri `task-run-on-demand` olarak ayarlanmış ve `dir` olmadan bir kez çağırın: örneği yeni bir `task-run-on-demand` klasörüne yazar. Ardından `build` aracını `workspace_root` değeri `task-run-on-demand`, `release` değeri `release-helm.yaml`, `auto_pull` değeri true ve `write` değeri true olacak şekilde çağırın. Derlemenin hangi dosyaları yazdığını bana söyleyin; bunlar `task-run-on-demand/dist/` altındadır.Kubernetes
release-helm.yaml iki dosya yazar, görev başına bir CronJob, başka hiçbir şey yazmaz. data-fix, geliştiricinin hiç yazmadığı bir zamanlamayla askıda tutulan bir CronJob’dır:
apiVersion: batch/v1kind: CronJobmetadata: name: data-fix [… omitted: the labels and annotations the build writes on every resource]spec: schedule: 0 0 30 2 * suspend: true jobTemplate: spec: template: [… omitted: the pod template's metadata, the same labels again] spec: containers: - name: main image: registry.example.com/orders-data-fix:2.0.1 [… omitted: the container's CPU and memory requests and limits] restartPolicy: NeverBir CronJob’ın bir zamanlamaya ihtiyacı vardır ve 0 0 30 2 *, hiçbir yılda bulunmayan bir tarih olan 30 Şubat’ı adlandırır: askıdayken CronJob hiçbir çalıştırma başlatmaz ve sürdürüldüğünde de bir çalıştırma başlatacağı bir zaman yine yoktur. Ekleme olmadan, zamanlaması olmayan bir görev bir Job olurdu ve dağıtılır dağıtılmaz çalışırdı.
report, Release’in karşıladığı zamanlamayla çalışan bir CronJob’dır ve askıda değildir:
[… omitted: apiVersion, kind and metadata, as in data-fix-cronjob.yaml under report's name]spec: schedule: 30 2 * * 1-5 jobTemplate: [… omitted: the job template, as in data-fix-cronjob.yaml with report's image]data-fix’in bir çalıştırması, CronJob’ından sizin seçtiğiniz bir adla oluşturulan bir Job’dır:
kubectl create job data-fix-run-1 --from=cronjob/data-fixAynı komut, --from=cronjob/report verildiğinde, report’un zamanlanmış çalıştırmaları arasında ek bir çalıştırma başlatır.
Docker Compose
release-compose.yaml bir Compose dosyası yazar. Her görev, çıktığında Compose’un yeniden başlatmadığı bir hizmettir; data-fix ayrıca manual profilini taşır, report ise hiçbirini taşımaz:
services: data-fix: image: registry.example.com/orders-data-fix:2.0.1 [… omitted: the labels the build writes on every service, and the service's network] restart: "no" [… omitted: the CPU and memory limits and reservations] profiles: - manual report: image: registry.example.com/orders-report:1.4.2 [… omitted: the labels and the network, as on data-fix] restart: "no" [… omitted: the CPU and memory limits and reservations, as on data-fix][… omitted: the network the services join]Compose, profil taşıyan bir hizmeti yalnızca o profil etkinleştirildiğinde ya da hizmet komut satırında adlandırıldığında başlatır, bu yüzden docker compose up, report’u bir kez çalıştırır ve data-fix’i durmuş halde bırakır. data-fix’in bir çalıştırması hizmeti adlandırılarak başlatılır ve --rm, çalıştırma bittiğinde kapsayıcısını kaldırır:
docker compose -f dist/compose/docker-compose.yaml run --rm data-fixTerraform
release-terraform.yaml, görev başına bir module bloğu içeren bir kök yapılandırma ve yanında her görevin modülünü yazar. İki blok zamanlamada farklıdır:
# Root configuration for this boundary. Each component rendered here is one# module block below, and the directory that block points at holds that# component's own files. One configuration means one dependency graph, which is# what lets a reference or a depends_on reach from one component to another.
module "data-fix" { source = "./modules/data-fix"
assign_public_ip = false cluster = "arn:aws:ecs:eu-west-1:123456789012:cluster/example-cluster" cpu = "256" environment = {} execution_role_arn = "arn:aws:iam::123456789012:role/example-ecs-task-execution" image = "registry.example.com/orders-data-fix:2.0.1" memory = "512" name = "data-fix" security_groups = ["sg-0fedcba9876543210"] subnet_ids = ["subnet-0123456789abcdef0"]}
module "report" { source = "./modules/report"
assign_public_ip = false cluster = "arn:aws:ecs:eu-west-1:123456789012:cluster/example-cluster" cpu = "256" environment = {} execution_role_arn = "arn:aws:iam::123456789012:role/example-ecs-task-execution" image = "registry.example.com/orders-report:1.4.2" memory = "512" name = "report" schedule_expression = "cron(30 2 ? * 2,3,4,5,6 *)" schedule_expression_timezone = "UTC" scheduler_role_arn = "arn:aws:iam::123456789012:role/example-scheduler" security_groups = ["sg-0fedcba9876543210"] subnet_ids = ["subnet-0123456789abcdef0"]}Modül, EventBridge Scheduler zamanlamasını yalnızca kendisine bir ifade verildiğinde bildirir, bu yüzden data-fix’in görev tanımı tek başına durur:
[… omitted: the provider requirement, the Region lookup, the task definition and the comments on each]resource "aws_scheduler_schedule" "this" { count = var.schedule_expression == null ? 0 : 1[… omitted: the rest of the schedule]Recipe, report’un zamanlamasını EventBridge Scheduler’ın kendi biçiminde yazar: 30 2 * * 1-5, cron(30 2 ? * 2,3,4,5,6 *) olur; haftanın günleri Pazar 1 olacak şekilde numaralanır ve Release hiçbir saat dilimi adlandırmadığı için UTC kullanılır.
CloudFormation
release-cloudformation.yaml bir yığın şablonu yazar. Şablon her görev için bir görev tanımı ve yalnızca report için bir zamanlama içerir:
{ "AWSTemplateFormatVersion": "2010-09-09", "Resources": { "DataFixTaskDefinition": { [… omitted: the provenance metadata the build writes on every resource] "Properties": { "ContainerDefinitions": [ { "Essential": true, "Image": "registry.example.com/orders-data-fix:2.0.1", "Name": "main" } ], "Cpu": "256", "ExecutionRoleArn": "arn:aws:iam::123456789012:role/example-ecs-task-execution", "Family": "data-fix", "Memory": "512", "NetworkMode": "awsvpc", "RequiresCompatibilities": [ "FARGATE" ] }, "Type": "AWS::ECS::TaskDefinition" }, "ReportSchedule": { [… omitted: the provenance metadata] "Properties": { "FlexibleTimeWindow": { "Mode": "OFF" }, "ScheduleExpression": "cron(30 2 ? * 2,3,4,5,6 *)", "ScheduleExpressionTimezone": "UTC", "Target": { "Arn": "arn:aws:ecs:eu-west-1:123456789012:cluster/example-cluster", "EcsParameters": { [… omitted: the launch type, the network configuration and the task count each run starts with] "TaskDefinitionArn": { "Ref": "ReportTaskDefinition" } }, "RoleArn": "arn:aws:iam::123456789012:role/example-scheduler" } }, "Type": "AWS::Scheduler::Schedule" }, "ReportTaskDefinition": { [… omitted: the same shape as DataFixTaskDefinition, with report's image and family] } }}Yığındaki hiçbir şey DataFixTaskDefinition’a başvurmaz, bu yüzden hiçbir şey onu başlatmaz.
Amazon ECS’de bir çalıştırma başlatma
Her iki AWS hedefinde de data-fix’in bir çalıştırması Amazon ECS RunTask işlemiyle başlatılır; bu işleme görev tanımının işlendiği haliyle ailesi ve Release’in infra.overrides altında adlandırdığı küme ve ağ yapılandırması verilir:
aws ecs run-task \ --cluster arn:aws:ecs:eu-west-1:123456789012:cluster/example-cluster \ --task-definition data-fix \ --launch-type FARGATE \ --network-configuration 'awsvpcConfiguration={subnets=[subnet-0123456789abcdef0],securityGroups=[sg-0fedcba9876543210],assignPublicIp=DISABLED}'Yalnızca ailesiyle adlandırıldığında görev tanımı en son etkin revizyonuna çözümlenir.
Derlemenin yapmadıkları
Derleme dosyaları yazar ve durur. Hiçbir hedefte hiçbir çalıştırma başlatmaz: hiçbir kümeye erişmez, hiçbir Compose yığını başlatmaz ve hiçbir AWS API’sini çağırmaz; ekleme yalnızca dosyaların söylediğini değiştirir. Hiçbir betik de yazmaz: bu sayfadaki her komut hedefin kendi komutudur, onu işleten kişi tarafından çalıştırılır ve hiçbiri dist/ içinde değildir. Eklemenin gerçekleştirimleri hiçbir hedefte kendilerine ait bir dosya eklemez; her birinin yaptığı değişiklik, yukarıda gösterilen, görevin kendi çıktısındadır.
Duran iki Releases
release-compose-scheduled.yaml, Docker Compose’da report_schedule’u karşılar ve ayrıca core/manual-trigger’ı report’a ekler. Kubernetes ve AWS’de zamanlaması olan bir görev, ekleme olsun ya da olmasın bu zamanlamayla çalışır; zamanlayıcısı olmayan Docker Compose’da ise zamanlaması olan bir görevin, eklensin ya da eklenmesin, hiçbir gerçekleştirimi yoktur. aggrega build --release release-compose-scheduled.yaml --auto-pull durur:
[… omitted: what resolving the lockfile prints, the same halt among it][CATALOG_ERROR E0033] Recipe/FeatureRecipe assertions caused by: Recipe "task" instance "report" assertion "schedule_refused": [… omitted: the template position and the assertion's own source]: error calling fail: assertion failed: the component "report" is scheduled "30 2 * * 1-5", and Docker Compose has no scheduler: nothing in a compose file starts a service at a time, so the run would happen at none of the times written. Map core/compute/task to helm/task in the Manifest, which runs it on its schedule as a Kubernetes CronJob; or remove the schedule from the component in the Aggregate to run it once at each docker compose up, or attach core/manual-trigger to it there to start each run with docker compose run --rmrelease-terraform-unscheduled.yaml, Terraform’da report_schedule’u boş bırakır, bu yüzden report’un ne zamanlaması ne de eklemesi vardır ve AWS’de hiçbir şey onu asla başlatmaz. core/manual-trigger tam da bu durum için vardır ve aggrega build --release release-terraform-unscheduled.yaml --auto-pull onu adlandırarak durur:
[… omitted: what resolving the lockfile prints, the same halt among it][CATALOG_ERROR E0033] Recipe/FeatureRecipe assertions caused by: Recipe "task-ecs" instance "report" assertion "schedule_translates": [… omitted: the template position and the assertion's own source]: error calling fail: assertion failed: the component "report" has no schedule and carries no core/manual-trigger attachment, so it runs once, and nothing on AWS starts a run that happens once: neither Terraform nor CloudFormation runs an Amazon ECS task when it applies, so the run would never happen. Give the component a schedule in the Aggregate; attach core/manual-trigger to it there to deploy its task definition alone, for the operator to start each run with aws ecs run-task; or map core/compute/task to helm/task in the Manifest, which runs it once on KubernetesBurada zamanlama göreve Release’in karşıladığı bir parametre aracılığıyla ulaşır, bu yüzden bileşene bir zamanlama vermek, release-terraform.yaml’ın yaptığı gibi report_schedule’u karşılamak demektir.