云原生微服务【免费下载链接】spinSpin is the open source developer tool for building and running serverless applications powered by WebAssembly.项目地址https://gitcode.com/gh_mirrors/spin1/spin点击查看免费下载本篇技术指南围绕 Spin 的组件依赖Component Dependencies特性展开该特性源自本仓库 SIP 提案 docs/content/sips/020-component-dependencies.md它允许开发者把用不同语言编写的 Wasm 组件当作“库”来复用通过组件清单Spin.toml声明性地组合它们以满足依赖。读完本文你将掌握在 Spin 组件中声明本地磁盘与远程 registry 依赖的完整语法、依赖命名的包模式与冲突规则、依赖隔离与配置继承机制dependencies_inherit_configuration以及底层spin-deny-all适配器的实现原理并能在实际应用中直接复刻示例配置。背景为什么 Spin 需要组件依赖Spin 是构建与运行 WebAssembly 无服务器应用的开发者工具。组件模型Wasm Component Model允许不同语言编译出的组件彼此组合但长期以来 Spin 组件之间的复用缺少统一的声明式手段。SIP 020 提出的组件依赖特性实现了多语言polyglot组件复用开发者可以在自己的 Spin 组件中指定“如何使用其他语言编写的组件作为库”以填补自身组件的依赖。一个典型场景假设你用 Go 编写了一个 Spin 组件它在编译后的 Wasm 组件中导入了aws:client/s3接口例如import aws:client/s3。为了满足该依赖你可以使用一个用 Rust 编写、导出了aws:client/s3接口实例的组件化 S3 客户端。借助 SIP 020 提出的语法Spin 开发者可以指示 Spin 如何将这些组件组合在一起。该特性已完整落地于当前仓库组件清单的依赖字段在 crates/manifest/src/schema/v2/component.rs 中以dependencies字段定义其具体取值类型版本字符串、包引用、本地路径、URL在 crates/manifest/src/schema/v2/dependency.rs 中实现。声明依赖本地磁盘Local在组件清单中开发者可以通过[component.name.dependencies]小节声明依赖。最基本的形态是使用本地磁盘上的 Wasm 组件文件按导入名import name来满足依赖[component.infra-dashboard.dependencies] # 组件可以通过导入名如 aws:client/s3满足依赖 # 使用磁盘上的组件。这里隐式假定 # my_aws_client.wasm 组件导出了一个 # aws:client/s3 接口实例。 aws:client/s3 { path my_aws_client.wasm } # 可选显式指定用于满足 aws:client/s3 接口的导出名。 aws:client/s3 { path my_aws_client.wasm, export my-s3-client } # 不使用接口名时尝试解析 aws:client 包的每一个导入。 aws:client { path my_aws_client.wasm }⚠️ 注意在同一个 dependencies 小节中同时使用包package形态和接口interface形态例如aws:client与aws:client/s3会导致错误以防止解析歧义。从源码看本地依赖在 crates/manifest/src/schema/v2/dependency.rs 中对应ComponentDependency::Local变体除path外还支持可选的export字段若省略导出名默认为导入名。声明依赖远程 registryRemote依赖也可以来自远程组件注册中心registry。提案指出 registry 的具体含义不在 SIP 020 范围内可参考 OpenContainers Distribution Spec 理解Spin 侧只需声明包的名称与版本约束即可[component.infra-dashboard.dependencies] # 等价于 { version 1.0.0 , package aws:client} aws:client 1.0.0 # 使用 aws:client 组件包来满足任意数量的 wasi:blobstore 导入 ... wasi:blobstore { registry my-registry.io, version 0.1.0, package aws:client }第一条是版本字符串简写aws:client 1.0.0等价于完整的{ version 1.0.0, package aws:client }Spin 会从默认 registry 拉取最新匹配版本。第二条展示了一个关键能力——用不同的包来满足另一个包的接口导入wasi:blobstore导入由aws:client包版本0.1.0托管在my-registry.io来满足。在 crates/manifest/src/schema/v2/dependency.rs 中远程依赖对应ComponentDependency::Package变体包含以下字段version必填语义化版本约束Spin 会从指定 registry未指定则用系统默认 registry获取最新匹配版本registry可选托管包的注册中心省略时使用系统默认 registrypackage可选要使用的包名省略时默认为被导入接口所在的包名如上面的aws:clientexport可选包中要使用的导出名省略时默认为导入名。同一文件 crates/manifest/src/schema/v2/dependency.rs 还定义了第三种形态ComponentDependency::HTTPurlsha256摘要校验适用于直接从 URL 拉取 Wasm 组件为依赖来源提供了本地、registry、URL 三条路径。依赖命名kebab-case 与包模式依赖名dependency name有两种形式普通标识符plain kebab-case例如my-name包模式package pattern又分两种包名aws:client或带版本的aws:client0.1.0包的某个具体接口aws:client/s3或带版本的aws:client/s30.1.0。该解析逻辑在 crates/serde/src/dependencies.rs 的DependencyName::from_str中实现名字若包含:或/则按包模式解析否则作为普通标识符。包模式进一步按切分版本、按/切分接口最终得到 DependencyPackageName包含package、version、interface三部分。命名冲突规则当在组件清单的依赖小节使用包模式时所用的名称与版本集合不得相互冲突。两个模式冲突的定义是它们存在重叠的接口且版本semver 兼容。换句话说当这些模式被完整映射到被依赖组件的底层导入时模式集合必须是两两不相交disjoint的。冲突示例aws:client与aws:client0.1.0冲突aws:client与aws:client/s30.1.0冲突aws:client/s30.1.0与aws:client/s30.1.1冲突。这意味着声明依赖时要么在包粒度、要么在接口粒度上保持一致混用会导致 Spin 无法确定某个导入应由哪个依赖满足从而报错。依赖隔离与配置继承静态组合父组件与其依赖后得到的最终组件中父组件与依赖之间不再相互隔离。若不加约束每个依赖都会继承父组件的配置——这在某些“库”场景下是可取的例如允许aws:client/s3依赖通过allowed_outbound_hosts发起出站请求。但让继承成为默认行为与 Spin以及组件模型显式 opt-in 的能力授予原则相悖。因此Spin 组件依赖默认不继承配置。开启配置继承要让依赖继承父组件的配置开发者可以设置dependencies_inherit_configuration true[component.infra-dashboard] # ... allowed_outbound_hosts [https://s3.us-west-2.amazonaws.com] dependencies_inherit_configuration true [component.infra-dashboard.dependencies] aws:client 1.0.0上述配置允许用于满足aws:client依赖的组件向allowed_outbound_hosts中指定主机上的 S3 存储桶发起出站 HTTP 请求例如https://s3.us-west-2.amazonaws.com/my-bucket/puppy.jpeg。若省略dependencies_inherit_configuration或将其设为false那么每当aws:client组件尝试发起出站 HTTP 请求时都会返回“出站 HTTP 请求能力被禁用”之类的错误。该字段在清单模型中的位置是 crates/manifest/src/schema/v2/component.rs类型为Optionbool其语义与同一组件上的allowed_outbound_hosts、key_value_stores、sqlite_databases、ai_models、files、environment、variables等能力字段直接相关。完整示例可参考 crates/manifest/tests/ui/maximal.toml。可被继承的组件级配置截至 SIP 020 提案撰写之时启用继承后Spin.toml中以下组件级配置可以被依赖组件继承allowed_outbound_hostskey_value_storesvariablesai_modelsfilesenvironment需要说明的是仓库后续实现见 crates/manifest/src/normalize.rs在清单规范化阶段会把组件级的dependencies_inherit_configuration true展开为每个依赖的细粒度继承设置InheritConfiguration::All并校验其与逐依赖inherit_configuration字段互斥——同时指定两者会直接报错。从“全有或全无”到细粒度继承SIP 020 明确把“更细粒度的配置继承”列为未来工作而当前仓库已经实现了这一演进依赖条目现在支持inherit_configuration字段可取true、false或配置键列表如[ai_models, allowed_outbound_hosts]见 crates/manifest/src/schema/v2/dependency.rs。这些能力集合在运行时被映射为具体的 Wasm 接口列表见 crates/capabilities/src/lib.rs例如allowed_outbound_hosts对应wasi:http/outgoing-handler、fermyon:spin/redis、fermyon:spin/postgres、wasi:sockets/*等接口key_value_stores对应fermyon:spin/key-value、wasi:keyvalue/store等variables对应fermyon:spin/variables、wasi:config/store等。隔离的底层实现spin-deny-all适配器为了实现默认行为即dependencies_inherit_configuration falseSpin 会应用所谓的spin-deny-all适配器来维持组件之间的隔离。当配置继承被禁用时Spin 会将该预先构建ahead-of-time constructed的拒绝适配器与每个依赖组合生成一个拒绝访问各种能力如wasi:http/outgoing-handler、fermyon:spin/variables等的新组件。spin-deny-all适配器是一个面向以下 world 的组件package fermyon:spin-virt; world deny-all { # WASI export wasi:cli/environment0.2.0; export wasi:filesystem/preopens0.2.0; export wasi:http/outgoing-handler0.2.0; export wasi:sockets/ip-name-lookup0.2.0; export wasi:sockets/tcp0.2.0; export wasi:sockets/udp0.2.0; # Spin export fermyon:spin/llm2.0.0; export fermyon:spin/redis2.0.0; export fermyon:spin/mqtt2.0.0; export fermyon:spin/rdbms-types2.0.0; export fermyon:spin/postgres2.0.0; export fermyon:spin/mysql2.0.0; export fermyon:spin/sqlite2.0.0; export fermyon:spin/key-value2.0.0; export fermyon:spin/variables2.0.0; }从源码看该适配器的 Wasm 二进制以include_bytes!方式内嵌并通过wac-graph将拒绝适配器“插入”组件导入见 crates/capabilities/src/deny.rs。适配器的构建由 crates/capabilities/Makefile 驱动make adapter生成deny_adapter.wasm并可通过wasm-tools component wit校验其 WIT 与提交版本一致与 SIP 020 中列出的 world 声明一一对应。运行时执行逻辑上crates/capabilities/src/lib.rs 定义了InheritConfiguration三态All继承全部能力、None拒绝适配器封锁所有宿主接口、Some(VecString)仅继承指定的能力集合未识别的名称被静默忽略。能力集合与接口的映射关系构成了细粒度继承的运行时基础。未来工作更细粒度的继承语法SIP 020 设想了一个未来迭代方向允许开发者逐个开关依赖可继承的具体配置。例如下述语法可以让满足aws:client依赖的组件继承allowed_outbound_hosts同时拒绝访问key_value_stores配置中声明的my-key-value-cache[component.infra-dashboard] # ... allowed_outbound_hosts [https://s3.us-west-2.amazonaws.com/my-bucket/puppy.jpeg] key_value_stores [my-key-value-cache] dependencies_inherit_configuration [allowed_outbound_hosts] [component.infra-dashboard.dependencies] aws:client 1.0.0另一种候选语法是按依赖逐一指定要继承的配置[component.infra-dashboard] # ... allowed_outbound_hosts [https://s3.us-west-2.amazonaws.com] key_value_stores [my-key-value-cache] dependencies_inherit_configuration true [component.infra-dashboard.dependencies] aws:client { version 1.0.0, inherit [allowed_outbound_hosts] }为实现这种更细粒度的配置继承提案设想将单一的deny-all适配器拆分为原子的、按配置划分的适配器分别负责拒绝清单中声明的单项配置例如deny-key-value-stores、deny-variables、deny-environment等。这一方向在当前仓库中已成为现实后续 SIPdocs/content/sips/023-fine-grained-capability-inheritance.md正是对 SIP 020 的延伸将“全有或全无”的布尔值替换为每个依赖上的inherit_configuration字段接受true、false或能力键列表配套的 docs/content/sips/024-spin-deps-cli-dx.md 进一步为开发者提供了spin deps命令行工具实现于 src/commands/deps.rs来管理这些依赖声明。小结与建议来源三选一依赖既可以来自本地磁盘path也可以来自远程 registryversion简写或{ registry, version, package }全量形式还可以来自带sha256校验的 URL命名要一致同一 dependencies 小节内包模式与接口模式混用会报错包名/接口/版本之间必须避免重叠冲突权限默认收紧依赖默认不继承父组件配置需显式设置dependencies_inherit_configuration true或逐依赖inherit_configuration才能让依赖使用出站网络、KV、变量等能力这一默认体现了 Spin 的能力显式 opt-in 原则隔离有保障默认隔离由内嵌的spin-deny-all适配器实现其 world 声明WASI 与 Spin 接口的导出拒绝清单可直接在 crates/capabilities/src/deny.rs 与 crates/capabilities/Makefile 中追溯验证。若要在自己的应用中实践可直接参照 crates/manifest/tests/ui/maximal.toml 中的多形态依赖示例包引用 inherit_configuration列表 本地路径 版本约束 精确版本以及 crates/manifest/src/schema/v2/dependency.rs 中每个字段的默认值与语义说明。赞分享云原生微服务【免费下载链接】spinSpin is the open source developer tool for building and running serverless applications powered by WebAssembly.项目地址https://gitcode.com/gh_mirrors/spin1/spin点击查看免费下载相关推荐fish-redux 组件依赖体系详解Dependencies、Slots 与 Dependent 的组合机制fish redux 组件依赖体系详解Dependencies、Slots 与 Dependent 的组合机制 导读 Dependencies 是 fish前端fish_redux 组件Component深度解析View、Effect、Reducer 三要素与 Dependencies 依赖装配fish_redux 组件Component深度解析View、Effect、Reducer 三要素与 Dependencies 依赖装配 导读 组件Co前端Relay 中的 Fragment 渲染与组合基于 useFragment 的组件数据依赖声明实战指南Relay 中的 Fragment 渲染与组合基于 useFragment 的组件数据依赖声明实战指南 本文基于 Relay v13 官方文档《Fragmen前端开发工具上一篇三步免费激活 Windows 与 Office开源 KMS 激活工具 KMS_VL_ALL_AIO 上手指南下一篇一条命令告别激活弹窗KMS 激活工具 KMS_VL_ALL_AIO 完整上手教程创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考