跳转到内容
AggregaAggrega
选择语言: 简体中文
本页面由机器翻译。阅读英文原文。

如何使用本参考

语言参考规定了 Aggrega 的编写接口:YAML 模式、共享关键字词汇、Go 模板系统、provider 契约、CLI 命令、编译器的错误目录,以及端到端的完整示例。初次了解时,请按顺序阅读下面的章节;查找特定实体、关键字、provider、CLI 命令或错误时,可直接跳转到相应的子目录。

要先安装 aggrega 二进制文件,请按照安装二进制文件操作;要让 AI 助手为你安装并完成设置,请粘贴使用 AI 助手设置 Aggrega中的提示。在基于 Aggrega 构建脚本或目录之前,请阅读兼容性,了解升级可能改变什么、不会改变什么。

在阅读本参考之前,请先掌握架构章节所建立的思维模型。四个领域与团队拓扑一章解释了 Aggrega 如何将开发者意图、平台目录、平台运维和平台运营者的关注点划分为不同的编写接口;实体分类一章列出了各个实体(Aggregate、Component、Feature、Recipe、FeatureRecipe、Plugin、Manifest、Release、SchemaLibrary、MappingLibrary、WorkloadLibrary、ArtifactLibrary)及其在这些领域中的角色。本章之后的每个参考章节都假定读者已了解这一结构。

本参考有两种使用方式。入门时,请按顺序阅读:先阅读命名约定,了解实例名称模式和大小写规则,然后逐一阅读实体和词汇章节,建立完整的编写契约。查阅时,请直接跳转到与问题对应的子目录:entities/ 介绍各实体的字段语义,vocabulary/ 介绍跨实体的关键字,templates/ 介绍 Recipe 作者可用的 Go 模板接口,providers/ 介绍各 provider 的分派契约,plugins/ 介绍插件插槽和插件编写,schema/ 介绍每种 kind 的 JSON Schema,cli/ 介绍命令行用法,errors/ 介绍诊断信息,examples/ 介绍完整的示例模式。