您正在查看 Apigee Edge 文档。
前往 Apigee X 文档。 信息
自 2020 年 5 月 31 日起,Apigee 将不再赞助基于 Drupal 7 的开发者门户 (D7P) 的托管。 在此之前,自 2019 年 5 月 31 日起,客户必须自行预配任何基于 Drupal 的新门户。
将做出哪些更改?
2019 年 4 月,我们宣布推出了 Apigee 集成开发者门户的 开发者团队和受众群体功能。2019 年 5 月,我们宣布基于 Drupal 8 的门户 (D8P) 已准备好投入生产环境使用。它为 Apigee 管理的集成门户提供了一种新的客户管理门户替代方案,并包含新的 SmartDocs。 在宣布推出 D8P 的同时,我们还宣布将在 12 个月内停止托管 D7P,并在 20.06 版中移除私有云 D7P 的安装和升级脚本。
为何 Apigee 赞助的基于 Drupal 7 的开发者门户托管服务即将结束?
Apigee 赞助的 D7P 托管服务将于 2020 年 5 月结束,原因有二:
- Apigee 的 集成式门户已成为客户的理想之选,不仅提供先进功能,而且总体拥有成本更低。
- 对于希望继续使用 Drupal 的用户,Drupal 8 是前进的方向。虽然从 D7P 迁移到 D8P 并非易事,但对于偏好自托管开发者门户的任何客户来说,D8P 都提供了更好的发展路径。
您需要采取什么行动?
Apigee D7P 客户应评估可用的替代方案,并与首选托管服务提供商(例如 Pantheon 或 Acquia)建立直接关系,或考虑其他托管选项。
有哪些可选方案?
使用 D7P 的 Cloud 客户有以下三种选择:
- 改用 Apigee 的集成门户。
- 迁移到 Drupal 8。
- 继续使用 Drupal 7,并在 2020 年 5 月 31 日之前承担托管职责。
使用 D7P 的私有云客户有两个选项:
- 迁移到 Drupal 8。
- 暂时继续使用 Drupal 7。
下文更详细地介绍了每种策略。
方案 1:改用 Apigee 集成式门户
哪些人应该考虑这一点?
一直在使用 Drupal 7 且仅进行少量自定义的 API 提供商,或者更倾向于采用以配置为导向且总体拥有成本更低的一体化解决方案的提供商。
直接集成到 Apigee Edge 中的开发者门户包含强大的 API 目录和一款功能强大的基于 Markdown 的内容管理系统,以及强大的受众群体管理工具。如需确定集成式门户是否适合您的 API 计划,请与您的 Apigee 客户代表联系。
如需有关如何规划和执行将 Drupal 7 门户资源迁移到集成门户的指导,请参阅将 Drupal 7 门户迁移到集成门户。
方案 2:迁移到 Drupal 8
哪些人应该考虑这一点?
API 提供方利用了 Drupal 7 的功能,并进行了大量自定义和投资,以打造特定的开发者体验。
由于 Drupal 7 和 Drupal 8 之间存在重大差异(例如网页呈现引擎),因此重新创建类似的自定义项可能需要进行大量自定义工作。如果您预计需要聘请 Drupal 8 专家,您的 Apigee 客户代表可以为您推荐 Drupal 开发专家合作伙伴。虽然 Apigee 不为 D8P 提供托管服务,但 Pantheon 和 Acquia 有为 Apigee 客户托管 D8P 的经验。
选项 3:继续使用 Drupal 7
哪些人应该考虑这一点?
已经在使用 Drupal 7 的 API 提供方,他们只是希望有更多时间来做出决定。
Drupal 7 项目已发布 2021 年长期支持 (LTS) 的时间表。此托管服务公告不会影响将 Drupal 7 与 Apigee Edge 集成的模块的支持。不过,请注意,任何希望继续使用 Drupal 7 的云客户都必须在 2020 年 5 月 31 日之前直接向托管服务提供商承担账号责任。
如何导出我的数据(云端客户)?
如需导出 Drupal 数据,请参阅 Pantheon 或 Acquia 导出流程。
如果我未采取必要的措施,会出现什么情况?
2020 年 5 月 31 日之后,您和您的客户将无法再使用 D7P。您将无法在 D7P 上进行管理或开发,您的客户也无法登录您的 D7P 门户。所有 Apigee 托管的 D7P 门户都将于 2020 年 5 月 31 日之后停用。
我该向谁寻求更多信息或帮助?
如需详细了解 D7P 托管服务的结束,请在 Apigee 支持门户中创建工单,并在主题行中填写“基于 Drupal 7 的开发者门户 - 托管”。
是否有任何工具或支持可帮助将 D7P 迁移到 D8P?
虽然 Apigee 不为 Drupal 提供直接支持,但您的 Apigee 客户代表可以为您联系 Drupal 专家,他们可以协助您进行迁移和自定义开发。
是否有任何工具或支持可帮助将 D7P 迁移到集成门户?
如需有关如何规划和执行将 Drupal 7 门户资源迁移到集成门户的指导,请参阅将 Drupal 7 门户迁移到集成门户。
虽然没有可用于从 Drupal 迁移到 Apigee 管理的门户的工具,但 Apigee 或许可以协助您完成迁移。最适合迁移的应用是那些未在可能无法顺利迁移的自定义开发(例如特定工作流或审批工具)上投入大量资源的应用。 如需了解详情,请与您的 Apigee 客户代表联系。
SmartDocs 发生了哪些变化?
以下部分介绍了与 Drupal 7 相比,Drupal 8 中新版 SmartDocs 所做的更改。
新版 SmartDocs 功能与基于 Drupal 7 的版本相比如何?
您可能熟悉与 Drupal 7 开发者门户搭配使用的 SmartDocs。请参阅使用 SmartDocs 为 API 编写文档。
Drupal 8 中的 SmartDocs 提供了您在 API 参考文档中常见的许多功能,现在可直接从 OpenAPI 规范运行。如需了解详情,请参阅为 API 编写文档。
SmartDocs 是否支持 OpenAPI 规范 3.0.x?
Drupal 8 门户中提供的新版 SmartDocs 支持 OpenAPI 规范 3.0.x。未来,我们将改进对规范新功能的支持。
SmartDocs 支持哪些类型的身份验证?
根据您的 OpenAPI 规范中定义的安全方法,SmartDocs 中的“试用此 API”面板可用于不安全的端点或使用基本身份验证、API 密钥身份验证或 OAuth 身份验证的安全端点。对于 OAuth,支持以下流程:授权代码、隐式身份验证、密码和客户端凭据。
SmartDocs 是我生成 API 文档的唯一选项吗?
SmartDocs 是 Apigee 提供的基于 OpenAPI 规范的 API 文档开箱即用解决方案,但 Apigee 也认识到,拥有多种选择是件好事。 对于 Drupal 8 门户,API Catalog 模块支持其他呈现解决方案,例如 Swagger 界面字段格式设置。