설치 Adobe Commerce B2B 확장

Adobe Commerce B2B 확장, magento/extension-b2b 는 지원되는 모든 Adobe Commerce 버전에서 사용할 수 있습니다. Adobe Commerce 설치 후 설치됩니다.

요구 사항

  • Adobe Commerce, 지원되는 모든 버전
  • PHP 8.1 / 8.2 / 8.3
  • Composer

지원되는 플랫폼

  • ECE(클라우드 인프라)의 Adobe Commerce
  • Adobe Commerce 온-프레미스 (EE)

설치 단계

recommendation-more-help

전제 조건

  • 액세스 대상: repo.magento.com 확장을 다운로드하려면 다음을 수행하십시오. 키 생성 및 필요한 권한 획득에 대한 자세한 내용은 인증 키 받기.

    에서 전역적으로 정의하여 설치에 대한 인증 키를 저장합니다. COMPOSER_홈 디렉토리. 또는 다음 위치에 저장하십시오. auth.json Adobe Commerce 애플리케이션 루트 디렉토리에 있는 파일입니다.

  • 지원되는 B2B 확장 버전-배포된 Adobe Commerce 버전에서 지원되는 B2B 확장의 최신 버전을 확인합니다.

  • 릴리스 정보에서 버전 호환성, 업데이트 또는 설치 또는 업그레이드 요구 사항에 영향을 줄 수 있는 변경 사항에 대한 최신 정보를 확인하십시오.

B2B 확장(magento/b2b-extension) 작성기를 사용합니다. 확장은 Adobe Commerce 인스턴스에 대한 B2B 기능을 활성화하는 모듈 컬렉션을 포함하는 작성기 메타패키지입니다. 포함된 모듈 목록은 다음을 참조하십시오. B2B 패키지.

클라우드 인프라
note tip
TIP
클라우드 인프라에 Adobe Commerce Adobe B2B를 설치하는 경우 시작하기 전에 통합 또는 스테이징 환경에 Adobe Commerce 애플리케이션을 배포하는 것이 좋습니다.

Adobe은 프로젝트에 B2B 확장을 추가할 때 개발 분기에서 작업하는 것을 권장합니다. 분기가 없는 경우 개발을 위한 분기 만들기. B2B 확장을 설치할 때 Magento_B2b 확장 이름이 app/etc/config.php 파일. 파일을 직접 편집할 필요는 없습니다.

B2B 확장을 설치하려면:

  1. 로컬 워크스테이션에서 프로젝트 디렉터리로 변경합니다.

  2. 개발 분기를 만들거나 체크 아웃합니다.

  3. 에 B2B 확장 추가 require 의 섹션 composer.json 파일.

    code language-bash
    composer require magento/extension-b2b --no-update
    
  4. 프로젝트 종속성을 업데이트합니다.

    code language-bash
    composer update
    
  5. 코드 변경 사항을 추가, 커밋 및 푸시합니다.

    code language-bash
    git add -A
    
    code language-bash
    git commit -m "Install the B2B extension."
    
    code language-bash
    git push origin <branch-name>
    
    note note
    NOTE
    업데이트를 클라우드 환경으로 푸시하면 Commerce 클라우드 배포 프로세스가 시작되어 변경 사항이 적용됩니다. 에서 배포 상태를 확인합니다. 로그 배포. 배포 오류가 발생하는 경우 다음을 참조하십시오 구성 요소 장애 복구.
  6. 빌드 및 배포가 완료되면 SSH를 사용하여 원격 환경에 로그인하고 B2B 확장이 설치 및 활성화되었는지 확인합니다.

    code language-bash
    bin/magento module:status Magento_B2b
    

    확장 이름은 다음 형식을 사용합니다. <VendorName>_<ComponentName>.

    샘플 응답:

    code language-terminal
    Magento_B2b : Module is enabled
    
