ECE-Tools發行說明

ece-tools套件是一組指令碼和工具,用來管理和部署雲端專案。 此發行說明說明說明說明此套件的最新改善,此套件隸屬於Commerce適用的雲端工具套裝

NOTE
請參閱升級ECE-Tools,以取得有關更新至最新版ece-tools套件的資訊。

ece-tools封裝使用下列發行版本設定順序: 200<major>.<minor>.<patch>

發行說明包括:

  • 新圖示 新功能
  • 修正圖示 修正和改良

v2002.2.0 latest

發行日期: 2024年10月7日

  • 新圖示 MariaDB 11.4 — 新增MariaDB 11.4的支援。
  • 修正圖示 重構的程式碼 — 已移除舊版PHP 7.4、7.3、7.2及相關程式庫的支援。
  • 修正圖示 升級的Monolog版本 — 新增對monolog 3.6的支援。
  • 修正圖示 RabbitMQ、MariaDB及PHP的驗證器 — 修正產生錯誤服務版本之錯誤訊息的驗證器。

v2002.1.19

發行日期: 2024年5月21日

  • 新圖示 Lua — 已為CACHE_CONFIGURATION新增選項useLua。
  • 修正圖示 驗證器 — 已更新Redis和RabbitMQ新版本的驗證器。

v2002.1.18

發行日期: 2024年4月8日

  • 新圖示 PHP — 已新增對PHP 8.3的支援。
  • 修正圖示 驗證器 — 已更新EOL驗證器。

v2002.1.17

發行日期: 2024年1月16日

  • 修正圖示 Elasticsearch與OpenSearch的驗證器 — 修正啟用LiveSearch時,產生錯誤訊息以安裝搜尋服務的驗證器。
  • 修正圖示 部署警告 — 修正導致非空白資料夾出現部署警告的問題。

v2002.1.16

發行日期: 2023年10月16日

  • 新圖示 ENABLE_WEBHOOKS全域環境變數 — 已新增ENABLE_WEBHOOKS全域變數,以搭配Commerce webhooks使用來連線至外部端點,例如App Builder執行階段動作或協力廠商詳細目錄管理系統。

v2002.1.15

發行日期: 2023年7月31日

  • 修正圖示 錯誤碼 — 已更新錯誤碼結構描述和錯誤碼檔案產生器。
  • 修正圖示 自訂Redis模型的驗證器 — 已更新自訂Redis後端模型的驗證器。 檢視快取組態的範例
  • 修正圖示 RabbitMQ的驗證器 — 新增RabbitMQ 3.11的支援
  • 修正圖示 修正錯誤的連結 — 修正歡迎電子郵件範本中上線檔案的錯誤連結。

v2002.1.14

發行日期: 2023年3月10日

  • 新圖示 PHP — 已新增對PHP 8.2的支援。
  • 新圖示 服務的驗證器 — 已更新Commerce 2.4.6必要服務的驗證器: MariaDB 10.6、Redis 7.0、PHP 8.2、OpenSearch 2.x和RabbitMQ 3.9。
  • 修正圖示 ece-tools db-dump — 修正db-dump作業過早停止的問題。

v2002.1.13

發行日期: 2022年10月27日

  • 新圖示 已新增對Adobe CommerceAdobe I/O事件的支援。 擴充功能開發人員現在可以使用Adobe I/O事件架構,將Commerce事件資訊從雲端執行個體傳送至其為AdobeApp Builder撰寫的應用程式。 Adobe Commerce的Adobe I/O事件在合作夥伴預覽中。
  • 新圖示 OPcache組態的驗證器 — 新增驗證器以檢查排除路徑的OPcache組態。
  • 修正圖示 修正GraphQL快取組態的問題 — 現在ECE-Tools會將GraphQL id_salt值保留在app/etc/env.php檔案的cache組態中。

v2002.1.12

發行日期: 2022年9月13日

  • 新圖示 啟用synchronous_replication — 啟用MYSQL_USE_SLAVE_CONNECTION時,ECE-Tools會在app/etc/env.php檔案中設定synchronous_replication=>true。 此設定僅影響Commerce 2.4.6+。 檢視部署變數. 中的MYSQL_USE_SLAVE_CONNECTION變數說明
  • 新圖示 OpenSearch — 新增功能以設定和設定下一個Adobe Commerce版本2.4.6的opensearch引擎。請參閱設定OpenSearch服務

v2002.1.11

發行日期: 2022年8月4日

  • 修正圖示 ElasticSuite Validator與OpenSearch — 修正安裝OpenSearch時的ElasticSuite完整性檢查驗證器問題。
  • 修正圖示 部署命令的傳回型別 — 修正部署命令的傳回型別。
  • 修正圖示 RabbitMQ新Commerce 2.4.5安裝的問題 — 修正新Commerce 2.4.5安裝上的RabbitMQ當機問題。

