설명서Commerce클라우드 인프라의 Commerce 안내서

확장 관리

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

  • 관리자
  • 개발자

Commerce Marketplace에서 확장을 추가하여 Adobe Commerce 응용 프로그램 기능을 확장할 수 있습니다. 예를 들어 테마를 추가하여 Storefront의 모양과 느낌을 변경하거나 언어 패키지를 추가하여 Storefront 및 관리자를 현지화할 수 있습니다.

NOTE
설치 문제를 방지하려면 클라우드 프로젝트를 소유한 동일한 계정(MAGEID)을 사용하여 모든 Marketplace 구매를 완료해야 합니다.

확장의 작성기 이름

이 섹션에서는 Commerce Marketplace에서 확장의 작성기 이름과 버전을 가져오는 방법에 대해 설명하지만, 모듈의 작성기 파일에서 any 모듈의 이름과 버전을 찾을 수 있습니다. 텍스트 편집기에서 composer.json 파일을 열고 "name" 및 "version" 값을 확인합니다.

Commerce Marketplace에서 모듈의 작성기 이름을 가져오려면:

  1. 구성 요소를 구매하는 데 사용한 사용자 이름과 암호를 사용하여 Commerce Marketplace에 로그인합니다.

  2. 오른쪽 상단 모서리에서 사용자 이름을 클릭하고 내 프로필 ​을 선택합니다.

    마켓플레이스 계정에 액세스

  3. 내 계정 페이지에서 내 구매 ​를 클릭합니다.

    마켓플레이스 구매 기록

  4. 내 구매 페이지에서 구입한 모듈을 선택하고 기술 정보 ​를 클릭합니다.

  5. Component name을(를) 클립보드에 복사하려면 복사 ​를 클릭하십시오.

  6. 텍스트 편집기를 열고 구성 요소 이름을 붙여 넣고 콜론 문자(:)를 추가합니다.

  7. 기술 정보 ​에서 복사 ​를 클릭하여 Component version을(를) 클립보드에 복사합니다.

  8. 텍스트 편집기에서 구성 요소 이름 뒤에 버전 번호를 추가합니다. For example:

    code language-text 
    extension-name/magento2:1.0.1

확장 설치

Adobe은 구현에 확장을 추가할 때 개발 분기에서 작업할 것을 권장합니다. 확장을 설치할 때 확장 이름(<VendorName>_<ComponentName>)이 app/etc/config.php 파일에 자동으로 삽입됩니다. 파일을 직접 편집할 필요는 없습니다.

확장을 설치하려면:

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

  2. 개발 분기를 만들거나 체크 아웃합니다. 분기를 참조하세요.

  3. 작성기 이름과 버전을 사용하여 composer.json 파일의 require 섹션에 확장을 추가합니다.

    code language-bash 
    composer require <extension-name>:<version> --no-update

  4. 프로젝트 종속성을 업데이트합니다.

    code language-bash 
    composer update

  5. 코드 변경 사항을 추가, 커밋 및 푸시합니다.

    code language-bash 
    git add -A
    code language-bash 
    git commit -m "Install <extension-name>"
    code language-bash 
    git push origin <branch-name>
    note warning
    WARNING
    확장을 설치할 때 코드 변경 내용을 원격 환경에 푸시할 때 composer.lock 파일을 포함해야 합니다. composer install 명령은 원격 환경에서 정의된 종속성을 사용하도록 설정하기 위해 composer.lock 파일을 읽습니다.

  6. 빌드 및 배포가 완료되면 SSH를 사용하여 원격 환경에 로그인하고 확장이 설치되었는지 확인합니다.

    code language-bash 
    bin/magento module:status <extension-name>

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

    샘플 응답:

    code language-none 
    Module is enabled

    배포 오류가 발생하면 확장 배포 실패를 참조하십시오.

확장 관리

Composer를 사용하여 확장을 추가하면 배포 프로세스에서 확장을 자동으로 활성화합니다. 확장이 이미 설치되어 있는 경우 CLI를 사용하여 확장을 활성화하거나 비활성화할 수 있습니다. 확장을 관리할 때 <VendorName>_<ComponentName> 형식을 사용합니다.

원격 환경에 로그인하는 동안에는 확장을 활성화하거나 비활성화하지 마십시오.

확장을 활성화하거나 비활성화하려면:

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

  2. 모듈을 활성화하거나 비활성화합니다. module 명령은 요청된 모듈 상태로 config.php 파일을 업데이트합니다.

    모듈을 활성화합니다.

    code language-bash 
    bin/magento module:enable <module-name>

    모듈을 비활성화합니다.

    code language-bash 
    bin/magento module:disable <module-name>

  3. 모듈을 사용하도록 설정한 경우 ece-tools을(를) 사용하여 구성을 새로 고치십시오.

    code language-bash 
    ./vendor/bin/ece-tools module:refresh

  4. 모듈 상태를 확인합니다.

    code language-bash 
    bin/magento module:status <module-name>

  5. 코드 변경 사항을 추가, 커밋 및 푸시합니다.

    code language-bash 
    git add -A
    code language-bash 
    git commit -m "Disable <extension-name>"
    code language-bash 
    git push origin <branch-names>

확장 업그레이드

계속하기 전에 확장에 대한 작성기 이름과 버전이 필요합니다. 또한 확장이 프로젝트 및 Adobe Commerce 버전과 호환되는지 확인하십시오. 특히 시작하기 전에 필요한 PHP 버전을 확인하세요.

확장을 업데이트하려면:

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

  2. 개발 분기를 만들거나 체크 아웃합니다. 분기를 참조하세요.

  3. 텍스트 편집기에서 composer.json 파일을 엽니다.

  4. 확장을 찾아 버전을 업데이트합니다.

  5. 변경 사항을 저장하고 텍스트 편집기를 종료합니다.

  6. 프로젝트 종속성을 업데이트합니다.

    code language-bash 
    composer update

  7. 코드 변경 사항을 추가, 커밋 및 푸시합니다.

    code language-bash 
    git add -A
    code language-bash 
    git commit -m "Update <extension-name>"
    code language-bash 
    git push origin <branch-names>

오류가 발생하면 구성 요소 오류에서 복구를 참조하십시오. Adobe Commerce에서 확장을 사용하는 방법에 대한 자세한 내용은 관리 안내서 ​의 확장을 참조하세요.

recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26