기술 세부 정보

이 항목에서는 Commerce 2.2 이상의 파이프라인 배포에 대한 기술 구현 세부 사항에 대해 설명합니다. 개선 사항은 다음 영역으로 나눌 수 있습니다.

이 항목에서는 권장 워크플로우 파이프라인 배포의 경우 및 가 작동하는 방식을 이해하는 데 도움이 되는 몇 가지 예를 제공합니다.

시작하기 전에 개발, 빌드 및 프로덕션 시스템을 위한 사전 요구 사항.

구성 관리

개발 및 프로덕션 시스템의 구성을 동기화하고 유지 관리하려면 다음 재정의 체계를 사용합니다.

구성 변수 값을 결정하는 방법

다이어그램에서 볼 수 있듯이 구성 값은 다음 순서로 사용됩니다.

  1. 환경 변수가 있으면 다른 모든 값을 재정의합니다.
  2. 공유 구성 파일에서 env.phpconfig.php. 의 값 env.php 값 재정의 config.php.
  3. 데이터베이스에 저장된 값.
  4. 해당 소스에 값이 없으면 기본값 또는 NULL이 사용됩니다.

공유 구성 관리

공유 구성은 다음에 저장됩니다. app/etc/config.php: 소스 제어에 있어야 합니다.

개발(또는 클라우드 인프라의 Adobe Commerce)에서 관리자의 공유 구성을 설정합니다. 통합) 시스템 및 구성 쓰기 config.php 사용 magento app:config:dump 명령.

시스템별 구성 관리

시스템별 구성은에 저장됩니다 app/etc/env.php, 이는 아님 소스 제어에 있어야 합니다.

개발(또는 Adobe Commerce on cloud infrastructure integration) 시스템의 관리에서 시스템별 구성을 설정하고 구성을에 작성합니다. env.php 사용 magento app:config:dump 명령.

이 명령은 또한 중요한 설정을에 기록합니다 env.php.

중요한 구성 관리

중요한 구성도 app/etc/env.php.

다음 방법 중 하나로 중요한 구성을 관리할 수 있습니다.

관리자에서 구성 설정이 잠김

의 모든 구성 설정 config.php 또는 env.php 은 관리자에서 잠겨 있습니다. 즉, 관리자에서 이러한 설정을 변경할 수 없습니다.
사용 magento config:set 또는 magento config:set --lock 에서 설정을 변경하는 명령 config.php 또는 env.php 파일.

상거래 관리자

관리자는 프로덕션 모드에 있는 동안 다음 동작을 표시합니다.

  • 관리자에서 캐시 유형을 활성화하거나 비활성화할 수 없습니다

  • 개발자 설정을 사용할 수 없음(스토어 > 설정 > 구성 > 고급 > 개발자), 다음 포함:

    • CSS, JavaScript 및 HTML 축소

    • CSS와 JavaScript 병합

    • 서버측 또는 클라이언트측 LESS 컴파일

    • 인라인 번역

    • 앞에서 설명한 대로 의 모든 구성 설정 config.php 또는 env.php 은(는) 잠겨 있으며 관리자에서 편집할 수 없습니다.

    • 관리 로케일을 배포된 테마에서 사용하는 언어로만 변경할 수 있습니다.

      다음 그림은 의 예를 보여 줍니다. 계정 설정 > 인터페이스 로케일 배포된 로케일 두 개만 표시하는 관리자의 목록:

      관리 로케일을 배포된 로케일로만 변경할 수 있습니다.

  • 관리자를 사용하여 어떤 범위에든 로케일 구성을 변경할 수 없습니다.

    프로덕션 모드로 전환하기 전에 이러한 변경 작업을 수행하는 것이 좋습니다.

    환경 변수 또는 를 사용하여 로케일을 구성할 수 있습니다 config:set 경로가 포함된 CLI 명령 general/locale/code.

cron 설치 및 제거

버전 2.2에서는 다음을 제공하여 cron 작업을 설정하는 데 도움이 됩니다. magento cron:install 명령. 이 명령은 명령을 실행하는 사용자로 crontab을 설정합니다.

또한 magento cron:remove 명령입니다.

권장 파이프라인 배포 워크플로

다음 다이어그램은 파이프라인 배포를 사용하여 구성을 관리하는 방법을 보여 줍니다.

