설명서Commerce설치 안내서

시스템 요구 사항

Last update: Wed Jul 17 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 주제:

작성 대상:

  • 경험
  • 관리자
  • 개발자

다음은 Adobe Commerce에서 테스트한 소프트웨어 종속성 및 서비스를 요약한 것입니다.

클라우드 인프라의 Commerce 종속성에 몇 가지 차이점이 있습니다. Adobe Commerce on cloud infrastructure에 대한 서비스 버전 및 호환성 지원은 호스팅된 클라우드 환경에 테스트되고 배포된 서비스에 의해 결정되며, 경우에 따라 Adobe Commerce 온프레미스 배포에서 지원하는 버전과 다릅니다. 예를 들어 온프레미스 배포의 경우 Commerce 2.4.4에 대해 Elasticsearch 7.17이 지원되지만 클라우드 인프라의 경우 Commerce 2.4.4에 대해 OpenSearch 1.2가 지원됩니다.

다음 표는 Adobe이 특정 Adobe Commerce 릴리스에서 테스트한 타사 소프트웨어 종속성을 보여줍니다.

Adobe은 다음 표에 설명된 시스템 요구 사항의 조합만 지원합니다. 예를 들어 2.4.5는 MariaDB 10.4로 완전히 테스트됩니다. Adobe은 2.4.5로 업그레이드하기 전에 MariaDB 10.4로 업그레이드하는 것을 권장합니다.

클라우드의 Commerce

Commerce on Cloud 템플릿은(는) 특정 Commerce 버전과 호환되는 서비스에 대한 기본 구성을 제공합니다.

table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 7-row-4 layout-auto
소프트웨어 종속성 2.4.7-p2 2.4.7-p1 2.4.7
Composer 2.7 2.7 2.7
Elasticsearch — — —
OpenSearch 2.12 2.12 2.12
MariaDB 10.6 10.6 10.6
PHP 8.3, 8.2 8.3, 8.2 8.3, 8.2
RabbitMQ 3.13 3.12 3.12
Redis 7.2 7.2 7.2
table 0-row-9 1-row-9 2-row-9 3-row-9 4-row-9 5-row-9 6-row-9 7-row-9 layout-auto
소프트웨어 종속성 2.4.6-p7 2.4.6-p6 2.4.6-p5 2.4.6-p4 2.4.6-p3 2.4.6-p2 2.4.6-p1 2.4.6
Composer 2.2 2.2 2.2 2.2 2.2 2.2 2.2 2.2
Elasticsearch — — — — — — — —
OpenSearch 2.12 2.12 2.12 2.5 2.5 2.5 2.5 2.5
MariaDB 10.6 10.6 10.6 10.6 10.6 10.6 10.6 10.6
PHP 8.2, 8.1 8.2, 8.1 8.2, 8.1 8.2, 8.1 8.2, 8.1 8.2, 8.1 8.2, 8.1 8.2, 8.1
RabbitMQ 3.13 3.12 3.12, 3.11, 3.9 3.11, 3.9 3.11, 3.9 3.11, 3.9 3.11, 3.9 3.11, 3.9
Redis 7.0 7.0 7.0 7.0 7.0 7.0 7.0 7.0
table 0-row-11 1-row-11 2-row-11 3-row-11 4-row-11 5-row-11 6-row-11 7-row-11 layout-auto
소프트웨어 종속성 2.4.5-p9 2.4.5-p8 2.4.5-p7 2.4.5-p6 2.4.5-p5 2.4.5-p4 2.4.5-p3 2.4.5-p2 2.4.5-p1 2.4.5
Composer 2.2 2.2 2.2 2.2 2.2 2.2 2.2 2.2 2.2 2.2
Elasticsearch — — — — — — — — — —
OpenSearch 1.3 1.3 1.3 1.2 1.2 1.2 1.2 1.2 1.2 1.2
MariaDB 10.5 10.5, 10.4 10.4 10.4 10.4 10.4 10.4 10.4 10.4 10.4
PHP 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1
RabbitMQ 3.13 3.12, 3.11 3.12, 3.11, 3.9 3.11, 3.9 3.11, 3.9 3.11, 3.9 3.11, 3.9 3.9 3.9 3.9
Redis 7.0 7.0 7.0 6.2 6.2 6.2 6.2 6.2 6.2 6.2
table 0-row-12 1-row-12 2-row-12 3-row-12 4-row-12 5-row-12 6-row-12 7-row-12 layout-auto
소프트웨어 종속성 2.4.4-p10 2.4.4-p9 2.4.4-p8 2.4.4-p7 2.4.4-p6 2.4.4-p5 2.4.4-p4 2.4.4-p3 2.4.4-p2 2.4.4-p1 2.4.4
Composer 2.2 2.2 2.2 2.2 2.2 2.2 2.2 2.2 2.1 2.1 2.1
Elasticsearch — — — — — — — — — — —
OpenSearch 1.3 1.3 1.3 1.2 1.2 1.2 1.2 1.2 1.2 1.2 1.2
MariaDB 10.5 10.5, 10.4 10.4 10.4 10.4 10.4 10.4 10.4 10.4 10.4 10.4
PHP 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1
RabbitMQ 3.9 3.9 3.9 3.9 3.9 3.9 3.9 3.9 3.9 3.9 3.9
Redis 7.0 7.0 7.0 6.2 6.2 6.2 6.2 6.2 6.2 6.2 6.2
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 layout-auto
소프트웨어 종속성 2.4.3-p3
Composer 1
Elasticsearch —
OpenSearch 1.2
MariaDB 10.4
PHP 7.4
RabbitMQ 3.8
Redis 6.0
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 layout-auto
소프트웨어 종속성 2.4.2-p2
Composer 1
Elasticsearch 7.9
OpenSearch —
MariaDB 10.4
PHP 7.4
RabbitMQ 3.8
Redis 6.0