온-프레미스
  1. Adobe Commerce 애플리케이션 루트 디렉토리에서 composer.json B2B 확장에 대한 종속성을 추가하려면 다음을 수행합니다.

    code language-bash
    composer require magento/extension-b2b:<version>
    

    오류가 발생하는 경우, 예를 들면 다음과 같습니다.

    code language-terminal
    [InvalidArgumentException] Could not find a matching version of package magento/extension-b2b.
    

    패키지 철자, 버전 제약 조건 및 패키지를 사용할 수 있고 최소 안정성(안정적인) 요구 사항과 일치하는지 확인합니다.

  2. 메시지가 표시되면 인증 키.

    사용자 공개 키 은 사용자 이름입니다. 는 개인 키 는 암호입니다. 공개 및 개인 키를 auth.json인증하라는 메시지가 표시되지 않습니다.

  3. Composer에서 모듈 업데이트를 완료한 후 다음 명령을 실행합니다.

    code language-bash
    bin/magento setup:upgrade
    
    code language-bash
    bin/magento setup:di:compile
    
    code language-bash
    bin/magento setup:static-content:deploy -f
    
    code language-bash
    bin/magento cache:clean
    
    note note
    NOTE
    프로덕션 모드에서는 다음 대상에게 메시지를 수신할 수 있습니다. Please rerun Magento compile command. 설치 완료 명령을 입력합니다. Adobe Commerce은 개발자 모드에서 compile 명령을 실행하라는 메시지를 표시하지 않습니다.

설치를 완료한 후 메시지 소비자를 구성하고 시작합니다.

메시지 소비자

Adobe Commerce B2B 확장은 메시지 대기열 관리에 MySQL을 사용합니다. 다음 표에는 B2B 기능을 지원하는 메시지 소비자가 나와 있습니다. 확장을 설치한 후 Commerce 스토어에 필요한 B2B 기능에 대한 메시지 소비자를 시작합니다.

소비자
설명
sharedCatalogUpdatePrice
공유 카탈로그의 각 제품에 대한 가격을 업데이트합니다. 필요한 경우: Shared Catalogs 옵션은 관리 시스템 구성 설정에서 활성화됩니다.
sharedCatalogUpdateCategoryPermissions
공유 카탈로그 범주에 할당된 범주를 업데이트합니다. 필요한 경우: Shared Catalogs 옵션은 관리 시스템 구성 설정에서 활성화됩니다.
negotiableQuotePriceUpdate
협상 가능한 견적의 가격을 업데이트합니다. 필요한 경우: Quotes 옵션은 관리 시스템 구성 설정에서 활성화됩니다.
purchaseorder.toorder
구매 발주를 주문으로 변환합니다. 필요한 경우: Purchase Orders 옵션은 관리 시스템 구성 설정에서 활성화됩니다.
purchaseorder.transactional.email
구매 주문 이메일을 보냅니다. 필요한 경우: Purchase Orders 옵션은 관리 시스템 구성 설정에서 활성화됩니다.
purchaseorder.validation
관련성이 있는 구매 발주를 검증합니다. 승인 규칙. 필요한 경우: Purchase Orders 옵션은 관리 시스템 구성 설정에서 활성화됩니다.
quoteItemCleaner
제품이 카탈로그에서 삭제되거나 장바구니에서 제거될 때 유효하지 않거나 비활성 가격 견적을 삭제합니다. 필요한 경우: Quotes 옵션은 관리 시스템 구성 설정에서 활성화됩니다.
inventoryQtyCounter
주문이 배치되거나 제품이 제거된 후 비동기적으로 주가 지수를 수정합니다. 필요한 경우: Use deferred stock update 옵션은 관리자 구성 설정에서 Inventory management에 대해 활성화되어 있습니다. 다음을 참조하십시오 성능 모범 사례.
async.operations.all
의 각 개별 작업에 대한 메시지 만들기 대량 작업 품목 임포트 또는 익스포트, 일괄 규모에 따라 가격 변경, 창고에 제품 지정 등의 작업을 수행합니다. 필요한 경우: 관리 일괄 작업 옵션 Inventory Management 이(가) (으)로 설정됨 비동기적으로 실행 관리자 시스템 구성 설정에서 을 참조하십시오.
NOTE
모든 Adobe Commerce 메시지 소비자 목록은 을 참조하십시오. 메시지 대기열 소비자 다음에서 구성 안내서.

