ece-tools的發行說明封存

ECE-Tools封裝的變更

• 已將Adobe Commerce修補程式從ece-tools套件移至新的magento/magento-cloud-patches撰寫器套件。

• 已更新ece-tools封裝的composer.json檔案，以新增magento/magento-cloud-patches v1.0.0封裝的相依性。

• 修正從2.3.2-p2版或更新版本開始，在僅限安全性發行版本上套用修補程式集時，ece-tools修補程式中斷的問題。 此問題是由針對僅限安全性修補程式.採用的新版本化Scheme所引進

修補程式和重要修正 — 使用ece-tools版本2002.0.22更新您的雲端環境，以套用下列修補程式和重要修正。 這些修補程式包含在magento/magento-cloud-patches v1.0.0套件中。

• 2.3.1.x和2.3.2.x版本的Page Builder安全性修補程式 — 修正Page Builder預覽中的問題，該問題允許未經驗證的使用者存取某些範本化方法，這些方法可用於在網路(RCE)上觸發任意程式碼執行，從而導致全域資訊洩漏。 在Adobe Commerce 2.3.1和2.3.2.版中使用不支援的頁面產生器版本時，可能會發生此問題

• MSI修補程式 — 修正使用預設庫存設定來管理庫存時，造成索引錯誤和效能問題的問題。

• 新郵件介面的回溯相容性 — 修正Adobe Commerce v2.3.3中引入的Magento\Framework\Mail\EmailMessageInterface PHP介面所造成的回溯不相容問題。在此修補程式的範圍內，新的EmailMessageInterface繼承自舊的MessageInterface，Adobe Commerce核心模組將還原為相依於MessageInterface。

• 目錄分頁無法在Elasticsearch6.x上運作 — 修正搜尋結果分頁的重要問題，此問題會影響使用Elasticsearch6.x做為目錄搜尋引擎的客戶。

Docker更新—

• 新Docker影像 — 由2.3.3和更新版本支援

  • PHP 7.3.版

  • 清漆快取6.2.0

• 已新增支援，以便在Docker環境中套用.magento.app.yaml中指定的自訂勾點設定。 以前，Docker環境僅支援預設掛接配置。

• Docker ENV檔案在Docker建置期間不再產生，且docker:config:convert命令已棄用。 對應的資料現在儲存在docker-compose.yml檔案中。

• 已更新PHP映像 — 已將Node.js新增到PHP Docker映像以支援node、npm和grunt-cli功能。

環境變數更新-

• 已新增​ LOCK_PROVIDER ​部署變數來設定鎖定提供者，以防止啟動重複的cron工作和cron群組。 請參閱部署變數主題中的變數說明。

• 已新增​ CONSUMERS_WAIT_FOR_MAX_MESSAGES ​環境變數，以設定在使用CRON_CONSUMERS_RUNNER環境變數管理cron工作時，消費者如何處理來自訊息佇列的訊息。 請參閱部署變數主題中的變數說明。

• 修正當consumers_runner cron工作在不同節點上啟動相同使用者的多個執行個體時，可能導致資料庫死結錯誤的問題。 現在，如果您已在您的環境中啟用​ CRON_CONSUMERS_RUNNER ​部署變數，consumers_runner工作會使用single-thread選項，在僅一個節點上啟動每個取用者的一個執行個體。

• 已修正影響使用預設商店URL的​ WARM_UP_PAGES ​功能的問題。 現在，如果config:show:default-url命令無法擷取基底URL，則會使用MAGENTO_CLOUD_ROUTES變數中的URL。

已更新module:refresh命令傳回的記錄資訊。 現在，您可以在cloud.log檔案中看到已啟用模組的詳細清單。

改善了Adobe Commerce版本與已安裝服務(例如Elasticsearch、RabbitMQ、Redis和DB)之間相容性問題的版本相容性驗證和警告通知。

已新增對RabitMQ 3.8.版的支援

已更新服務相容性的互動式驗證，以反映新的Adobe Commerce 2.3.3和2.2.10版本支援的版本。 如需建議的版本，請參閱​ 安裝指南 ​中的系統需求。

改善在部署階段的cron工作管理程式嘗試停止已完成的cron工作時，傳回的記錄訊息，以澄清此問題不是錯誤。 已將記錄層級從INFO變更為DEBUG.

修正執行setup:upgrade命令時，未在app:config:import工作期間發生失敗時中斷部署程式的問題。

已將檔案處理常式的預設記錄層級變更為debug，以減少Cloud Console中顯示的記錄詳細資訊量，同時仍提供偵錯的詳細資訊。