서비스 및 버전이 services.yaml 파일에 정의되어 있습니다. 다음은 클라우드 인프라의 Commerce 2.4.6에 대한 기본 서비스 구성입니다.

code language-yaml 
mysql:
    type: mysql:10.6
    disk: 5120

redis:
    type: redis:7.0

opensearch:
    type: opensearch:2
    disk: 1024

클라우드 인프라의 Commerce 안내서에서 서비스 구성을 참조하십시오.

Commerce 온-프레미스
note note
NOTE
버전 2.4.4 및 2.4.5는 MySQL 8.0.0에서 8.0.28까지만 지원합니다.
table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 7-row-4 8-row-4 9-row-4 10-row-4 11-row-4 12-row-4 13-row-4 14-row-4 15-row-4 16-row-4 17-row-4 layout-auto
소프트웨어 종속성 2.4.7-p2 2.4.7-p1 2.4.7
Composer 2.7 2.7 2.7
Elasticsearch 8.11 8.11 8.11
OpenSearch 2.12 2.12 2.12
MariaDB 10.6 10.6 10.6
MySQL 8.0 8.0 8.0
PHP 8.3, 8.2 8.3, 8.2 8.3, 8.2
RabbitMQ 3.13 3.13 3.13
Redis 7.2 7.2 7.2
Varnish 7.5 7.5 7.5
Apache 2.4 2.4 2.4
nginx 1.24 1.24 1.24
AWS Aurora (MySQL) 8.0 8.0 8.0
AWS S3 ✔️ ✔️ ✔️
AWS MQ 3.11.20 3.11.20 3.11.20
AWS ElastiCache Redis 7.0 Redis 7.0 Redis 7.0
AWS Elasticsearch — — —
AWS OpenSearch 2.11 2.11 2.11
table 0-row-9 1-row-9 2-row-9 3-row-9 4-row-9 5-row-9 6-row-9 7-row-9 8-row-9 9-row-9 10-row-9 11-row-9 12-row-9 13-row-9 14-row-9 15-row-9 16-row-9 17-row-9 layout-auto
소프트웨어 종속성 2.4.6-p7 2.4.6-p6 2.4.6-p5 2.4.6-p4 2.4.6-p3 2.4.6-p2 2.4.6-p1 2.4.6
Composer 2.2 2.2 2.2 2.2 2.2 2.2 2.2 2.2
Elasticsearch 8.11, 7.17 8.11, 7.17 8.11, 7.17 8.11, 7.17 8.5, 7.17 8.5, 7.17 8.5, 7.17 8.4, 7.17
OpenSearch 2.12 2.12 2.12 2.5 2.5 2.5 2.5 2.5
MariaDB 10.6 10.6 10.6 10.6 10.6 10.6 10.6 10.6
MySQL 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0
PHP 8.2, 8.1 8.2, 8.1 8.2, 8.1 8.2, 8.1 8.2, 8.1 8.2, 8.1 8.2, 8.1 8.2, 8.1
RabbitMQ 3.13 3.12 3.12, 3.11, 3.9 3.11, 3.9 3.11, 3.9 3.11, 3.9 3.11, 3.9 3.11, 3.9
Redis 7.0 7.0 7.0 7.0 7.0 7.0 7.0 7.0
Varnish 7.5 7.5 7.5 7.3 7.3 7.3 7.3 7.1
Apache 2.4 2.4 2.4 2.4 2.4 2.4 2.4 2.4
nginx 1.24 1.24 1.24 1.24 1.24 1.22 1.22 1.22
AWS Aurora (MySQL) 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0
AWS S3 ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️
AWS MQ 3.9.16 3.9.16 3.9.16 3.9.16 3.9.16 3.9.16 3.9.16 3.9.16
AWS ElastiCache Redis 6.2 Redis 6.2 Redis 6.2 Redis 6.2 Redis 6.2 Redis 6.2 Redis 6.2 Redis 6.2
AWS Elasticsearch — — — — — — — —
AWS OpenSearch 1.2 1.2 1.2 1.2 1.2 1.2 1.2 1.2
table 0-row-11 1-row-11 2-row-11 3-row-11 4-row-11 5-row-11 6-row-11 7-row-11 8-row-11 9-row-11 10-row-11 11-row-11 12-row-11 13-row-11 14-row-11 15-row-11 16-row-11 17-row-11 layout-auto
소프트웨어 종속성 2.4.5-p9 2.4.5-p8 2.4.5-p7 2.4.5-p6 2.4.5-p5 2.4.5-p4 2.4.5-p3 2.4.5-p2 2.4.5-p1 2.4.5
Composer 2.2 2.2 2.2 2.2 2.2 2.2 2.2 2.2 2.2 2.2
Elasticsearch 7.17 7.17 7.17 7.17 7.17 7.17 7.17 7.17 7.17 7.17
OpenSearch 1.3 1.3 1.3 1.2 1.2 1.2 1.2 1.2 1.2 1.2
MariaDB 10.5, 10.4 10.5, 10.4 10.4 10.4 10.4 10.4 10.4 10.4 10.4 10.4
MySQL 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0
PHP 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1
RabbitMQ 3.13 3.12, 3.11 3.12, 3.11, 3.9 3.11, 3.9 3.11, 3.9 3.11, 3.9 3.11, 3.9 3.9 3.9 3.9
Redis 7.0 7.0 7.0 6.2 6.2 6.2 6.2 6.2 6.2 6.2
Varnish 7.5 7.5 7.5 7.3 7.3 7.3 7.3 7.1 7.0 7.0
Apache 2.4 2.4 2.4 2.4 2.4 2.4 2.4 2.4 2.4 2.4
nginx 1.24 1.24 1.24 1.24 1.24 1.22 1.22 1.22 1.22 1.22
AWS Aurora (MySQL) 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0
AWS S3 ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️
AWS MQ 3.9.13 3.9.13 3.9.13 3.9.13 3.9.13 3.9.13 3.9.13 3.9.13 3.9.13 3.9.13
AWS ElastiCache 레디스 레디스 레디스 레디스 레디스 레디스 레디스 레디스 레디스 레디스
AWS Elasticsearch — — — — — — — — 7.9 7.9
AWS OpenSearch 1.2 1.2 1.2 1.2 1.2 1.2 1.2 1.2 1.2 1.2
table 0-row-12 1-row-12 2-row-12 3-row-12 4-row-12 5-row-12 6-row-12 7-row-12 8-row-12 9-row-12 10-row-12 11-row-12 12-row-12 13-row-12 14-row-12 15-row-12 16-row-12 17-row-12 layout-auto
소프트웨어 종속성 2.4.4-p10 2.4.4-p9 2.4.4-p8 2.4.4-p7 2.4.4-p6 2.4.4-p5 2.4.4-p4 2.4.4-p3 2.4.4-p2 2.4.4-p1 2.4.4
Composer 2.2 2.2 2.2 2.2 2.2 2.2 2.2 2.2 2.1 2.1 2.1
Elasticsearch 7.17 7.17 7.17 7.17 7.17 7.17 7.17 7.17 7.16 7.16 7.16
OpenSearch 1.3 1.3 1.3 1.2 1.2 1.2 1.2 1.2 1.2 1.2 1.2
MariaDB 10.5, 10.4 10.5, 10.4 10.4 10.4 10.4 10.4 10.4 10.4 10.4 10.4 10.4
MySQL 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0
PHP 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1
RabbitMQ 3.9 3.9 3.9 3.9 3.9 3.9 3.9 3.9 3.9 3.9 3.9
Redis 7.0 7.0 7.0 6.2 6.2 6.2 6.2 6.2 6.2 6.2 6.2
Varnish 7.5 7.5 7.5 7.3 7.3 7.3 7.3 7.1 7.0 7.0 7.0
Apache 2.4 2.4 2.4 2.4 2.4 2.4 2.4 2.4 2.4 2.4 2.4
nginx 1.24 1.24 1.24 1.24 1.24 1.22 1.22 1.22 1.22 1.22 1.22
AWS Aurora (MySQL) 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 5.7 5.7 5.7
AWS S3 ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️
AWS MQ 3.9.13 3.9.13 3.9.13 3.9.13 3.9.13 3.9.13 3.9.13 3.9.13 3.8.11 3.8.11 3.8.11
AWS ElastiCache 레디스 레디스 레디스 레디스 레디스 레디스 레디스 레디스 레디스 레디스 레디스
AWS Elasticsearch — — — — — — — — 7.9 7.9 7.9
AWS OpenSearch 1.2 1.2 1.2 1.2 1.2 1.2 1.2 1.2 — — —
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 12-row-2 13-row-2 14-row-2 15-row-2 16-row-2 17-row-2 layout-auto
소프트웨어 종속성 2.4.3-p3
Composer 1
Elasticsearch 7.16
OpenSearch 1.2
MariaDB 10.4
MySQL 8.0
PHP 7.4
RabbitMQ 3.8
Redis 6.0
Varnish 6.5
Apache 2.4
nginx 1.18
AWS Aurora (MySQL) 5.7
AWS S3 ✔️
AWS MQ 3.8.11
AWS ElastiCache 레디스
AWS Elasticsearch 7.9
AWS OpenSearch —
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 12-row-2 13-row-2 14-row-2 15-row-2 16-row-2 17-row-2 layout-auto
소프트웨어 종속성 2.4.2-p2
Composer 1
Elasticsearch 7.9
OpenSearch —
MariaDB 10.4
MySQL 8.0
PHP 7.4
RabbitMQ 3.8
Redis 6.0
Varnish 6.4
Apache 2.4
nginx 1.18
AWS Aurora (MySQL) —
AWS S3 ✔️
AWS MQ —
AWS ElastiCache —
AWS Elasticsearch —
AWS OpenSearch —

