고급 온-프레미스 설치
명령줄 인터페이스(CLI)
Adobe Commerce에는 설치 및 구성 작업을 위한 단일 명령줄 인터페이스가 있습니다. <magento_root>/bin/magento
. 인터페이스는 다음을 포함하여 여러 작업을 수행합니다.
- 설치(및 관련 작업(예: 데이터베이스 스키마 생성 또는 업데이트, 배포 구성 만들기)
- 캐시를 지우는 중입니다.
- 색인 재지정을 포함한 색인 관리.
- 번역 사전 및 번역 패키지 만들기
- 플러그인에 대한 공장 및 인터셉터와 같이 존재하지 않는 클래스를 생성하여 객체 관리자에 대한 종속성 삽입 구성을 생성합니다.
- 정적 보기 파일을 배포하는 중입니다.
- Less에서 CSS를 만드는 중입니다.
기타 이점:
- 사용 가능한 모든 설치 및 구성 명령이 하나의 명령(
<magento_root>/bin/magento list
)에 나열됩니다. - Symfony 기반의 일관된 사용자 인터페이스.
- CLI는 타사 개발자가 "플러그인"할 수 있도록 확장 가능합니다. 이는 사용자의 학습곡선을 제거할 수 있다는 추가적인 이점이 있다.
- 비활성화된 모듈에 대한 명령이 표시되지 않습니다.
이 항목에서는 CLI를 사용하여 Adobe Commerce 소프트웨어를 설치하는 방법에 대해 설명합니다. 구성에 대한 자세한 내용은 구성 가이드를 참조하십시오.
필요한 경우 설치 관리자를 여러 번 실행할 수 있으므로 다음과 같은 작업을 수행할 수 있습니다.
-
다른 값 제공
예를 들어 SSL(Secure Sockets Layer)에 대해 웹 서버를 구성한 후 설치 관리자를 실행하여 SSL 옵션을 설정할 수 있습니다.
-
이전 설치에서의 실수 수정
-
다른 데이터베이스 인스턴스에 Adobe Commerce 설치
설치를 시작하기 전에
시작하기 전에 다음 단계를 완료하십시오.
-
시스템이 시스템 요구 사항에서 설명한 요구 사항을 충족하는지 확인하십시오.
-
필수 구성 요소 작업을 모두 완료하십시오.
-
첫 번째 설치 단계를 완료합니다. 설치 또는 업그레이드 경로를 참조하세요.
-
응용 프로그램 서버에 로그인한 후 파일 시스템 소유자로 전환합니다.
-
설치 빠른 시작 개요를 검토하십시오.
bin
하위 디렉터리에서 Adobe Commerce을 설치해야 합니다.설치 관리자를 다양한 옵션으로 여러 번 실행하여 다음과 같은 설치 작업을 완료할 수 있습니다.
-
단계적으로 설치 — 예를 들어 웹 서버에서 SSL(Secure Sockets Layer)을 구성한 후 설치 관리자를 다시 실행하여 SSL 옵션을 설정할 수 있습니다.
-
이전 설치에서 발생한 오류를 수정합니다.
-
다른 데이터베이스 인스턴스에 Adobe Commerce을 설치합니다.
cleanup-database
매개 변수를 사용하여 이 동작을 변경할 수 있습니다.업데이트, 다시 설치, 제거도 참조하세요.
보안 설치
HTTPS라고도 하는 SSL(Secure Sockets Layer)을 관리자 및 상점 모두에 사용하려면 다음 매개 변수를 모두 설정해야 합니다.
--use-secure
:1
(으)로 설정--base-url-secure
: 보안 URL로 설정(즉,https://
(으)로 시작)--use-secure-admin
을(를)1
(으)로 설정
이러한 매개 변수에 대한 자세한 내용은 이 항목의 뒷부분에서 확인할 수 있습니다.
설치 관리자 도움말 명령
다음 명령을 실행하여 일부 필수 인수의 값을 찾을 수 있습니다.
bin/magento info:language:list
bin/magento info:currency:list
bin/magento info:timezone:list
명령줄에서 설치
install 명령은 다음 형식을 사용합니다.
bin/magento setup:install --<option>=<value> ... --<option>=<value>
다음 표에서는 설치 옵션 이름 및 값에 대해 설명합니다. 예를 들어 설치 명령은 샘플 localhost 설치를 참조하십시오.
관리자 자격 증명:
다음 옵션은 관리자에 대한 사용자 정보 및 자격 증명을 지정합니다.
설치 중 또는 후에 관리자 사용자를 만들 수 있습니다. 설치 중에 사용자를 만드는 경우 모든 관리자 자격 증명 변수가 필요합니다. 샘플 localhost 설치를 참조하십시오.
다음 표에서는 사용 가능한 설치 매개 변수의 수는 많지만 모두 제공되지 않습니다. 전체 목록이 필요하면 명령줄 도구 참조를 참조하십시오.
--admin-firstname
--admin-lastname
--admin-email
--admin-user
--admin-password
--admin-password='A0b9%t3g'
사이트 및 데이터베이스 구성 옵션:
--base-url
http[s]://<host or ip>/<your install dir>/
형식 중 하나로 관리자 및 상점 앞에 액세스하는 데 사용할 기본 URL입니다.참고: 구성표(http:// 또는 https://)와 뒤쪽 슬래시가 모두 필요합니다.
<your install dir>
은(는) Adobe Commerce 소프트웨어를 설치할 docroot 상대 경로입니다. 웹 서버와 가상 호스트를 설정하는 방법에 따라 경로가 magento2이거나 비어 있을 수 있습니다.Adobe Commerce 또는 MagenAdobe Commerce에 액세스하려면
http://127.0.0.1/<your install dir>/
또는 http://127.0.0.1/<your install dir>/
을(를) 사용하십시오.-
{{base_url}}
: 가상 호스트 설정 또는 Docker와 같은 가상화 환경에서 정의한 기본 URL을 나타냅니다. 예를 들어 호스트 이름이 magento.example.com
인 가상 호스트를 설정하는 경우 --base-url={{base_url}}
로 소프트웨어를 설치하고 http://magento.example.com/admin
과(와) 같은 URL로 관리자에 액세스할 수 있습니다.--backend-frontname
admin_jkgdfq
.보안을 위해 임의의 URI를 사용하는 것이 좋습니다. 무작위 URI는 해커나 악성 소프트웨어가 악용하기 더 어렵다.
설치가 끝날 때 URI가 표시됩니다. 나중에 언제든지
bin/magento info:adminuri
명령을 사용하여 표시할 수 있습니다.값을 입력하기로 선택한 경우 admin, backend와 같은 일반적인 단어를 사용하지 않는 것이 좋습니다. 관리자 URI에는 영숫자 값과 밑줄 문자(
_
)만 포함될 수 있습니다.--db-host
-
localhost
(기본값) 또는 127.0.0.1
(데이터베이스 서버가 웹 서버와 동일한 호스트에 있는 경우).localhost는 MySQL 클라이언트 라이브러리가 UNIX 소켓을 사용하여 데이터베이스에 연결함을 의미합니다. 127.0.0.1
을(를) 사용하면 클라이언트 라이브러리에서 TCP 프로토콜을 사용합니다. 소켓에 대한 자세한 내용은 PHP PDO_MYSQL 설명서를 참조하십시오.참고: www.example.com:9000과 같은 호스트 이름에 데이터베이스 서버 포트를 선택적으로 지정할 수 있습니다.
--db-name
기본값은
magento2
입니다.--db-user
기본값은
root
입니다.--db-password
--db-prefix
이 경우 접두사를 사용하여 이 설치에 사용할 테이블을 식별하십시오. 일부 고객은 동일한 데이터베이스에 모든 테이블이 있는 Adobe Commerce 또는 MagenAdobe Commerceserver를 두 개 이상 가지고 있습니다.
접두사는 최대 5자까지 사용할 수 있습니다. 문자로 시작해야 하며 문자, 숫자 및 밑줄 문자만 포함할 수 있습니다.
이 옵션을 사용하면 두 개 이상의 Adobe Commerce 설치와 데이터베이스 서버를 공유할 수 있습니다
--db-ssl-key
--db-ssl-cert
--db-ssl-ca
--language
bin/magento info:language:list
을(를) 입력하여 언어 코드 목록을 볼 수 있습니다.)--currency
bin/magento info:currency:list
을(를) 입력하여 통화 목록을 볼 수 있습니다.)--timezone
bin/
디렉터리에서 bin/magento info:timezone:list
을(를) 입력하여 시간대 목록을 볼 수 있습니다.--use-rewrites
1
은(는) storefront 및 Admin에서 생성된 링크에 대해 웹 서버 다시 쓰기를 사용함을 의미합니다.0
은(는) 웹 서버 다시 쓰기를 사용하지 않도록 설정합니다. 이것이 기본값입니다.--use-secure
1
을(를) 사용하면 상점 URL에서 SSL(Secure Sockets Layer)을 사용할 수 있습니다. 이 옵션을 선택하기 전에 웹 서버가 SSL을 지원하는지 확인하십시오.0
은(는) SSL 사용을 비활성화합니다. 이 경우 다른 모든 보안 URL 옵션도 0이라고 가정합니다. 이것이 기본값입니다.--base-url-secure
http[s]://<host or ip>/<your install dir>/
형식입니다.--use-secure-admin
1
은(는) SSL을 사용하여 관리자에 액세스함을 의미합니다. 이 옵션을 선택하기 전에 웹 서버가 SSL을 지원하는지 확인하십시오.0
은(는) 관리자가 SSL을 사용하지 않음을 의미합니다. 이것이 기본값입니다.--admin-use-security-key
0
이(가) 키 사용을 비활성화합니다.--session-save
db
중 하나를 사용하여 데이터베이스에 세션 데이터를 저장합니다. 클러스터된 데이터베이스가 있는 경우 데이터베이스 저장소를 선택하십시오. 그렇지 않으면 파일 기반 저장소에 비해 이점이 별로 없을 수 있습니다.-
files
파일 시스템에 세션 데이터를 저장합니다. 파일 시스템 액세스가 느리거나 클러스터된 데이터베이스가 있거나 세션 데이터를 Redis에 저장하려는 경우가 아니면 파일 기반 세션 저장소가 적절합니다.Redis에 세션 데이터를 저장하는-
redis
. 기본 또는 페이지 캐싱에 Redis를 사용하는 경우 Redis가 이미 설치되어 있어야 합니다. Redis에 대한 지원 구성에 대한 자세한 내용은 세션 저장소에 Redis 사용 을 참조하십시오.--key
--cleanup-database
--db-init-statements
기본값은
SET NAMES utf8;
입니다.--sales-order-increment-prefix
검색 엔진 구성 옵션:
--search-engine
elasticsearch7
입니다. Elasticsearch 5는 더 이상 사용되지 않으므로 권장되지 않습니다.--elasticsearch-host
localhost
입니다.--elasticsearch-port
9200
입니다.--elasticsearch-index-prefix
magento2
입니다.--elasticsearch-timeout
15
입니다.--elasticsearch-enable-auth
false
입니다.--elasticsearch-username
--elasticsearch-password
--opensearch-host
localhost
입니다.--opensearch-port
9200
입니다.--opensearch-index-prefix
magento2
입니다.--opensearch-timeout
15
입니다.--opensearch-enable-auth
false
입니다.--opensearch-username
--opensearch-password
RabbitMQ구성 옵션:
--amqp-host
--amqp
옵션을 사용하지 마십시오. RabbitMQ 설치 및 구성에 대한 자세한 내용은 RabbitMQ 설치 를 참조하십시오.호스트 이름(RabbitMQ이 설치되어 있음).
--amqp-port
--amqp-user
guest
을(를) 사용하지 마십시오.--amqp-password
guest
을(를) 사용하지 마십시오.--amqp-virtualhost
/
입니다.--amqp-ssl
false
입니다. RabbitMQ의 SSL 설정에 대한 자세한 내용은 RabbitMQ을(를) 참조하십시오.--consumers-wait-for-messages
구성 옵션 잠금:
--lock-provider
사용 가능한 잠금 공급자:
db
, zookeeper
, file
.기본 잠금 공급자:
db
--lock-db-prefix
db
잠금 공급자를 사용할 때 잠금 충돌을 방지하기 위한 특정 DB 접두사입니다.기본값:
NULL
--lock-zookeeper-host
zookeeper
잠금 공급자를 사용하는 경우 Zookeeper 클러스터에 연결할 호스트 및 포트입니다.예:
127.0.0.1:2181
--lock-provider=zookeeper
을(를) 설정하는 경우--lock-zookeeper-path
기본 경로는
/magento/locks
입니다.--lock-file-path
--lock-provider=file
을(를) 설정하는 경우소비자 구성 옵션:
--consumers-wait-for-messages
-
0
: 소비자가 큐에서 사용 가능한 메시지를 처리하고 TCP 연결을 닫고 종료합니다. 소비자는 소비자를 시작하는 동안 처리된 메시지 수가 지정된--max_messages
값보다 작더라도 추가 메시지가 대기열에 들어갈 때까지 기다리지 않습니다. -
1
: 소비자는 TCP 연결을 닫고 소비자 프로세스를 종료하기 전에 최대 메시지 수(queue:consumers:start
명령의--max_messages
에 대해 지정된 값)에 도달할 때까지 메시지 큐에서 메시지를 계속 처리합니다.--max_messages
에 도달하기 전에 큐를 비우면 소비자는 더 많은 메시지가 도착할 때까지 기다립니다. cron 작업을 사용하는 대신 작업자를 사용하여 소비자를 실행하는 경우 이 변수를1
(으)로 설정하십시오.
--consumers-wait-for-messages
옵션은 글로벌 옵션이며 각 소비자에 대해 별도로 구성할 수 없습니다.중요 데이터:
Adobe Commerce은 암호화 키를 사용하여 다음을 암호화합니다.
- 신용 카드 정보
- 관리자 구성에 지정된 사용자 이름 및 암호(예: 결제 게이트웨이에 로그인)
- 네트워크를 통해 전송된 CAPTCHA 값
Adobe Commerce 암호화 안 함:
- 관리자 및 고객 사용자 이름과 암호(이러한 암호는 해시됨)
- 주소
- 전화 번호
- 신용 카드 번호를 제외한 기타 유형의 개인 식별 정보
샘플 localhost 설치
다음 예는 다양한 옵션을 사용하여 로컬로 Adobe Commerce을 설치하는 명령을 보여 줍니다.
예제 1 - 관리자 계정을 사용한 기본 설치
다음 예에서는 다음 옵션과 함께 Adobe Commerce을 설치합니다.
-
응용 프로그램이
localhost
의 웹 서버 docroot에 상대적인magento2
디렉터리에 설치되어 있고 관리자의 경로는admin
이므로 다음과 같습니다.상점 URL은
http://127.0.0.1
입니다. -
데이터베이스 서버가 웹 서버와 동일한 호스트에 있습니다.
데이터베이스 이름은
magento
이고 사용자 이름과 암호는 모두magento
입니다. -
서버 재작성 사용
-
관리자는 다음과 같은 속성을 갖습니다.
- 이름과 성은
Magento User
입니다. - 사용자 이름은
admin
이고 암호는admin123
입니다. - 전자 메일 주소는
user@example.com
입니다.
- 이름과 성은
-
기본 언어는
en_US
입니다(미국 영어). -
기본 통화는 미국 달러입니다
-
기본 시간대는 미국 중부(아메리카/시카고)입니다.
-
OpenSearch 1.2가
os-host.example.com
에 설치되어 있으며 포트 9200에 연결됩니다.
magento setup:install --base-url=http://127.0.0.1/magento2/ \
--db-host=localhost --db-name=magento --db-user=magento --db-password=magento \
--admin-firstname=Magento --admin-lastname=User --admin-email=user@example.com \
--admin-user=admin --admin-password=admin123 --language=en_US \
--currency=USD --timezone=America/Chicago --use-rewrites=1 \
--search-engine=opensearch --opensearch-host=os-host.example.com \
--opensearch-port=9200
성공적인 설치를 나타내는 다음 디스플레이와 유사한 메시지:
Post installation file permissions check...
For security, remove write permissions from these directories: '/var/www/html/magento2/app/etc'
[Progress: 274 / 274]
[SUCCESS]: Magento installation complete.
[SUCCESS]: Admin Panel URI: /admin_puu71q
예제 2— 관리자 계정이 없는 기본 설치
다음 예와 같이 관리자 사용자를 작성하지 않고 Adobe Commerce을 설치할 수 있습니다.
magento setup:install --base-url=http://127.0.0.1/magento2/ \
--db-host=localhost --db-name=magento --db-user=magento --db-password=magento \
--language=en_US --currency=USD --timezone=America/Chicago --use-rewrites=1 \
--search-engine=opensearch --opensearch-host=os-host.example.com \
--opensearch-port=9200
설치가 완료되면 다음과 같은 메시지가 표시됩니다.
Post installation file permissions check...
For security, remove write permissions from these directories: '/var/www/html/magento2/app/etc'
[Progress: 274 / 274]
[SUCCESS]: Magento installation complete.
[SUCCESS]: Admin Panel URI: /admin_puu71q
설치 후 admin:user:create
명령을 사용하여 관리자 사용자를 만들 수 있습니다.
관리자 만들기 또는 편집
예제 3 - 추가 옵션과 함께 설치
다음 예에서는 다음 옵션과 함께 Adobe Commerce을 설치합니다.
-
응용 프로그램이
localhost
의 웹 서버 docroot에 상대적인magento2
디렉터리에 설치되어 있고 관리자의 경로는admin
이므로 다음과 같습니다.상점 URL은
http://127.0.0.1
입니다. -
데이터베이스 서버가 웹 서버와 동일한 호스트에 있습니다.
데이터베이스 이름은
magento
이고 사용자 이름과 암호는 모두magento
입니다. -
관리자는 다음과 같은 속성을 갖습니다.
- 이름과 성은
Magento User
입니다. - 사용자 이름은
admin
이고 암호는admin123
입니다. - 전자 메일 주소는
user@example.com
입니다.
- 이름과 성은
-
기본 언어는
en_US
입니다(미국 영어). -
기본 통화는 미국 달러입니다
-
기본 시간대는 미국 중부(아메리카/시카고)입니다.
-
설치 관리자는 먼저 테이블과 스키마를 설치하기 전에 데이터베이스를 정리합니다
-
판매 주문 증분 접두사
ORD$
을(를) 사용할 수 있습니다. 특수 문자 [$
]이(가) 포함되어 있으므로 값을 큰따옴표로 묶어야 합니다. -
세션 데이터가 데이터베이스에 저장됩니다.
-
서버 재작성 사용
-
OpenSearch가
os-host.example.com
에 설치되어 있으며 포트 9200에 연결됩니다.
magento setup:install --base-url=http://127.0.0.1/magento2/ \
--db-host=localhost --db-name=magento --db-user=magento --db-password=magento \
--admin-firstname=Magento --admin-lastname=User --admin-email=user@example.com \
--admin-user=admin --admin-password=admin123 --language=en_US \
--currency=USD --timezone=America/Chicago --cleanup-database \
--sales-order-increment-prefix="ORD$" --session-save=db --use-rewrites=1 \
--search-engine=opensearch --opensearch-host=os-host.example.com \
--opensearch-port=9200
\
문자를 사용하여 입력해야 합니다.설치가 완료되면 다음과 같은 메시지가 표시됩니다.
Post installation file permissions check...
For security, remove write permissions from these directories: '/var/www/html/magento2/app/etc'
[Progress: 274 / 274]
[SUCCESS]: Magento installation complete.
[SUCCESS]: Admin Panel URI: /admin_puu71q