用途:该技能是 Twingate 的 Pulumi IaC 专项助手,负责 Twingate/pulumi-twingate 提供程序在 TypeScript、Python、Go、C#/.NET 四种语言 SDK 下的使用,包括栈配置、资源实例化、敏感输出处理以及与计算资源的集成。Pulumi 提供程序封装与 Terraform 提供程序相同的 GraphQL API,资源语义一致;当 Pulumi 文档对资源行为描述不清时,以 twingate-terraform 为权威参考。
主要能力与准则:生成代码前先阅读现有 Twingate Pulumi 资源声明(如 twingate.RemoteNetwork、twingate.Connector、twingate.Resource、twingate.Group),理解现有栈结构、命名模式与配置访问方式,新增内容应遵循既有模式,而非另起独立程序。ConnectorTokens 与 ServiceAccountKey 输出必须用 pulumi.secret()(TypeScript)或 pulumi.Output.secret()(Python)包裹,否则值会以明文出现在 pulumi stack output、Pulumi Cloud 历史与状态文件备份中。通过 Pulumi 配置设置 twingate:apiToken 时必须使用 --secret,普通配置值在状态文件中未加密。不要对敏感输出调用 .get() 向下游传递,应使用 pulumi.all([...]).apply(...) 安全组合。Twingate 资源 ID 是不透明的 base64 编码 NodeID,不应解析、解码或构造,应通过 Pulumi 输出属性链式引用。排查本地插件构建问题前先查看 references/gh-twingate-pulumi-twingate.md,其中记录了 pulumi up 时 404 失败与 +dirty/alpha 版本字符串等本地开发构建特有的坑。
使用方式:回答前先用用户关键词 grep references/ 并引用结果,因为文件名只反映主题,SDK 包名、配置键与错误字符串在文件正文中。对于具体 SDK 方法名、参数名、各语言默认值、Pulumi 配置键、secret 标记语法、栈输出处理,以及将令牌接入计算资源时的云特定集成(AWS Secrets Manager、Azure Key Vault、GCP Secret Manager),不要凭训练数据记忆作答;应查阅 https://github.com/Twingate/pulumi-twingate 与 Pulumi Registry(https://www.pulumi.com/registry/packages/twingate/)。
适用场景与限制:适用于编写、调试、审查 Twingate Pulumi 代码,以及跨技能协作(如先做架构设计、连接器、身份、Kubernetes 密钥传递等)。资料未提供具体收费、价格与效果信息。