권장 파이프라인 배포 워크플로

개발 시스템

개발 시스템에서는 관리에서 구성을 변경하고 공유 구성을 생성합니다. app/etc/config.php 및 시스템별 구성 app/etc/env.php. 상거래 코드와 공유 구성을 소스 제어에 확인하고 빌드 서버로 푸시합니다.

또한 개발 시스템에 확장을 설치하고 상거래 코드를 사용자 지정해야 합니다.

개발 시스템에서:

  1. 관리자에서 구성을 설정합니다.

  2. 사용 magento app:config:dump 파일 시스템에 구성을 쓰는 명령입니다.

    • app/etc/config.php 는 모든 설정이 포함된 공유 구성입니다 제외 중요 및 시스템별 설정입니다. 이 파일은 소스 제어에 있어야 합니다.
    • app/etc/env.php 는 특정 시스템에 고유한 설정(예: 호스트 이름 및 포트 번호)이 포함된 시스템별 구성입니다. 이 파일은 아님 소스 제어에 있어야 합니다.
  3. 수정된 코드와 공유 구성을 소스 제어에 추가합니다.

  4. 개발 중에 생성된 php 코드 및 정적 에셋 파일을 제거하려면 다음 명령을 실행합니다.

    code language-bash
    rm -r var/view_preprocessed/*
    rm -r pub/static/*/*
    rm -r generated/*/*
    

에셋을 지우는 명령을 실행하면 Commerce에서 작업 파일을 생성합니다.

WARNING
위의 접근 방식에 주의하십시오. 삭제 중 .htacces의 s 파일 generated 또는 pub 폴더로 인해 문제가 발생할 수 있습니다.

시스템 구축

빌드 시스템은 코드를 컴파일하고 Commerce에 등록된 테마에 대한 정적 보기 파일을 생성합니다. Commerce 데이터베이스에 연결할 필요는 없으며 Commerce 코드베이스만 있으면 됩니다.

빌드 시스템에서 다음을 수행합니다.

  1. 소스 제어에서 공유 구성 파일을 가져옵니다.
  2. 사용 magento setup:di:compile 코드를 컴파일하는 명령입니다.
  3. 사용 magento setup:static-content:deploy -f 정적 파일 보기 파일을 업데이트하는 명령입니다.
  4. 소스 제어에 대한 업데이트를 확인합니다.
INFO
다음을 참조하십시오 정적 보기 파일을 위한 배포 전략.

프로덕션 시스템

프로덕션 시스템(즉, 라이브 스토어)에서는 소스 제어에서 생성된 에셋 및 코드 업데이트를 가져오고 명령줄 또는 환경 변수를 사용하여 시스템별로 중요한 구성 설정을 설정합니다.

프로덕션 시스템에서:

  1. 유지 관리 모드를 시작합니다.
  2. 소스 제어에서 코드 및 구성 업데이트를 가져옵니다.
  3. Adobe Commerce을 사용하는 경우 대기열 작업자를 중지합니다.
  4. 사용 magento app:config:import 프로덕션 시스템에서 구성 변경 사항을 가져오는 명령입니다.
  5. 데이터베이스 스키마를 변경한 구성 요소를 설치한 경우 magento setup:upgrade --keep-generated 생성된 정적 파일을 보존하여 데이터베이스 스키마 및 데이터를 업데이트합니다.
  6. 시스템별 설정을 설정하려면 다음 중 하나를 사용합니다. magento config:set 명령 또는 환경 변수입니다.
  7. 중요한 설정을 설정하려면 다음 중 하나를 사용합니다. magento config:sensitive:set 명령 또는 환경 변수입니다.
  8. 정리(또는 플러시) 캐시.
  9. 유지 관리 모드를 종료합니다.

구성 관리 명령

구성을 관리하는 데 도움이 되는 다음 명령을 제공합니다.

  • magento app:config:dump 에 관리자 구성 설정을 쓰려면 config.phpenv.php (중요 설정 제외)

  • magento config:set 를 클릭하여 프로덕션 시스템에서 시스템별 설정의 값을 설정합니다.

    선택 사항 사용 --lock 관리자 의 옵션을 잠그는 옵션(즉, 설정을 편집할 수 없도록 하는 옵션). 설정이 이미 잠겨 있으면 --lock 옵션을 사용하여 설정을 변경할 수 있습니다.

  • magento config:sensitive:set 운영 시스템에서 중요 설정 값을 설정합니다.

  • magento app:config:import 구성 변경 사항을 가져올 위치 config.phpenv.php 운영 시스템으로 이동합니다.

구성 관리 예

이 섹션에서는 변경 내용을 확인할 수 있도록 구성을 관리하는 예를 보여줍니다 config.phpenv.php.

기본 로케일 변경

이 섹션에서는에 대한 변경 사항을 보여 줍니다. config.php 관리자( )를 사용하여 기본 가중치 단위를 변경하는 경우​ 스토어 > 설정 > 구성 > 일반 > 일반 > 로케일 옵션).

관리자에서 를 변경한 후 를 실행합니다. bin/magento app:config:dump 값을 쓸 대상 config.php. 값이 general 아래에 배열 locale 에서 다음 코드 조각으로 config.php 표시:

'general' =>
    array (
        'locale' =>
        array (
            'code' => 'en_US',
            'timezone' => 'America/Chicago',
            'weight_unit' => 'kgs'
        )
    )

여러 구성 설정 변경

이 섹션에서는 다음 구성 변경에 대해 설명합니다.

  • 웹 사이트, 스토어 및 스토어 보기 추가(스토어 > 설정 > 모든 스토어)
  • 기본 이메일 도메인 변경(스토어 > 설정 > 구성 > 고객 > 고객 구성)
  • PayPal API 사용자 이름 및 API 암호 설정(스토어 > 설정 > 구성 > 판매 > 결제 방법 > PayPal > 필수 PayPal 설정)

관리자에서 를 변경한 후 를 실행합니다. bin/magento app:config:dump 개발 시스템에서 사용할 수 있습니다. 이번에는 모든 변경 사항이 (으)로 기록되지 않습니다. config.php실제로 다음 코드 조각에 표시된 대로 웹 사이트, 스토어 및 스토어 보기만 해당 파일에 기록됩니다.

config.php

config.php 포함:

  • 웹 사이트, 스토어 및 스토어 보기 변경 사항.
  • 비시스템 특정 검색 엔진 설정
  • 민감한 PayPal 설정
  • 에서 생략된 중요한 설정을 알려주는 주석입니다. config.php

websites 배열:

      'new' =>
      array (
        'website_id' => '2',
        'code' => 'new',
        'name' => 'New website',
        'sort_order' => '0',
        'default_group_id' => '2',
        'is_default' => '0',
      ),

groups 배열:

      2 =>
      array (
        'group_id' => '2',
        'website_id' => '2',
        'code' => 'newstore',
        'name' => 'New store',
        'root_category_id' => '2',
        'default_store_id' => '2',
      ),

stores 배열:

     'newview' =>
      array (
        'store_id' => '2',
        'code' => 'newview',
        'website_id' => '2',
        'group_id' => '2',
        'name' => 'New store view',
        'sort_order' => '0',
        'is_active' => '1',
      ),

payment 배열:

      'payment' =>
      array (
        'paypal_express' =>
        array (
          'active' => '0',
          'in_context' => '0',
          'title' => 'PayPal Express Checkout',
          'sort_order' => NULL,
          'payment_action' => 'Authorization',
          'visible_on_product' => '1',
          'visible_on_cart' => '1',
          'allowspecific' => '0',
          'verify_peer' => '1',
          'line_items_enabled' => '1',
          'transfer_shipping_options' => '0',
          'solution_type' => 'Mark',
          'require_billing_address' => '0',
          'allow_ba_signup' => 'never',
          'skip_order_review_step' => '1',
        ),

env.php

기본 이메일 도메인 시스템별 구성 설정이에 기록됨 app/etc/env.php.

PayPal 설정은 두 파일에 기록되지 않습니다. bin/magento app:config:dump 명령이 중요한 설정을 쓰지 않습니다. 다음 명령을 사용하여 프로덕션 시스템에서 PayPal 설정을 설정해야 합니다.

bin/magento config:sensitive:set paypal/wpp/api_username <username>
bin/magento config:sensitive:set paypal/wpp/api_password <password>
recommendation-more-help
386822bd-e32c-40a8-81c2-ed90ad1e198c