安裝 Channel Manager

檢閱 需求 並收集必要的資訊,然後再安裝Channel Manager。

安裝擴充功能

Channel Manager的安裝指示取決於Adobe Commerce或Magento Open Source是部署在內部部署還是部署在雲端基礎結構上。

這兩種方法都需要您使用命令列介面(CLI)。

NOTE
如需安裝的協助 Commerce 使用CLI的軟體,請參閱 安裝擴充功能.

安裝在內部部署執行個體上

使用這些指示來安裝 Channel Manager Adobe Commerce和Magento Open Source至內部部署執行個體上。

  1. 登入 Commerce server as a 具有許可權的使用者 以寫入 Commerce 檔案系統。

  2. 將您的網站放入 維護模式.

    code language-bash
    $ bin/magento maintenance:enable
    
  3. 從 Commerce 專案根目錄,新增通道管理員至 composer.json.

    code language-bash
     composer require magento/channel-manager --no-update
    
  4. 如果出現提示,請輸入 Commerce 帳戶。

    您的公開金鑰是您的使用者名稱;您的私密金鑰是您的密碼。

  5. 更新相依性並安裝擴充功能。

    code language-bash
    composer update magento/channel-manager
    

    composer update 命令只會更新所需的相依性 Channel Manager. 若要更新所有相依性,請改用此命令: composer update.

  6. 等待Composer完成更新專案相依性並解決任何錯誤。

  7. 驗證模組安裝:

    • 檢查模組狀態。

      code language-bash
      bin/magento module:status Magento_SalesChannels
      

      範例回應:

      code language-terminal
      Module is enabled
      
    • 如果未啟用此模組,請啟用它。

    code language-bash
    bin/magento module:enable Magento_SalesChannels
    
  8. 註冊擴充功能。

    code language-bash
    bin/magento setup:upgrade
    
  9. 如果出現提示,請重新編譯 Commerce 專案。

    code language-bash
    bin/magento setup:di:compile
    
  10. 清除快取。

    code language-bash
    bin/magento cache:clean
    
  11. 停用維護模式。

    code language-bash
    bin/magento maintenance:disable
    

在雲端基礎結構執行個體上的Adobe Commerce上安裝

將擴充功能新增至雲端例項時,請在開發分支中工作。

如需使用分支的說明,請參閱 開始建立分支雲端基礎結構上的Commerce指南.

在安裝期間,擴充功能名稱(magento\channel-manager)會自動插入 app/etc/config.php 檔案。 您不需要直接編輯檔案。

  1. 在本機工作站上,變更至雲端專案根目錄。

  2. 建立或簽出開發 分支.

  3. 使用撰寫器名稱,將擴充功能新增至 require 的區段 composer.json 檔案。

    code language-bash
    composer require magento/module-sales-channels-extension --no-update
    
  4. 更新相依性並安裝擴充功能。

    code language-bash
    composer update magento/module-sales-channels-extension
    

    composer update 命令只會更新所需的相依性 Channel Manager. 若要更新所有相依性,請改用此命令: composer update.

  5. 新增、提交和推送程式碼變更 — 包含對兩者的變更 composer.lockcomposer.json 檔案。

    code language-bash
    $ git add -A
    
    code language-bash
    $ git commit -m "Install channel manager extension"
    
    code language-bash
    $ git push origin <branch-name>
    
  6. 建置和部署程式完成後,請使用SSH登入遠端環境,並確認擴充功能是否已正確安裝。

   bin/magento module:status Magento_SalesChannels

範例回應:

Module is enabled

如果模組已停用, 在您的本機環境中啟用它 並部署您的變更。

  1. 成功安裝擴充功能後,請登入 Admin 至 設定Commerce服務聯結器.

    note note
    NOTE
    如需將Channel Manager更新至新版本的指示,請參閱 升級模組和擴充功能.

疑難排解

使用下列資訊來解決Channel Manager安裝過程中發生的錯誤。

不正確的撰寫器索引鍵

如果 存取金鑰 用於向Composer存放庫驗證無效,或未連結到 MAGE ID 用於註冊 Channel Manager 服務,下列錯誤會顯示。

Could not find a matching version of package magento/channel-manager. Check the package spelling, your version constraint and that the package is available in a stability which matches your minimum-stability (stable).

檢查金鑰組態:

  1. 尋找的位置 auth.json 檔案:

    code language-bash
    $ composer config –global home
    
  2. 檢視 auth.json 檔案。

    code language-bash
    $ cat /path/to/auth.json
    
  3. 驗證auth.json中的認證是否相符 與影像ID相關聯的金鑰 用於註冊Channel Manager服務。

PHP的記憶體不足

如果系統沒有為PHP分配足夠的記憶體,則會顯示以下錯誤。

Fatal error: Allowed memory size of 2146435072 bytes exhausted (tried to allocate 4096 bytes) in phar:///usr/local/bin/composer/src/Composer/DependencyResolver/RuleWatchGraph.php on line 52

請使用下列其中一種方法來解決記憶體問題:

  • 增加PHP的記憶體限制 在環境中 php.ini 檔案。 此外,確認商務例項具有 建議值 用於其他PHP設定。

  • 從命令列指定記憶體限制。

    code language-bash
    $ php -d memory_limit=-1 \[path to composer]/composer require magento/payment-services.
    

    例如:

    code language-bash
    $ php-d memory_limit=-1 vendor/bin/composer require magento/channel-manager
    

缺少檢視

如果您收到有關遺失的錯誤 process_catalog_exporter_view 在安裝通道管理員期間,請嘗試 重新整理索引子.

php bin/magento indexer:refresh

雲端部署錯誤

如需將擴充功能部署至雲端的問題,請參閱 擴充功能部署失敗.

recommendation-more-help
83c0fcbf-cb46-4844-88e1-421bcdd63f9d