接上篇 —— Apollo 入门引导(四):编写变更解析器 —— 继续翻译 Apollo 的官网入门引导。
了解基础的开发工具。
Apollo 入门引导 - 目录:
完成时间:10 分钟
做得好!我们有一个正在运行的 GraphQL 服务,它能与多个源进行数据交互。在转到客户端之前,先学习一些功能强大的工具。
Apollo Studio 是一个云平台,可以对原型设计、部署到监控的 GraphQL 开发的每个阶段提供帮助。
Studio 的核心功能是完全免费的。本教程中的所有功能都是免费功能。
创建一个 Apollo 帐户
如果已经创建了 Apollo Studio Explorer 的帐户,请跳过此步骤。
访问studio.apollographql.com,然后点击 创建账户(Create an account)。可以使用你的 GitHub 帐户关联注册,也可以自行设置用户名和密码。
注册后,将被重定向到 Apollo Studio 主页。
创建第一个图
在 Apollo Studio 中,每个图(graph)都是具有对应 GraphQL schema 的不同数据图。对于你的第一张图,将使用刚刚完成构建的服务的 schema。
- 在Studio 主页中,单击右上角的 新建图(New Graph)。
- 为你的 graph 提供名称,然后单击下一步(Next)。
- 出现一个对话框,提示你注册 schema。将在下一步中进行操作。
连接服务
Apollo 服务可以直接与 Apollo Studio 通信,以注册其 schema 并推送有用的性能指标。此通信需要 graph API key。让我们为 graph 获得一个。
在Studio 主页中,单击刚创建的 graph。将显示与创建时相同的对话框:
复制你的 graph API 密钥,就是在第一个代码块中 APOLLO_KEY=
之后出现的值(以service:
开头)。
可以通过将 API 密钥设置为 APOLLO_KEY
环境变量值来向 Apollo 服务提供 API 密钥。示例应用程序已经使用 dotenv
包非常方便地从 .env
文件中读取环境变量。
通过复制 start/server/.env.example
,在 start/server
中创建 .env
文件。然后如下将你的 API 密钥粘贴到其中,并添加一行 APOLLO_SCHEMA_REPORTING=true
:
1 | APOLLO_KEY=PASTE_YOUR_KEY_HERE |
Graph API 密钥是私有凭证。切勿在组织外部共享或将其提交到版本控制中。及时的删除并替换可能遭到破坏的 API 密钥。
使用 npm start
启动服务,然后返回 Studio 主页。几秒钟后,单击 graph 即可打开其完整详细信息。
试用免费的 Studio 功能
将服务连接到 Apollo Studio 会开启各种强大的功能:
Explorer
如前几节所示,Apollo Studio 资源管理器提供了对 schema 的全面视图,包括其中包含的所有文档字符串。使用它来构建查询并在服务上执行。
schema 历史
打开历史记录(History)选项卡,可以查看随时间推移,服务推送的 schema 版本的完整修订记录:
历史记录可帮助你准确定位何时添加或删除的某个类型或字段,这在诊断问题时至关重要。
操作指标
Apollo Server 将其执行的每个 GraphQL 操作的指标数据推送到 Studio。此数据包括操作中解决每个字段的时间和详细错误信息。
Apollo Server 不会将 GraphQL 操作结果推送到 Studio。有关更多信息,请参阅数据隐私和合规性。
打开操作(Operations)标签,查看最近 24 小时跟踪服务操作的性能数据:
拥有付费 Studio 的组织可以查看最近 90 天或更长时间的指标,具体时长取决于组织的方案。有关付费 Studio 功能的更多信息,请参见Studio 文档。
现在我们的服务已连接到 Studio,下面开始构建执行查询的客户端!
前端记事本,不定期更新,欢迎关注!