修正建置期間導致靜態內容部署錯誤的問題。 在安裝和ece-tools設定傾印後，如果config.php檔案中沒有為管理員使用者指定地區設定，則會發生錯誤。 現在，config.php檔案中有管理員使用者的預設地區設定。

修正在未設定安全URL (https)的環境中，當magento-cloud CLI命令失敗時發生的Undefined index error。 現在，如果安全URL無法使用，ECE-Tools套件會使用基底URL (http)。

Docker更新—

• 您現在可以在Docker環境中使用ece-tools套件執行功能測試。 請參閱應用程式測試.

• 已新增使用.magento.app.yaml檔案設定PHP模組的支援。 在.magento.app.yaml檔案🔗中指定的任何PHP副檔名都可在Docker PHP容器中使用。

• 有新命令可用來改善Docker命令列體驗。 檢視Docker參考](https://developer.adobe.com/commerce/cloud-tools/docker/quick-reference/#cloud-docker-cli).的[bin/magento-docker區段

• 已新增使用Mutagen.io在本機主機和Docker之間的開發期間同步檔案的功能。

• 使用Docker環境時， 修正預設路徑。 現在，當您使用SSH登入Docker容器時，您如預期般位於/app目錄中的專案根目錄。

• 已將Na程式庫從1.0.11版更新至1.0.18版，並更新Na PHP擴充功能。

  note warning
  WARNING
  雲端基礎結構上的Adobe Commerce客戶必須提交Adobe Commerce支援票證，以便在升級至Adobe Commerce 2.3.2之前，在Pro生產和中繼環境上升級libna套件。目前，您無法將入門環境升級至Adobe Commerce 2.3.2。

• 已將analysis-icu和analysis-phoneticElasticsearch外掛程式新增到所有Docker影像。

• 已改善的驗證：使用docker:build命令的選項時，您必須在使用選項時提供值。 此外，在使用docker:build run命令時已新增節點版本的驗證。

環境變數更新—

• 已新增使用DATABASE_CONFIGURATION環境變數的資料庫表格首碼支援。

• 已新增​ FORCE_UPDATE_URLS ​部署變數，以便在部署至Pro和Starter生產及中繼環境時更新基底URL。 檢視部署變數內容中的定義。

• 已新增​ TTFB_TESTED_PAGES ​部署後變數，以設定​ 第一位元組時間 ​頁面測試，以檢查部署至雲端基礎結構之網站上的應用程式效能。 檢視部署後變數.中的變數說明

• 修正多執行緒SCD造成靜態內容部署隨機失敗的問題。 因應措施涉及將​ SCD_THREADS ​變數設定為1。 您現在可以根據需要增加計數。 檢視部署變數和組建變數.中的定義

• 您可以設定​ WARM_UP_PAGES ​環境變數來快取單一頁面、多個網域和多個頁面。 檢視部署後變數內容中的展開定義。

已將pub/static/.htaccess檔案新增至排除清單。 由PHOENIX MEDIA GmbH的Bjorn Kraus提交的修正。

修正當至少一個嚴重等級驗證器傳回錯誤時，所有驗證訊息顯示為Critical的錯誤。

修正當資料庫中不存在基底URL時，造成部署失敗的問題。

已將新的​ env:config:show命令 ​新增到顯示環境服務、路由或變數的ece-tools封裝。 請參閱服務、路由及變數。 Vladimir Kerkhoff提交的功能.

修正當嘗試安裝Adobe Commerce 2.2.6或更舊版本（含ece-tools開發）並在殼層重構後發生嚴重錯誤的問題。

修正導致Adobe Commerce 2.1.x和2.2.x安裝失敗的問題，並警告您使用過時的Carbon版本。

已將Shell輸出的cloud.log記錄層級從info降低為debug。

已將--remove-definers (-d)選項新增至ece-tools db-dump命令，以從傾印檔案移除定義項。

Docker更新—

• 現在，Docker環境支援.magento.app.yaml檔案🔗的crons屬性中定義的cron設定。

• 新Docker容器 — 已新增TLS終止Proxy容器，以方便透過HTTPS終止Varnish SSL。

• 新Docker映像 — 已新增Node.js映像以支援Gulp和其他功能，例如Jasmine JS單元測試。

• Docker建置模式 — 現在您可以選擇在生產模式或開發人員模式中啟動Docker環境。 開發人員模式支援具有完整可寫入檔案系統許可權的主動式開發。

• 修正當快取設定為無法使用時，導致Docker部署失敗並出現Name or service not known錯誤的問題。 現在，您可以從.magento/services.yaml檔案移除服務。 Docker設定產生器會自動更新docker/config.php.dist檔案中的服務。

• 已新增服務相容性的互動式驗證。 現在，如果要求的服務與Adobe Commerce版本或其他服務不相容，互動模式 ​會以訊息提示使用者，並選擇繼續。 檢視Docker可用的服務版本。 使用-n選項略過互動以進行CICD。

• 修正清除現有傾印的Docker構成db-dump命令問題。

• 修正將Redis session、default和page_cache快取儲存體指派給相同資料庫識別碼的問題。

環境變數更新—

• 新的​ ELASTICSUITE_CONFIGURATION ​環境變數會在部署之間保留您的自訂服務設定。 檢視部署變數內容中的定義。

• 已新增​ SCD_MAX_EXECUTION_TIMEOUT ​環境變數，以便您可以增加從.magento.env.yaml檔案完成靜態內容部署的時間。 檢視部署變數、組建變數和全域變數.中的定義

  • 已新增​ MAGENTO_CLOUD_LOCKS_DIR ​環境變數，以設定雲端基礎結構上鎖定提供者的掛接點路徑。 鎖定提供者可防止啟動重複的cron作業和cron群組。 Adobe Commerce 2.2.5版及更新版本支援此變數，且可自動設定。 檢視雲端變數.中的定義

  • 已變更​ SCD_THREADS ​環境變數預設值，以根據偵測到的CPU執行緒計數自動決定最佳值。 檢視部署變數和組建變數.中更新的定義

已修正在2002.0.16版雲端基礎結構上升級為Adobe Commerce時，造成DB隔離機制修補程式錯誤的問題。

已新增修補程式，將​ Google影像圖表 ​取代為​ 影像圖表。 請參閱DevBlog文章M1的Google影像圖表過時和更新。

已新增SEARCH_CONFIGURATION變數的驗證。 未設定'engine'選項且不需要_merge時，部署失敗。

修正發生例外狀況後，會公開敏感資料的問題。 現在已適當遮罩機密資訊。

已改善Magento Open Source封裝的容錯設定。 在Adobe Commerce無法從Redis slave執行個體讀取資料的情況下，會從Redis master執行個體進行讀取。 請參閱REDIS_USE_SLAVE_CONNECTION.

服務更新 — 由下列Adobe Commerce版本支援： 2.2.8和更新版本2.2.x、2.3.1和更新版本2.3.x

• 新增對Elasticsearch 6.x.版的支援

• 新增Redis 5.0版的支援。

新Docker影像 — 已將以下服務新增到Docker組建：

• Elasticsearch6.5

• Redis 5.0

新環境變數 — 之前，SCD壓縮有硬式編碼逾時。 現在您可以使用​ SCD_COMPRESSION_TIMEOUT ​環境變數來設定SCD壓縮逾時。 檢視組建變數和部署變數內容中的定義。

已將--use-rewrites選項新增至安裝命令，以便使用網站伺服器重寫店面中產生的連結，並使用管理員存取權來改善安全性和客戶體驗。

已新增時間戳記至var/log/install_upgrade.log檔案，以便顯示安裝和升級事件的日期。

Docker更新—

• 現在，在Docker環境中生成的預設服務配置與雲端範本中的預設配置相同。

• 您可以使用sendmail服務從Docker環境傳送郵件。

• 新增設定Xdebug以在Cloud Docker環境中偵錯的功能。

• 修正產生docker-compose.yml檔案時Web服務許可權的問題。

升級改善 — 已新增驗證，以確認composer.json檔案中的autoload屬性在升級至Adobe Commerce v2.3之前包含必要的設定變更。請參閱升級版本。

部署靜態內容的壓縮程式現在包含所有資產（原生產生或自訂），而且會在build:transfer區段開頭的建置階段期間發生。 先前，壓縮程式會在套用自訂縮制和靜態資產套件組合前進行。 Rafael Garcia Lepper從Tryzens Limited提交的修正。

修正了在設定其他資料庫和服務關聯性後，立即在部署期間發生的資料庫連線錯誤。 此外，此修正會解決在入門版Commerce報告的設定程式中發生的問題。 首先，此升級為使用Commerce報告的「必備」。

修正資料庫組態導致部署程式失敗的驗證問題。

已使用適當版本的symfony/yaml封裝更新條件約束，以搭配PHP常數使用。 使用3.2之前的symfony/yaml封裝版本時，常數剖析無法運作。由Vladimir Kerkhoff提交的修正。

環境組態檢查 — 已新增驗證，以檢查PHP版本並在使用者未使用最新建議版本時警告使用者。

修正處理格式錯誤的JSON變數的問題。 現在，如果JSON變數造成語法錯誤，cloud.log檔案中會顯示警告，並使用預設變數繼續部署。

修正停用Redis服務後立即在部署期間發生的連線錯誤。

正在記錄變更 — 已將下列建置和部署程式事件的記錄層級從Info更新為Notice：

• 將composer.json中已安裝的模組與app/etc/config.php檔案中的共用組態設定進行協調的處理程式的開始和結束

• 設定驗證程式的開始和結束

• 產生類別的setup:di:compile處理序的開始和結束

新環境變數—

• RESOURCE_CONFIGURATION部署變數 — 使用此變數將資源名稱對應到資料庫連線。

• X_FRAME_CONFIGURATION全域變數 — 使用此變數變更X-Frame-Options標題設定，以便在<frame>、<iframe>或<object>中呈現Adobe Commerce頁面。

環境變數更新 — 已變更下列環境變數：

• WARM_UP_PAGES — 新增在為Adobe Commerce存放區定義的所有網域上預先載入指定頁面快取的功能。 先前，如果您的網站設定有多個網域，後部署程式無法預先載入非預設網域上指定頁面的快取，並在後部署記錄檔中傳回下列錯誤： ERROR: Warming up failed: <uri>

• SCD_COMPRESSION_LEVEL — 已使用SCD壓縮層級的正確預設值更新檔案和範例.magento.env.yaml檔案。 檢視組建變數和部署變數內容中的定義。

• SCD_EXCLUDE_THEMES — 此環境變數已棄用。 使用SCD_MATRIX控制主題組態。

• SCD_MATRIX — 修正驗證程式，以防止在SCD_MATRIX忽略包含不同字元大小寫的主題值時發生問題。 檢視組建變數和部署變數內容中的定義。

• 管理員變數—

  • 改善使用環境變數管理管理員使用者認證時的安全性。 在升級期間，您無法再使用ADMIN_EMAIL、ADMIN_USERNAME和ADMIN_PASSWORD環境變數來覆寫管理員認證。 如果您無法存取「管理員」面板，請使用​ 忘記密碼 ​功能或admin:user:create CLI命令來建立新的管理員使用者。 檢視存取您的管理面板。

  • 升級或套用修補程式時不再需要ADMIN_EMAIL。

Docker更新—

• 現在，當建置您的Docker環境時，Docker產生器會使用.magento.app.yaml和.magento/services.yaml組態檔中指定的服務。 您可以使用組建引數選擇不同的服務版本。

• 新增PHP 7.2影像 — 在Cloud Docker中新增對PHP 7.2的支援；更新Launch Docker組態以包含docker:build --php選項，以指定與您的Adobe Commerce版本相容的PHP版本。

• 已根據PHP-CLI影像新增Cron容器。

• 已將以下服務新增到Docker構建：

  • RabbitMQ 3.5和3.7

  • Elasticsearch1.7、2.4和5.2

  • Redis 3.2和4.0

使用PHP常數進行設定 — 已在.magento.env.yaml組態檔中新增對PHP常數的支援。

新環境變數 — 依預設，只有生產環境已啟用Google Analytics。 您可以使用ENABLE_GOOGLE_ANALYTICS環境變數.在測試和整合環境中啟用Google Analytics

修正重新部署後，從env.php檔案移除自訂cron設定的問題。 現在，自訂cron設定安全地保留在env.php檔案中。

修正建置、部署和部署後階段的訊息和記錄層級中的不一致。 針對所有階段和子階段，將開始和結束記錄訊息層級從​ 資訊 ​增加至​ 通知。 視情況新增開始和結束記錄訊息。

修正設定後，cron程式無法啟動部署後階段的問題。 現在，如果您已啟用部署後掛接，就會在部署後階段開始時再次啟用cron程式。

解決指定自訂資料庫組態時，無法成功安裝Adobe Commerce的問題。 Magento以前，安裝程式會使用DATABASE_CLOUD_RELATIONSHIP變數中的資料庫組態，即使您在DATABASE_CONFIGURATION環境變數.中指定了自訂的連線資訊

已更正config:dump命令，使其包含config.php檔案之system區段中的每個網站地區設定。

修正來源基底URL參考在部署後階段中造成​ 熱身 ​錯誤的問題。

修正在setup:di:compile程式期間不正確地產生檔案的問題，這會影響Amazon Pay模組。