v2002.1.10

發行日期: 2022年3月31日

  • 修正圖示 Elasticsearch7.10 — 更新驗證器以支援7.10版本的Elasticsearch。

v2002.1.9

發行日期: 2022年3月10日

  • 新圖示 OpenSearch — 已新增對Adobe Commerce 2.4.4、2.4.3-p2和2.3.7-p3版本的OpenSearch的支援。

  • 新圖示 PHP — 已新增對PHP 8.1的支援。

  • 修正圖示 symfony/process — 已新增與symfony/process ^5.3的相容性。

  • 新圖示 取用者多個處理序 — 已新增multiple_processes選項,以便您可以指定每個取用者要衍生的處理序數目。 檢視部署變數.中的CRON_CONSUMERS_RUNNER變數說明

  • 新圖示 OpenSearch配置與完整主機路徑 — 已新增設定Elasticsearch配置與完整主機路徑的功能。

  • 修正圖示 AWS S3 — 變更AWS S3啟用方法。

  • 修正圖示 修正driver_options讀取器 — 已新增由ece-toolsenv.php檔案讀取驗證器之DB連線的driver_options組態。

v2002.1.8

發行日期: 2021年10月25日

  • 新圖示 替代傾印位置 — 已新增--dump-directory選項,讓您可以選擇資料庫傾印的目標目錄。 現在/app/var/dump-main是DB傾印的預設目標目錄。 請參閱備份管理:傾印您的資料庫
  • 修正圖示 更新獨白 — 已將monolog封裝所需的最低版本更新為^2.3
  • 修正圖示 更新Symfony — 已更新Symfony相依性以與Adobe Commerce 2.4.4相容。
  • 修正圖示 功能/解決自動載入 — 修正部署至整合環境並看到CRITICAL: [9] Required configuration is missed in autoload section of composer.json file.錯誤時所發生的問題。

v2002.1.7

發行日期: 2021年7月29日

設定更新

  • 新圖示 已新增對Composer 2.0的支援。

  • 修正圖示 已更新symphony/console ​的撰寫器需求 — 已更新symphony/console套件的ECE-Tools composer.json版本需求,以修正導致di:compile命令失敗並出現下列錯誤的問題: Incompatible argument type: Required type: int. Actual type: string

  • 修正圖示 已更新終止軟體檢查(eol.yaml)以包含Elasticsearch7.9.x。

v2002.1.6

發行日期: 2021年4月20日

  • 新圖示 Redis驗證認證 — 已新增在部署階段從relationships屬性讀取Redis授權認證的功能。

  • 新圖示 Elasticsearch授權認證 — 已新增在部署階段從relationships屬性讀取Elasticsearch授權認證的能力。

  • 新圖示 專用工作階段存放服務 — 已新增redis-session作為工作階段存放的第二個選項。 您可以使用redis-session服務來儲存工作階段資訊,並使用redis服務來快取,以提供更好的效能。

  • 新圖示 已棄用的SPLIT_DB訊息 — 已針對Adobe Commerce 2.4.2的已棄用SPLIT_DB選項新增驗證器警告和嚴重訊息,並將其在Adobe Commerce 2.5.0中移除。

  • 修正圖示 來自關係的Elasticsearch版本 — 修正服務驗證器,以從Cloud Docker和整合環境中的relationships屬性擷取正確的Elasticsearch版本。

  • 修正圖示 彈性Redis連線埠驗證—Redis現在可以從server URL驗證自訂快取連線中的連線埠。 例如,您可以將連線埠號碼新增至伺服器URL,如下所示: server: 'tcp://rfs-store-simple-page-cache:26379'。 這有助於避免發生port選項遺失或不正確的驗證錯誤。

  • 修正圖示 升級至Adobe Commerce 2.4.2 — 修正使用者在升級至Adobe Commerce 2.4.2後必須手動執行bin/magento setup:upgrade才能使其網站運作的問題。

v2002.1.5