PHP 설정

memory_limit 설정과 같은 특정 PHP 구성 설정이 있으므로 Adobe Commerce 사용 시 일반적인 문제를 방지하는 데 도움이 됩니다. 필수 PHP 설정을 참조하세요.

클라우드 구성 지침은 클라우드 인프라의 Commerce 안내서에서 PHP 설정을 참조하십시오.

PHP OPcache

성능상의 이유로 PHP OPcache이 활성화되어 있는지 확인하는 것이 좋습니다. OPcache는 많은 PHP 배포에서 사용할 수 있습니다. opcache 확장은 기본적으로 클라우드 인프라의 Commerce에 설치됩니다.

온-프레미스에 대해서는 PHP OPcache가 설치되어 있는지 확인합니다. PHP 설정을 참조하십시오. 성능 설정에 대한 자세한 지침은 성능 모범 사례 안내서에서 PHP 설정에 대한 소프트웨어 권장 사항을 참조하십시오.

OPcache를 별도로 설치해야 하는 경우 PHP OPcache 설명서를 참조하세요.

PHP 프로세스 제어

병렬 모드에서 인덱서를 실행하려면 먼저 PHP에서 프로세스 제어 지원(pcntl)을 사용하도록 설정해야 합니다. PHP 설명서에서 설치를 참조하십시오.

