Amplication CLI 如何用 amp auth 认证并通过 config:set 连接自建服务？

Amplication CLI 如何用 amp auth 认证并通过 config:set 连接自建服务【免费下载链接】amplicationAmplication brings order to the chaos of large-scale software development by creating Golden Paths for developers - streamlined workflows that drive consistency, enable high-quality code practices, simplify onboarding, and accelerate standardized delivery across teams.项目地址: https://gitcode.com/GitHub_Trending/am/amplication如果你的团队在本地或内网部署了一套自建 Amplication 服务而不是官方面向公众托管的版本命令行工具amplication/cli默认不会指向它直接执行命令会把请求发往官方托管地址。这篇文章解决的就是这件事先安装 CLI用amp auth以服务端 UI 生成的 token 完成认证再用amp config:set把 CLI 的服务地址切换到自建服务并通过amp config:get验证配置确实生效。所有命令均出自 packages/amplication-cli/README.md。前提安装 CLI在服务端 UI 生成 token按 README 的 Usage 一节CLI 通过 npm 全局安装npm install -g amplication/cli安装后以amp COMMAND的形式调用例如amp --version可查看版本README 中示例输出为amplication/cli/0.13.0。README 在 Setup 一节说明认证的前提在 Amplication server UI 中生成一个 token。token 不是 CLI 本地生成的必须由你访问的 Amplication 服务端界面签发——因此对自建服务而言应登录自建服务的 Web 界面生成。客户端界面中 API token 的增删管理位于 Settings 模块含 ApiTokenListItem.tsx、DeleteApiToken.tsx 等组件可对照该页面找到令牌入口。建议的执行顺序先指向自建服务再认证commands/config/set.ts 的父类 ConfiguredCommand 在每条命令执行前都会读取配置中的AMP_SERVER_URL拼接出 GraphQL 端点URL 后接graphql配置里没有该值时才回退到默认托管地址。也就是说认证命令本身也会访问当前配置指向的服务。所以连接自建服务时建议先执行config:set再执行amp authamp config:set AMP_SERVER_URL http://localhost:3000AMP_SERVER_URL是允许的配置属性http://localhost:3000是 README 给出的本地服务示例地址实际使用时替换成你的自建服务地址。命令成功时输出Updated property AMP_SERVER_URLconfig:set只接受 properties.ts 中allowedProperties列出的属性名AMP_CURRENT_RESOURCE、AMP_CURRENT_ENTITY、AMP_CURRENT_FIELD、AMP_SERVER_URL、AMP_OUTPUT_FORMAT传入其他属性名会报Unknown property xxx。用 amp auth 完成认证拿到 token 后执行TOKEN占位处替换为你在服务端 UI 生成的实际 token 值amp auth TOKEN按 auth.ts 的实现这条命令会把 token 写入 CLI 配置并向服务端发起 GraphQL 查询me字段验证身份验证通过时输出successfully logged in to Amplication with user 名 姓失败时输出错误Could not authorize user。出现错误信息通常意味着 token 无效、或当前配置指向的服务端点不可达——此时先确认AMP_SERVER_URL已经指向了生成该 token 的那套服务。验证配置是否生效README 提供了两条核对命令。单条查询amp config:get AMP_SERVER_URL或一次性列出全部受支持属性及其当前值即config命令README 示例amp configamp config输出为属性名当前值的列表。看到AMP_SERVER_URL为你设置的自建服务地址即表示切换完成。如果之后需要移除该配置README 给出的命令是amp config:unset AMP_SERVER_URL限制与说明README 声明 CLI 默认连接官方托管版本 https://app.amplication.com而源码中回退使用的默认常量DEFAULT_SERVER_URL是https://server.amplication.com见 properties.ts。两处写法不一致文章按 README 的描述呈现如果你依赖“不配置即连官方托管”的行为建议以实际amp config:get AMP_SERVER_URL的输出为准确认默认值。配置值保存在 CLI 自身的配置目录下的config.json中由 ConfiguredCommand 读写amp auth写入的 token 与config:set写入的属性共用该文件。AMP_OUTPUT_FORMAT控制命令输出格式README 示例值styledJSON各查询命令的--format选项还支持JSON、table与本次认证、切服务地址的流程无关这里仅列出以说明amp config会显示哪些属性。认证和服务地址切换完成后你就可以对自建服务执行 README 命令表中列出的amp resources、amp entities等命令把自建实例纳入日常操作流程。【免费下载链接】amplicationAmplication brings order to the chaos of large-scale software development by creating Golden Paths for developers - streamlined workflows that drive consistency, enable high-quality code practices, simplify onboarding, and accelerate standardized delivery across teams.项目地址: https://gitcode.com/GitHub_Trending/am/amplication创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考