云专业版入门

创建您的第一个云专业版路由器

云专业版当前处于邀请仅限模式预览. 如果您想请求访问或有任何问题或反馈，请随时联系我们。

按照本实际操作指南创建一个新的图，它使用专有云路由器。要了解有关专用云路由的详细信息，请参阅云专用概述。

要完成此快速入门，您必须满足以下条件

拥有 GraphOS Studio 帐户
一个拥有专用计划的组织—联系我们请求访问。
一个或多个 Apollo 可以访问的 GraphQL API。这意味着您必须：
- 使您的 GraphQL API(s) 通过公开可访问的 URL 提供，例如，https://api.mycompany.com/subgraphA
- 使您的 GraphQL API(s) 保持私密，但允许安全连接，例如，通过 VPC 网络交流

如果您有多个子图，每个都需要对 Apollo 保持开放。但是，您的超图应仅通过您的云路由器公开访问。

ⓘ 注意

在超图中，每个 GraphQL API 被称为子图。Apollo 称这些 GraphQL API 为子图，即使您只连接一个 GraphQL API。

GraphOS 路由器不支持嵌套联盟——也就是说，一个子图不能作为另一个子图的超级图。

要配置一个新的专用云路由器，您必须首先在GraphOS Studio中创建一个新的图。为此，请从图标签中点击创建新图。。

接下来，将您的GraphQL API 连接到 Apollo。
- 如果您的 API 网址是公开可访问的，请输入该 API 网址。此 URL 是客户端应用程序目前用于查询您的 API 的 URL。
- 如果您的 API 不可公开访问且需要私有网络，您可以使用AWS VPC Lattice连接到它。选择我的端点不可公开访问以连接到 VPC。按照提示完成私有子图设置。
输入一个子图名称。该名称应反映您的 API 的数据或功能，并在您以后添加到超级图的其他 API 中保持唯一性。
ⓘ 注意
子图名称是不可变的。
选择要部署您的云路由器所在的后端提供商和区域。
可选，配置标头、密钥、CORS 规则或其他配置。您可以根据需要更新您的路由器配置。
提供一个超级图名称和ID。
- 超级图名称在 Studio 中显示，有助于您的团队区分不同的图。您可以在任何时间更改您图的名称。
- ID 是不可变的，并且在 Apollo 中必须是唯一的。请确保它以字母开头，并只包含字母、数字和连字符。您将使用 ID 从各种工具中引用您的图——例如，从 Rover CLI。
点击创建 GraphOS 路由器。

为新路由器提供您的新超级图可能需要几分钟时间。完成后，点击查询您的超级图以打开资源管理器并开始使用您的图，或打开README以访问您的图的首页。

在进行下一步之前，添加您想连接的其他GraphQLAPI。从左侧导航中打开Subgraphs页面，然后点击添加子图。

每次修改router配置或supergraph模式（包括添加子图）都会触发一个新的发布。每次发布都会自动部署新的云routerrouter实例以供您的supergraph使用。

ⓘ 注意

发布过程通常需要1-2分钟，但可能需要最长5分钟。在此过程中，Apollo将为新的GCUs配置资源，并在它们上线后进行交换。部署最小化API性能下降和停机时间。

专用的云router有独立的UI用于管理和配置。从左侧导航中打开Cloud Router页面。此页面显示了您的云router的摘要，包括其API端点和API详细信息。

使用配置选项卡来管理您的云router的的配置，包括秘钥和Router配置YAML。有关更多信息，请参阅router文档。

要测试您的graph是否按预期工作，请通过从您的graph的README页面点击在资源管理器中运行来运行一个示例查询。

为了进一步测试，您可以在开发或测试环境中为您的graph添加变体。为此，请转到设置>此图>变体并点击添加变体。

Apollo建议运行负载测试以确定您运行graph所需的吞吐量容量。

您的supergraph准备好开始接收客户端操作了！如果您有已连接到您的GraphQLAPI的现有客户端应用程序，您可以更新它们的GraphQL端点URL为您的router的URL。

类似地，任何新的客户端应用程序应使用您的router的URL。

ⓘ 注意

您可以在云路由器页面中的GraphOS Studio找到您的端点URL。

ⓘ 注意

默认情况下，云路由器URL位于apollographos.net的子域名上。您可以通过设置自定义域名来最小化对客户端的改动。

祝贺！🎉 您已在GraphOS上构建了一个云supergraph。查看下一步文章，了解在supergraph上执行的一些最常见和最重要的操作，包括更新子图模式的schema和设置持续交付。