發行日期: 2021年2月1日

  • 新圖示 遠端儲存 — 已新增REMOTE_STORAGE環境變數,以啟用雲端專案來使用儲存服務(例如AWS S3)遠端儲存媒體檔案。 此設定選項是ECE-Tools套件的一部分,但在雲端基礎結構上的Adobe Commerce上不受支援。

  • 新圖示 cloud:config:validate命令 — 已新增命令php vendor/bin/ece-tools cloud:config:validate,以便在推送變更至遠端雲端環境之前驗證.magento.env.yaml設定。

  • 新圖示 正在排清opcache — 已新增對opcache.enable_cli PHP選項的支援,可在執行部署掛接之前排清OPcache。 此組態會重設快取組態,以確保目前的組態設定會套用到每個部署。

  • 新圖示 Aurora DB的驗證 — 已更新資料庫服務驗證,使其與Aurora資料庫相容。

  • 新圖示 新SCD_NO_PARENT環境變數 — 已新增SCD_NO_PARENT環境變數(適用於Adobe Commerce >=2.4.2)以管理父系主題的靜態內容產生。

  • 修正圖示 記憶體限制和命令 — 修正cloud.log檔案大小超過PHP memory_limit時,php vendor/bin/ece-tools命令無法運作的問題。 現在我們只從記錄檔讀取較小的資料子集,而不將整個cloud.log檔案讀取到記憶體中。

  • 修正圖示 自訂資料庫連線 — 修正未使用為DATABASE_CONFIGURATION定義的自訂資料庫連線的.magento.env.yaml組態問題。 未將連線設定新增到app/etc/env.php.

  • 修正圖示 空的錯誤記錄檔 — 修正在cloud.error.log為空時導致部署失敗的問題。

  • 修正圖示 MariaDB 10.3驗證 — 修正Adobe Commerce 2.3.6-p1的MariaDB 10.3驗證。

  • 修正圖示 快取:排清記錄 — 已改善記錄專案以指出cache:flush步驟的開始和完成。

v2002.1.4

發行日期: 2020年11月19日

  • 修正圖示 修正當SEARCH_CONFIGURATION環境變數中指定的搜尋引擎不是elasticsearch時,造成部署失敗的問題。

v2002.1.3

發行日期: 2020年11月9日

基礎結構更新

  • 新圖示 已新增當靜態內容設定為在建置階段中部署時,唯讀pub/static目錄的ECE-Tools支援。

  • 新圖示 已新增對Elasticsearch 7.9和Redis 6的支援,以便與即將發行的Adobe Commerce版本相容。

  • 修正圖示 已更新ECE-Tools composer.json,為品質修補程式工具新增必要的相依性。 這會修正ECE-Tools和magento-cloud-patches套件之間存在的循環相依性。

驗證和記錄改善

  • 新圖示 已新增搜尋引擎驗證,以確保在雲端基礎結構2.4和更新版本上為Adobe Commerce設定elasticsearch。 如果驗證失敗,部署將停止,並顯示嚴重錯誤訊息,建議修正問題。 檢視嚴重錯誤,部署階段.

  • 新圖示 已新增Elasticsearch驗證,以檢查Elasticsearch服務版本與Adobe Commerce版本之間的相容性。

  • 新圖示 已更新Elasticsearch相容性錯誤訊息,以顯示與Adobe CommerceElasticsearch模組相容的Elasticsearch版本。 錯誤訊息現在會提供要在您的雲端基礎結構中安裝的特定Elasticsearch版本,以便與您的Adobe Commerce版本使用的Elasticsearch模組相容。 檢視警告錯誤,部署階段.

  • 新圖示 已針對無效的MAGE_MODE環境變數設定新增警告錯誤20262027。 唯一有效值為production。 在此修正之前,MAGE_MODE可以設定為developer且沒有部署錯誤,只會在稍後嘗試寫入唯讀檔案時造成錯誤。 檢視警告錯誤.

  • 修正圖示 修正Redis、RabbitMQ和MySQL服務的驗證,以確保這些版本與Adobe Commerce版本相容。 這些服務的有效版本現在已寫入cloud.log.

  • 修正圖示 已更新cloud.log以納入快取熱身期間傳送要求的並行要求限制。 此值是在WARM_UP_CONCURRENCY部署後變數中設定。

CLI命令更新

  • 新圖示 已新增CLI命令(cloud:config:createcloud:config:update),以使用可包含一或多個組建、部署和部署後變數的設定來建立和更新.magento.env.yaml檔案。 請參閱從CLI建立組態檔

環境變數更新

  • 新圖示 已新增SKIP_COMPOSER_DUMP_AUTOLOAD組建變數。 將變數設為true會在Commerce的Cloud Docker安裝期間停止應用程式執行composer dump-autoload命令。 此變數僅與具有可寫入檔案系統(使用./vendor/bin/ece-docker build:compose --with-test為測試和開發而建立)之Commerce容器的Cloud Docker相關。 使用這類安裝,略過composer dump-autoload命令可防止執行其他命令時嘗試從已刪除的generated目錄存取檔案時發生錯誤。

v2002.1.2

發行日期: 2020年8月5日

