变量级别

项目变量适用于项目中的所有环境。 环境变量适用于特定环境或分支。 环境 继承 变量定义。

您可以通过专门为环境定义变量来覆盖继承的值。 例如,要设置用于开发的变量,请在 .magento.env.yaml 文件。 从集成环境分支的所有环境都会继承这些值。 请参阅 部署配置 以了解有关使用配置环境的详细信息 .magento.env.yaml 文件。

CLI

使用Cloud CLI设置变量

  • 项目特定的变量 — 为设置相同的值 所有 环境的问题。 这些变量在所有环境中都可在生成和运行时使用。

    code language-bash
    magento-cloud variable:create --level project --name <variable-name> --value <variable-value>
    
  • 特定于环境的变量 — 为设置唯一值 特定 环境。 这些变量在运行时可用,并由子环境继承。 使用在命令中指定环境 -e 选项。

    code language-bash
    magento-cloud variable:create --level environment --name <variable-name> --value <variable-value>
    

设置特定于项目的变量后,必须手动重新部署远程环境,以使更改生效。 推送新的承诺以触发重新部署。

控制台

使用设置变量Cloud Console

  1. Cloud Console ​中,单击项目导航右侧的配置图标。

    配置项目 {width="36"}

  2. 要设置项目级变量,请在 项目设置 单击 变量.

    项目变量

  3. 要设置环境级变量,请在 环境 列表上,选择一个环境,然后单击 Variables 选项卡。

    “环境变量”选项卡

  4. 单击 Create variable.

  5. 提供变量的名称和值。 从以下选项中进行选择:

    • 运行时可用
    • 在构建期间可用
    • JSON值
    • 敏感变量(隐藏在控制台和CLI响应中的值)
    • 使可继承(子环境可以继承环境级变量)
  6. 单击 Create variable.

note caution
CAUTION
在中设置特定于环境的变量 Cloud Console 自动重新部署环境。

可见性

您可以使用限制变量在生成或运行时的可见性 --visible-<build|runtime> 命令。 此外,还可以选择设置继承和敏感度。

使用以下选项可防止查看或继承变量:

  • --inheritable false — 禁用子环境的继承。 这对于在下列位置设置仅用于生产的值很有用 master 分支并允许所有其他环境使用同名的项目级变量。
  • --sensitive true — 将变量标记为 不可读 在 Cloud Console. 您不能在用户界面中查看变量;但是,您可以从应用程序容器中查看变量,就像任何其他变量一样。

下面演示了阻止查看或继承变量的特定情况。 只能在CLI中指定这些选项。 此案例并非适用于所有可用的环境变量。

magento-cloud variable:create --name <variable-name> --value <variable-value> --inheritable false --sensitive true

验证变量级别和值

您可以使用Cloud CLI查看现有变量的列表。

magento-cloud variables
Variables on the project Project-Name (<project-id>), environment <environment-name>:
+----------------------------+-------------+-------------------------------------------+
| Name                       | Level       | Value                                     |
+----------------------------+-------------+-------------------------------------------+
| env:COMPOSER_AUTH          | project     | {                                         |
|                            |             |    "http-basic": {                        |
|                            |             |       "repo.magento.com": {               |
|                            |             |       "username":                         |
|                            |             | "<public-key>",                           |
|                            |             |       "password":                         |
|                            |             | "<private-key>"                           |
|                            |             |     }                                     |
|                            |             |   }                                       |
|                            |             | }                                         |
| ADMIN_EMAIL                | project     | admin@123.com                             |
| ADMIN_EMAIL                | environment | admin@123.com                             |
| ADMIN_PASSWORD             | environment | password                                  |
| ADMIN_URL                  | environment | admin123                                  |
| ADMIN_USERNAME             | environment | admin                                     |
| php:newrelic.license       | environment | xxxx71fb030366182117f955a22e4baf8exxxxxx  |
+----------------------------+-------------+-------------------------------------------+
recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26