Cloud Manager中的环境变量 environment-variables
可以通过 Cloud Manager 配置和管理标准环境变量。 这些变量提供给运行时环境,可以在 OSGi 配置中使用。
根据所更改的内容,环境变量可以是特定于环境的值或环境密钥。
关于环境变量 overview
环境变量可为AEM as a Cloud Service用户提供以下好处:
- 这些变量允许代码和应用程序的行为根据上下文和环境而变化。 例如,它们可用于在开发环境中启用与生产或暂存环境不同的配置,以避免代价高昂的错误。
- 它们只需要配置和设置一次,并且可以在必要时更新和删除。
- 它们的值可以随时更新并立即生效,而无需更改或部署代码。
- 它们可以将代码与配置分离,并消除在版本控制中包含敏感信息的需要。
- 它们提高了AEM as a Cloud Service应用程序的安全性,因为它们位于代码库之外。
使用环境变量的典型用例包括:
- 将AEM应用程序与其他外部端点连接。
- 在存储密码时使用引用,而不是将其直接存储在代码库中。
- 一个程序中存在多个开发环境,并且某些配置因环境而异。
添加环境变量 add-variables
如果要添加多个变量,Adobe建议您添加第一个变量,然后在 环境配置 对话框中使用
要添加、更新或删除环境变量,您必须是部署管理器角色的成员。
添加环境变量:
-
在 my.cloudmanager.adobe.com 登录 Cloud Manager 并选择适当的组织。
-
在 我的程序 控制台上,选择要管理的程序。
-
从侧菜单单击环境。
-
在 环境 页面上,选择表中包含要为其添加环境变量的环境的行。
-
在环境的详细信息页面上,单击 配置 选项卡。
-
单击
添加/更新。
如果您是第一次添加环境变量,请单击页面中央的添加配置。
-
在 环境配置 对话框中,在表的第一行中输入详细信息。
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 字段 描述 名称 配置变量的唯一名称。 它标识在环境中使用的特定变量。 它必须遵循以下命名惯例:
- 变量只能包含字母数字字符和下划线(
_)。 - 每个环境最多有400个变量。
- 每个名称的长度必须等于或少于100个字符。
值 变量保存的值。 已应用步骤 选择变量应用于的服务。 选择 全部 以将变量应用于所有服务。
- 全部
- 作者
- 发布
- 预览
类型 选择变量是普通变量还是密钥。
- 变量只能包含字母数字字符和下划线(
-
单击
添加。根据需要添加其他变量。
-
单击保存。
状态为 正在更新 的进度环显示在表的右上角。 任何新添加的变量左侧也会显示一个旋转图标。 这些状态表示正在使用配置更新环境。 完成后,新的环境变量会显示在表中。
更新环境变量 update-variables
创建环境变量后,可以使用
如果要更新多个变量,Adobe建议您在单击 保存 之前,使用 环境配置 对话框一次更新所有必需的变量。 此方法允许您通过单个环境更新来更新它们。
要更新环境变量:
-
在 my.cloudmanager.adobe.com 登录 Cloud Manager 并选择适当的组织。
-
在 我的程序 控制台上,选择要管理的程序。
-
从侧菜单单击环境。
-
在 环境 页面上,选择表中包含要更新变量的环境的行。
-
在环境的详细信息页面上,单击 配置 选项卡。
-
单击
添加/更新。 -
在 环境配置 对话框中,单击要更改的变量行最后一列中的
。 -
在下拉菜单中,单击编辑。
-
根据需要更新环境变量的值。
编辑密钥时,只能更新值,不能查看。
-
执行下列操作之一:
- 单击
以应用更改。 - 单击
以撤消更改。
- 单击
-
单击保存。
状态为 正在更新 的进度环显示在表的右上角。 旋转图标也会出现在任何已更新变量的左侧。 这些状态表示正在使用配置更新环境。 完成后,更新的环境变量将显示在表中。
删除环境变量 delete-env-variable
- 在 my.cloudmanager.adobe.com 登录 Cloud Manager 并选择适当的组织。
- 在 我的程序 控制台上,选择要管理的程序。
- 从侧菜单单击环境。
- 在 环境 页面上,选择表中包含要更新变量的环境的行。
- 在环境的详细信息页面上,单击 配置 选项卡。
- 单击
添加/更新。 - 在 环境配置 对话框中,单击要更改的变量行最后一列中的
。 - 在下拉菜单中,单击 删除 以立即删除变量。
- 单击保存。
使用环境变量 using
环境变量可以使您的 pom.xml 配置更安全、更灵活。 例如,密码不需要硬编码值,并且您的配置可以适应环境变量值。
您可以通过XML访问环境变量和密钥,如下所示:
${env.VARIABLE_NAME}
有关如何在pom.xml文件中同时使用这两种类型的变量的示例,请参阅设置项目。
有关更多详细信息,另请参阅官方Maven文档。
环境变量的可用性 availability
环境变量可在多个位置使用,如下所示:
只有常规环境变量可用于 Dispatcher。
- 无法使用密钥。
- 无法在
IfDefine指令中使用环境变量。 - 在部署之前,使用 Dispatcher 在本地验证环境变量的使用情况。