驗證和記錄改善

  • 新圖示 已新增schema.error.yaml檔案,其中包含建置、部署和部署後程式期間可能發生的所有錯誤和警告通知,以及解決錯誤的建議。 此檔案中的資訊也可在Commerce的​ 雲端指南 ​中取得。 檢視ece-tools🔗的錯誤訊息參考。

  • 新圖示 已將雲端錯誤記錄(/var/log/cloud.error.log)專案變更為JSON格式,以便以程式設計方式更輕鬆地剖析記錄。

  • 新圖示 已新增其他錯誤檢查以建置、部署和部署後處理,並改善現有檢查:

    • 錯誤碼2026 — 無法將在建置階段產生的一些資料還原到掛載的目錄

    • 錯誤碼3004 — 無法建立備份檔案

    • 錯誤碼102 — 新增當env.php檔案不可寫入時所發生問題的額外檢查

  • 新圖示 已新增​ QUALITY_PATCH ​環境變數,以指定一或多個要在部署過程中套用的品質修補程式。 檢視建置變數.

v2002.1.1

發行日期: 2020年6月25日

  • 新圖示 基礎結構更新

    • 新圖示 記錄改善 — 將退出代碼指派給嚴重的部署錯誤,並在錯誤訊息通知和記錄事件中公開退出代碼,藉此改善記錄追蹤功能。 檢視ece-tools🔗的錯誤訊息參考。

    • 新圖示 改善資料庫傾印程式(vendor/bin/ece-tools db-dump)和更新的記錄訊息,以釐清資料庫傾印作業會將應用程式切換到維護模式、停止消費者佇列程式,以及在傾印開始之前停用cron工作。

    • 修正圖示 已修正問題,以確保在部署至中繼和生產環境時,專案URL會正確更新。 現在,ece-tools使用專案路由設定中設定了primary:true屬性的路由URL。 請參閱部署變數.

    • 修正圖示 已更新套用修補程式的generate.xml組建案例工作流程。 必須先套用修補程式,才能更新Adobe Commerce,修正可能導致di:compilemodule:refresh步驟失敗的任何問題。

    • 修正圖示 修正安裝過程中傳回Crypt key missing錯誤的問題。 crypt/key值會在安裝期間自動產生。

  • 新圖示 服務更新

    • 新圖示 已新增對PHP 7.4和MariaDB 10.4的支援。
  • 新圖示 環境變數更新

    • 新圖示 已新增​ SCD_USE_BALER ​變數,以在Adobe Commerce雲端基礎結構建置程式期間啟用JavaScript套件組合的Baler模組。 檢視組建變數.中的變數說明

    • 新圖示 已新增​ REDIS_BACKEND ​環境變數,以設定Adobe Commerce 2.3.5或更新版本的Redis快取的Redis後端模型。 檢視部署變數.中的變數說明

  • 新圖示 CLI命令更新

    • 新圖示 已更新下列CLI命令,其中包含更詳細的記錄選項:

      • app:config:dump
      • app:config:import
      • module:enable

      每個呼叫的記錄層級由.magento.env.yaml檔案中VERBOSE_COMMANDS變數的組態決定。

  • 新圖示 驗證改善

    • 新圖示 Elasticsearch7.x相容性檢查 — 已更新Elasticsearch7.x軟體相容性檢查的Elasticsearch驗證。

    • 新圖示 已更新服務版本和EOL驗證檢查 — 已更新驗證以根據Adobe Commerce 2.4檢查已安裝的服務版本。

    • 修正圖示 修正驗證問題,因此只有在.magento.app.yaml檔案中缺少post-deploy連結設定時,才會顯示下列部署後警告訊息:

      code language-text
      Your application does not have the "post_deploy" hook enabled.
      
    • 新圖示 已新增Zend Framework相依性的驗證 — 已新增已移轉至Laminas專案的Zend Framework的撰寫器相依性驗證。 如果缺少必要的相依性,則在建置過程中會顯示以下錯誤訊息。

      code language-text
      Required configuration is missing from the autoload section of the composer.json file.
      Add ("Laminas\Mvc\Controller\Zend\": "setupsrc/ Zend/Mvc/Controller/") to
      the `autoload -> psr-4` section. Then, re-run the "composer update" command locally, and
      commit the updated composer.json and composer.lock files.
      

      請參閱驗證Zend Framework相依性.

    • 新圖示 已新增env.php檔案和資料的驗證 — 在安裝和升級過程中已新增env.php檔案和資料的檢查。

      • 如果安裝遺失env.php檔案,且.magento.app.yaml檔案中未指定crypt/key值,則部署會失敗,並出現下列通知:

        code language-text
        The crypt/key key value does not exist in the ./app/etc/env.php file or the CRYPT_KEY cloud environment variable``Missing crypt key for upgrading Magento`.
        
      • 如果安裝不包含env.php檔案,或組態只包含一個快取型別,則在升級過程中會執行cron:enable命令,以還原包含所有cache_types的檔案。 下列通知已新增至記錄檔:

        code language-text
        Magento state indicated as installed but configuration file app/etc/env.php was empty or did not exist.
        Required data will be restored from environment configurations and from the .magento.env.yaml file.
        

v2002.1.0

發行日期: 2020年2月6日

05f2f56e-ac5d-4931-8cdb-764e60e16f26