變數層級

專案變數適用於專案內的所有環境。 環境變數會套用至特定環境或分支。 環境​ 從父環境繼承 ​變數定義。

您可以特別為環境定義變數,藉此覆寫繼承的值。 例如,若要設定開發所需的變數,請在整合環境的.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