메시지 소비자 구성

다음을 수행할 때 다음 매개 변수를 추가하여 가능한 처리 문제 또는 지연을 방지하십시오. 메시지 소비자 시작 B2B 기능용

  • --max-messages <value>— 종료하기 전에 각 소비자가 처리해야 하는 최대 메시지 수를 지정합니다(기본값 = 10000). Adobe이 권장하지는 않지만 0을 사용하여 소비자가 종료하지 않도록 할 수 있습니다. PHP 응용 프로그램의 가장 좋은 방법은 가능한 메모리 누수를 방지하기 위해 오래 실행되는 프로세스를 다시 시작하는 것입니다.

  • --batch-size <value>— 고객이 사용하는 시스템 리소스(CPU, 메모리)를 제한할 수 있습니다. 더 작은 배치를 사용하면 리소스 사용량이 감소하므로 처리 속도가 느려집니다. 지정하면 대기열의 메시지가 다음의 배치로 사용됩니다. <value> 각. 이 옵션은 일괄 처리 소비자에만 적용할 수 있습니다. If --batch-size 가 정의되지 않은 경우 일괄 처리 소비자가 대기열에서 사용 가능한 모든 메시지를 수신합니다.

추가 구성 옵션에 대한 자세한 내용은 특정 구성.

메시지 소비자 시작

B2B 기능에 대한 비동기 작업을 활성화하려면 여러 메시지 소비자를 시작해야 합니다.

  1. 사용 가능한 메시지 소비자를 나열합니다.

    code language-bash
    bin/magento queue:consumers:list
    

    이 명령은 다음을 포함한 사용 가능한 메시지 소비자를 반환합니다. B2B 메시지 소비자.

  2. 각 소비자를 개별적으로 시작:

    code language-bash
    bin/magento queue:consumers:start [--max-messages=<value>] [--batch-size=<value>] <consumer_name>
    

    For example:

    code language-bash
    bin/magento queue:consumers:start quoteItemCleaner
    
TIP
백그라운드에서 실행하려면 다음을 추가합니다 & 명령을 실행한 다음 프롬프트로 돌아가서 명령을 계속 실행합니다. 예: bin/magento queue:consumers:start sharedCatalogUpdatePrice &.

자세한 내용은 메시지 대기열 관리 다음에서 구성 안내서.

cron에 메시지 소비자 추가

다음에 대한 실행 일정을 자동화할 수 있습니다. SharedCatalogUpdateCategoryPermissionsSharedCatalogUpdatePrice cron 구성 파일에 일정을 추가하여 메시지 소비자 /app/code/Magento/MessageQueue/etc/crontab.xml.

* * * * * ps ax | grep [s]haredCatalogUpdateCategoryPermissions >>/dev/null 2>&1 || nohup php /var/www/html/magento2/bin/magento queue:consumers:start sharedCatalogUpdateCategoryPermissions &
* * * * * ps ax | grep [s]haredCatalogUpdatePrice >>/dev/null 2>&1 || nohup php /var/www/html/magento2/bin/magento queue:consumers:start sharedCatalogUpdatePrice &

에서 메시지 소비자에 대한 일정을 구성할 수도 있습니다. 구성 설정 저장 관리에서.

관리자에서 B2B 기능 활성화

Adobe Commerce B2B 확장을 설치하고 메시지 소비자를 시작한 후 다음을 수행해야 합니다 관리자에서 B2B 기능 활성화.

88ad8589-1cb8-47eb-a79c-0e4726a4ac2a