PHPUnit

PHPUnit v9(명령줄 도구).

확장 프로그램

PHP 설치 지침에 이러한 확장을 설치하는 단계가 포함되어 있습니다.

TIP
클라우드 인프라의 PHP 확장에 대해서는 클라우드 인프라의 Commerce 안내서에서 PHP 확장 사용을 참조하십시오.
클라우드의 Commerce

다음 표에서는 Adobe Commerce을 클라우드 플랫폼에 배포할 때 지원되는 PHP 확장을 보여 줍니다.

table 0-row-3 1-row-3 layout-auto
기본 확장 제거할 수 없는 설치된 확장 필요에 따라 설치 및 제거할 수 있는 확장
bcmath
bz2
캘린더
exif
gd
gettext
intl
libxml
mysqli
opcache
pcntl
pdo_mysql
리플렉션
soap
소켓
SPL
standard
swool
sysvmsg
sysvsem
sysvshm
zip
zlib		 ctype
curl
날짜
dba
dom
fileinfo
필터
ftp
해시
iconv
json
mbstring
mysqlnd
openssl
pcre
pdo
pdo_sqlite
phar
posix
readline
세션
sqlite3
토큰화기
xml
xmlreader
xmlwriter		 geoip
gmp
igbinary
이미지
imap
ldap
mailparse
mcrypt
msgpack
mysqli
oauth
pdo_mysql
propro
pspell
raphf
기록
redis
shmop 소켓
나트륨
ssh2
깔끔함
xdebug
xmlrpc
xsl
yaml
Commerce 온-프레미스

