与 Acquia 合作

您正在查看的是 Apigee Edge 文档。
转到 Apigee X 文档。 信息

Apigee 使用网站管理服务 Acquia 来托管开发者服务门户的云端版本。Acquia 可与 Drupal 搭配使用，以便您在安全的环境中开发、测试和发布门户。

以下各部分介绍了如何使用 Acquia 开发和管理您的门户。

访问 Acquia Cloud 界面

设置 Acquia Cloud 帐号后，您可以通过 Acquia Cloud 界面 (https://cloud.acquia.com/) 访问您的门户。

当您首次登录时，系统会显示应用页面，如下图所示。

“应用”页面显示了您有权访问的托管在 Acquia Cloud 上的所有应用。应用是您在 Acquia Cloud 中管理的软件实体，例如基于 Drupal 的门户网站。

以下部分介绍如何使用 Acquia Cloud 界面管理门户内容。

如需详细了解 Acquia Cloud 界面，请参阅 Acquia Cloud 文档中的登录 Acquia Cloud 界面和使用 Acquia Cloud 管理应用。

管理您的环境

访问 Acquia Cloud 界面，在“应用”页面上点击与您的门户网站关联的管理以访问其信息中心。

为了管理您的工作流，我们提供了三种环境供您开发、测试和发布门户，如下表所述。您的门户已部署到每个环境，但可能处于不同的状态，具有唯一的代码分支或标记、数据库等。请参阅将代码部署到门户环境。

环境 说明 默认网址
开发版 开发新功能并自定义您的门户。 http://{application-name}xxxxxx.devcloud.acquia-sites.com/

其中，application-name 是应用的名称，xxxxxx 是用于区分 Dev 和 Stage 的唯一字符串。
阶段 先测试最新代码，然后再将其推送到生产环境。 http://{application-name}yyyyyy.devcloud.acquia-sites.com/

其中，application-name 是应用的名称，yyyyyy 是用于区分 Dev 和 Stage 的唯一字符串。
生产 将您的门户发布为正式版（实时）。 http://{application-name}.devcloud.acquia-sites.com/

其中，application-name 是应用的名称。

注意：另请参阅配置自定义网域。

如需了解详情，请参阅 Acquia Cloud 文档中的使用环境。

开发门户

以下部分介绍如何开发门户。

此外，如需详细了解如何自定义门户，请参阅以下部分。

如果您想要...

您可以

更多信息

更改网站的外观和风格

基本 - 使用门户网站上的外观菜单项进行更改，例如修改徽标和网站颜色。

请参阅自定义外观

高级 - 如需修改网站的完整外观和风格，请扩展 Apigee 自适应主题背景。

请参阅自定义主题背景。

更改网站功能的行为

基本 - 使用门户上的管理员设置来更改/配置网站的行为方式。

请参阅此处的 Apigee 文档

高级 - 创建自定义模块以更改网站的任何行为。

请参阅 Drupal 文档中的创建自定义模块

Git 代码库概览

Drupal 代码的 Git 代码库包含您的所有门户代码，并且按以下结构进行整理。

注意：请只修改 /sites/all 目录中的内容。如果您修改了 /sites/all 目录之外的内容，则会在升级到新版本时遇到问题，并且在签入 Git 的更改时可能会遇到合并冲突。

Git 代码库中的文件夹

说明
/profiles/apigee

Apigee 维护了多个模块和主题，包括：

  • /profiles/apigee/modules/contrib：由 Apigee 维护的 Drupal contrib 模块
  • /profiles/apigee/themes/contrib：由 Apigee 维护的 Drupal contrib 主题
  • /profiles/apigee/modules/custom：Apigee 创建的自定义模块
  • /profiles/apigee/themes/custom：Apigee 创建的自定义主题

注意：请勿修改 /profiles/apigee 目录中的内容，否则在升级到新版本时会遇到问题，并且在签入 Git 的更改时可能会遇到合并冲突。如需了解 Drupal 最佳实践，请参阅永不入侵核心。
/sites/all

您的自定义 Drupal 模块和主题。如需了解如何管理此文件夹中的内容，请参阅添加自定义模块和主题背景以及替换 Drupal 配置文件模块和主题背景。

注意：请只修改 /sites/all 目录中的内容。

访问代码

为了访问 Git 中的代码库，您需要执行下面几部分中介绍的任务：

另请参阅如何访问 Drupal 7 开发者门户源代码？

启用对服务器的 SSH 访问权限

您必须先启用 SSH 以访问您的服务器，然后才能使用 Git 管理您的 Drupal 代码。如需了解详情，请参阅 Acquia Cloud 文档中的启用 SSH 访问。

如需启用 SSH 访问权限，请执行以下操作：

  1. 访问 https://accounts.acquia.com 并登录 Acquia Accounts 界面。
  2. 点击凭据。
  3. 如果系统提示，请重新输入密码以确认您的身份。
  4. 在 SSH 密钥下，点击添加 SSH 密钥。
  5. 输入以下信息：
    字段 说明
    昵称 SSH 密钥的昵称。别名可以包含字母数字字符和下划线。
    公钥 公钥。

    如需了解如何生成 SSH 公钥，请参阅 Acquia Cloud 文档中的生成 SSH 公钥。
  6. 点击添加密钥。

访问 Git 中的代码库

Git 代码库包含门户网站的所有代码。您可以添加新代码或自定义现有代码，以配置您的门户。如需了解详情，请参阅 Acquia Cloud 文档中的使用代码库。

如需访问 Git 代码库中的代码库，请执行以下操作：

  1. 访问 https://cloud.acquia.com/ 登录 Acquia Cloud 界面。
  2. 在“应用”页面上，点击管理以查看门户的详细信息。
  3. 点击导航栏中的应用信息。

  4. 在“Application Information”对话框中复制克隆命令。
  5. 通过执行以下任一 Git 命令，将 Git 代码库克隆到本地环境：

    如需克隆 Git 代码库并创建一个新分支，请执行以下操作：

    > git clone --branch [branch] myportal@abcdef.devcloud.hosting.acquia.com:myportal.git [destination]

    如需从 master 分支克隆 Git 代码库，请执行以下操作：

    > git clone myportal@abcdef.devcloud.hosting.acquia.com:myportal.git [destination]

  6. 当您准备好暂存、提交并使用“应用”窗口中显示的相关命令将更改推送到 Git 代码库时，请重复执行这些步骤。

    当您将分支提交到代码库时，Acquia Cloud 会更新运行该代码分支的环境。您可以将代码部署到门户环境，如下一部分中所述。

将代码部署到门户环境

如需在门户环境中部署、切换或还原代码，在环境之间移动代码，或详细了解代码库结构和建议的工作流，请参阅 Acquia Cloud 文档中的在 Aquia Cloud 上使用站点。将新代码部署到环境时，您需要运行 update.php 才能进行所需的数据库更新。

添加自定义模块和主题

您可将自己的自定义模块和主题添加到下表中列出的文件夹中，从而扩展该门户的功能。

注意：请只修改 /sites/all 目录中的内容。如果您修改了 /sites/all 目录之外的内容，则在签入 Git 的更改时可能会遇到合并冲突。

模块/主题 Git 代码库中的文件夹 更多信息（Drupal 文档）
自定义模块 sites/all/modules/custom 创建自定义模块
自定义主题 sites/all/themes 自定义主题
Theming Drupal 7

在 Dev 环境中添加自定义模块或主题后，您可以将其部署到 Test 以进行测试，然后再将其部署到 Live 环境用于生产环境，如将代码部署到门户环境中所述。

替换 Drupal 配置文件模块和主题

以下目录中的模块和主题会覆盖由 Apigee 在 /profiles/apigee 中维护和分发的 Drupal 配置文件模块和主题。请参阅 Git 代码库概览。

例如，在以下情况下，您可能需要替换 Apigee Drupal 发行版中的模块：

  • 您想使用特定模块的其他版本。
  • 您希望在排定的下一个 Apigee 版本发布之前实施安全更新。
模块/主题 Git 代码库中的文件夹 更多信息（Drupal 文档）
Drupal 贡献的模块 sites/all/modules/contrib

注意：存储在 /sites/all/modules 下任何位置的模块将替换 Apigee Drupal 分发模块。

 贡献的模块

注意：此目录中的 Drupal 贡献的模块会替换由 Apigee 在 /profiles/apigee/modules 中维护和分发的等效模块。 如果您想要使用 Apigee 维护的 Drupal 配置文件模块，请移除您添加到此文件夹中的所有重复模块。
Drupal 贡献的主题背景 sites/all/themes 贡献的主题背景

注意：此目录中的 Drupal 贡献的主题会覆盖由 Apigee 在 /profiles/apigee/themes 中维护和分发的等效模块。如果希望使用 Apigee 维护的配置文件主题，请移除您添加到此文件夹的任何重复模块。

启用 SSL

要使用 HTTPS 实现对网站的安全访问，您必须启用 SSL。

如需启用 SSL，请执行以下操作：

  1. 从证书授权机构 (CA) 或 SSL 证书供应商获取 SSL 证书。请参阅启用 SSL。
  2. 在 Acquia Cloud 界面的 SSL 页面上上传 SSL 证书。请参阅管理 SSL 证书。

保护生产环境

首次创建应用时，您可以自由管理生产环境，并从开发和预演环境传播更改。发布内容后，您可能希望锁定生产环境，以防止内容发生未经授权的更新或意外更新。如需了解详情，请参阅 Acquia Cloud 文档中的使用生产模式保护实时应用。

为保障生产环境的安全，请采取以下措施：

  1. 访问 https://cloud.acquia.com/ 登录 Acquia Cloud 界面。
  2. 在“应用”页面上，点击管理以查看门户网站的详细信息。
  3. 点击生产以查看生产环境的详细信息。
  4. 点击导航栏中的 Production Mode（正式版模式）。
  5. 点击启用以启用生产模式。

将模块和主题更新应用于门户

Apigee 会定期将您门户中的模块和主题自动更新到最新版本。仅对开发环境进行更新，并添加标签，以指明需要将其迁移到其他门户环境。

如果您的网站不属于 Apigee Acquia 结算组织（例如，从其他托管服务提供商迁移到您自己的组织的新网站），您必须允许 Apigee 访问您的 Git 代码库，才能接收自动发送的 Devportal 更新推送。如需了解详情，请与 Apigee 支持团队联系。

如果您添加了任何自定义模块或主题，则需要手动进行更新。

下表总结了对门户应用模块和主题更新所需的步骤。

模块/主题 说明
Apigee Edge 模块

Apigee 只会将更新自动应用于 Dev 环境。

测试更新后，请按照将代码部署到门户环境中所述，将其从开发环境迁移到预演环境，再迁移到生产环境。
Apigee 自适应主题

Apigee 只会将更新自动应用于开发环境。

测试更新后，请按照将代码部署到门户环境中所述，将其从开发环境迁移到预演环境，再迁移到生产环境。
Drupal 核心模块和贡献模块

Apigee 只会将更新自动应用于开发环境。

测试更新后，请按照将代码部署到门户环境中所述，将其从开发环境迁移到预演环境，再迁移到生产环境。
自定义模块和主题

如果您已按照添加自定义模块和主题中的说明向门户添加了自定义模块和主题，则必须手动安装更新。

手动或使用 Drush 将最新版本下载到本地目录。然后暂存、提交更新，并将其推送到 Git 代码库。测试更新后，请按照将代码部署到门户环境中所述，将其从开发环境迁移到预演环境，再迁移到生产环境。

迁移自定义功能

如果您向门户添加自定义代码或配置，则需要对其进行维护，并将其从开发环境迁移到阶段再到生产环境。

对于 Git 代码库中的代码，您可以按照将代码部署到门户环境中所述的过程，将代码从开发阶段迁移到阶段再到生产。

如果您创建了任何自定义配置，请使用以下方法之一进行迁移：

方法 说明
将配置导出到代码 许多常见配置可“导出”至使用功能模块进行编码。例如，视图、面板、图片缓存等。
实现 hook_update_N() 函数 Drupal 使用 hook_update_N() 函数来管理数据库和配置更改。

如果您有自定义模块，则可以：

  • 将 hook_update_N() 函数添加到模块的 .install 文件中，以处理您的更改。
  • 将这些更改与您的代码一起部署。
  • 运行 update.php 以迁移 Stage 和生产环境中的更改。

配置自定义网域

如管理环境中所述，门户环境的默认域名均以 acquia-sites.com 结尾。建议您提供自己的自定义域名，这种域名可以个性化并更好地传达您网站的目的。例如，常见的替代方式是：

https://developers.mycompany.com

要配置自定义网域，请执行以下操作：

  1. 将您的网域添加到门户网站环境。请参阅 Acquia Cloud 文档中的管理网域。
  2. 通过将域名的 DNS 记录条目指向公共 IP 地址（而不是 acquia-sites.com 网域），通过 DNS 提供商设置自定义网域。请参阅 Acquia Cloud 文档中的将 DNS 记录指向您的公共 IP 地址。

    注意：请勿将域名的 CNAME 条目设置为 acquia-sites.com 网域。否则可能会导致您的门户网站出现延迟问题或服务中断。

使用 Acquia Insight 监控门户

Acquia Insight 是一套工具，可让您通过监控门户的性能、安全性和搜索引擎优化来优化门户。有关详情，请参阅 Acquia Insight。

备份门户

下表总结了可用于备份门户组件的选项。

组件 备份详情 如需了解详情，请参阅 Acquia Cloud 文档
编码
  • 代码由版本控制系统维护，并在您每次提交时进行标记。
  • 随时同步或还原为特定的代码。
数据库
  • 每日备份执行和维护三天。
  • 安排自动和按需备份。
  • 所有数据的内部灾难快照每小时截取一次。
文件 执行手动备份或安排 Cron 作业。
完整应用 使用 Drush.
Drupal 文件系统 使用以下任一方式执行手动备份：
  • 使用 FTP 客户端或命令行工具（rsync 和 scp）复制文件。
  • 使用 Drush 创建压缩包。

注意：Acquia Cloud 不支持备份和迁移模块。如需了解详情，请参阅 Acquia Cloud 不支持备份和迁移模块。

查看活动通知

您可以查看活动通知，以跟踪门户网站上发生的重要操作，例如在环境之间安装或复制代码、数据库更新和备份、服务器更改等。如需了解详情，请参阅 Acquia Cloud 文档中的查看活动通知。

若要查看通知列表，请执行以下操作：

  1. 访问 https://cloud.acquia.com/ 登录 Acquia Cloud 界面。
  2. 在“应用”页面上，点击管理以查看门户网站的详细信息。
  3. 点击导航栏右上角的铃铛图标以查看最近的通知。

  4. 点击通知旁的箭头可查看有关该活动的详细信息。

订阅状态更新

您可以在 status.apigee.com 订阅 Apigee 版本和状态更新。点击订阅更新，在出现提示时输入您的联系信息（例如电子邮件地址），然后点击订阅。在电子邮件通知管理页面上，确保已选择开发者门户，根据需要切换其他通知设置，然后点击更新偏好设置。

您可以订阅 Acquia 状态更新，接收有关任何服务中断、紧急维护或平台安全更新的通知。如需订阅 Acquia Cloud 更新，请执行以下操作：

  1. 前往“Acquia Status”页面。
  2. 点击订阅更新。
  3. 选择接收更新的方式（电子邮件、短信等）。
  4. 在“通知”页面上，选择您想要接收其状态更新的产品。例如 Acquia Cloud Enterprise。
  5. 点击更新偏好设置。