ECE-Tools發行說明

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-tools從env.php檔案讀取驗證器之DB連線的driver_options組態。

已新增對Composer 2.0的支援。

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

已更新終止軟體檢查(eol.yaml)以包含Elasticsearch 7.9.x。

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才能使其網站運作的問題。

遠端儲存 — 已新增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驗證。

快取:flush記錄 — 已改善記錄專案以指出cache:flush步驟的開始和完成。

已新增當靜態內容設定為在建置階段中部署時，唯讀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 Commerce Elasticsearch模組相容的Elasticsearch版本。 錯誤訊息現在會提供要在您的雲端基礎結構中安裝的特定Elasticsearch版本，以便與您的Adobe Commerce版本使用的Elasticsearch模組相容。 檢視警告錯誤，部署階段.

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

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

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

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

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

已新增其他錯誤檢查以建置、部署和部署後處理，並改善現有檢查：

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

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

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

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

基礎結構更新—

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

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

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

• 已更新套用修補程式的generate.xml組建案例工作流程。 必須先套用修補程式，才能更新Adobe Commerce，修正可能導致di:compile和module: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變數的組態決定。

驗證改善—

• Elasticsearch 7.x相容性檢查 — 已針對Elasticsearch 7.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.

基礎結構更新—

• 新增適用於Commerce的Cloud Docker的個別套件 — 將Docker套件與ece-tools套件脫鉤，以維持程式碼品質並提供獨立的發行版本。 從magento-cloud-docker GitHub存放庫管理與ece-tools相關的更新與修正。

• 更新的修補功能 — 將修補功能從ECE-Tools套件移至單獨的magento-cloud-patches套件。 部署期間，ece-tools會使用新套件套用修補程式。 請參閱雲端修補程式發行說明.

• 已更新撰寫器相依性 — 已更新雲端基礎結構上Adobe Commerce的composer.json檔案與magento/magento-cloud-docker套件的相依性。 現在，ece-tools包含Cloud Tools Suite for Commerce中所有套件的相依性。 當您安裝或更新ece-tools時，會自動安裝及更新這些套件。

情境式部署的支援—

• 現在您可以使用XML組態檔自訂建置、部署和部署後程式，以覆寫或自訂預設組態。

• 已在.magento.app.yaml​中變更hooks設定 — 我們已更新hooks設定格式以支援案例部署。 舊版ECE-Tools 2002.0.x仍受支援。 不過，您必須更新為新格式，才能使用以案例為基礎的部署功能。 請參閱案例部署。

服務更新—

• 已新增對PHP 7.3的支援。

• 已新增對RabbitMQ 3.8的支援。

• 已新增驗證，以對照每項服務的EOL日期檢查已安裝的服務版本。 現在，如果服務版本在EOL日期後的三個月內，客戶將會收到通知，如果EOL日期是過去，客戶將會收到警告。

• 修正Elasticsearch設定問題，以確保在所有環境中都設定了正確的Elasticsearch設定。

環境變數更新—

• 已擴充WARM_UP_PAGES環境變數的功能，以支援特定產品頁面的快取預先載入。 請參閱部署後變數主題中的展開定義。

• 已新增ERROR_REPORT_DIR_NESTING_LEVEL環境變數，以簡化<magento_root>/var/report/目錄中的錯誤報告資料管理。 請參閱組建變數主題中的變數說明。

• 已移除SCD_EXCLUDE_THEMES、STATIC_CONTENT_THREADS、DO_DEPLOY_STATIC_CONTENT和STATIC_CONTENT_SYMLINK環境變數。 請參閱回溯不相容的變更.

• 修正Elastic Suite組態程式中的問題，以便在您設定不含_merge選項的ELASTICSUITE_CONFIGURATION部署變數時，依照預期覆寫預設組態。

CLI命令更新—

• 新cron命令 — 您現在可以使用cron:disable和cron:enable命令，在雲端基礎結構環境上的Adobe Commerce中手動管理cron處理。 使用disable命令可停止所有作用中的cron處理序，並停用所有cron工作。 使用enable指令可在準備就緒時重新啟用cron作業。 請參閱停用cron工作。

• 已改善錯誤報告 — 已針對ECE-Tools處理期間發生的CLI命令失敗新增更佳的記錄。

• 移除已棄用的組建命令 — 移除下列組建命令： m2-ece-build、m2-ece-deploy、m2-ece-scd-dump，並將ece-tools docker命令重新命名為ece-docker。 請參閱回溯不相容的變更

已移除已棄用的build_options.ini檔案，並新增驗證，以便在檔案存在時讓組建失敗。 使用.magento.env.yaml檔案來設定組建選項。

修正當config.php檔案為空時，造成建置流程失敗的問題。