Adobe Commerce에는 다음이 필요합니다.

  • ext-bcmath
  • ext-ctype
  • ext-curl
  • ext-dom
  • ext-fileinfo
  • ext-filter
  • ext-gd
  • ext-hash
  • ext-iconv
  • ext-intl
  • ext-json
  • ext-libxml
  • ext-mbstring
  • ext-openssl
  • ext-pcre
  • ext-pdo_mysql
  • ext-simplexml
  • ext-soap
  • ext-sockets
  • ext-sodium
  • ext-spl
  • ext-tokenizer
  • ext-xmlwriter
  • ext-xsl
  • ext-zip
  • ext-zlib
  • lib-libxml

Magento Open Source에 필요한 사항:

  • ext-bcmath
  • ext-ctype
  • ext-curl
  • ext-dom
  • ext-fileinfo
  • ext-filter
  • ext-gd
  • ext-hash
  • ext-iconv
  • ext-intl
  • ext-json
  • ext-libxml
  • ext-mbstring
  • ext-openssl
  • ext-pcre
  • ext-pdo_mysql
  • ext-simplexml
  • ext-soap
  • ext-sockets
  • ext-sodium
  • ext-tokenizer
  • ext-xmlwriter
  • ext-xsl
  • ext-zip
  • ext-zlib
  • lib-libxml

설치 정보는 공식 PHP 설명서를 참조하십시오.

기타

이 섹션에서는 기타 모든 필수 및 선택적 소프트웨어 유형에 대한 지원 및 호환성에 대해 설명합니다.

NOTE
다음 요구 사항은 Adobe Commerce의 최신 2.4.x 패치 릴리스에 적용됩니다. 관련성이 있는 경우 클라우드 인프라에 대한 Commerce 지침이 제공됩니다.

브라우저

Storefront 및 관리자:

  • Microsoft Edge (최신 및 이전 주요 버전)
  • Firefox(최신 및 이전 주요 버전, 모든 운영 체제)
  • Chrome(최신 및 이전 주요 버전, 모든 운영 체제)
  • Safari(최신 및 이전 주요 버전, macOS 전용)
  • iOS용 Safari (storefront용 최신 및 이전 주요 버전)
  • Android용 Chrome (storefront용 최신 및 이전 주요 버전)

메일 서버

MTA(메일 전송 에이전트) 또는 SMTP 서버. 클라우드 인프라의 Commerce은 SendGrid 이메일 서비스를 사용합니다.

메모리

Commerce Marketplace 및 기타 소스에서 얻은 응용 프로그램 및 확장을 업그레이드하려면 최대 2GB의 RAM이 필요할 수 있습니다. RAM이 2GB 미만인 시스템을 사용하는 경우 스왑 파일을 만드십시오. 그렇지 않으면 업그레이드가 실패할 수 있습니다.

운영 체제 (Linux x86-64)

RedHat Enterprise Linux(RHEL), CentOS, Ubuntu, Debian 등과 같은 Linux 배포판 Microsoft Windows 및 macOS은 지원되지 않습니다.

Adobe Commerce의 일부 작업에는 다음 시스템 도구가 필요합니다.

SSL

  • HTTPS에는 유효한 보안 인증서가 필요합니다.
  • 자체 서명된 SSL 인증서는 지원되지 않습니다.
  • TLS(전송 계층 보안) 요구 사항 - PayPal과 repo.magento.com 둘 다 TLS 1.2 이상이 필요합니다.

클라우드 인프라의 Commerce에 대해서는 클라우드 인프라의 Commerce 안내서에서 Fastly 구성을 참조하십시오.

Xdebug

Adobe Commerce의 경우 php_xdebug 2.5.x 이상을 사용합니다(개발 환경에만 해당, 성능에 부정적인 영향을 줄 수 있음).

클라우드의 Adobe Commerce에 대해서는 클라우드 인프라의 Commerce 안내서에서 Xdebug 구성을 참조하십시오.

NOTE
xdebug에는 Adobe Commerce 설치 또는 설치 후 상점 또는 관리자에 액세스하는 데 영향을 줄 수 있는 알려진 문제가 있습니다. Commerce 지원 기술 자료 ​에서 설치 xdebug에 영향을 주는 알려진 문제를 참조하십시오.
recommendation-more-help
0f8e7db5-0e9c-4002-a5b8-a0088077d995