설명서Commerce구성 안내서

cron 작업 구성

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

작성 대상:

  • 경험
  • 관리자
  • 개발자
WARNING
모든 Magento CLI 명령은 파일 시스템 소유자에서 실행해야 합니다.

여러 Commerce 기능에는 향후 활동이 발생하도록 예약하는 cron 작업이 하나 이상 필요합니다. 이러한 활동의 일부 목록은 다음과 같습니다.

  • 카탈로그 가격 규칙
  • 뉴스레터
  • Google 사이트 맵 생성 중
  • 고객 경고/알림(제품 가격 변경, 제품 재입고)
  • 리인덱싱
  • 개인 판매(Adobe Commerce만 해당)
  • 환율 자동 업데이트
  • 모든 Commerce 이메일(주문 확인 및 트랜잭션 포함)
WARNING
스크립트가 제거되어 dev/tools/cron.sh을(를) 더 이상 실행할 수 없습니다.
INFO
Commerce은 색인화를 포함하여 많은 중요한 시스템 기능에 대한 적절한 cron 작업 구성에 따라 달라집니다. 이를 제대로 설정하지 못하면 Commerce이 예상대로 작동하지 않는다는 의미다.

UNIX 시스템은 cron 데몬에게 "이 날짜에 이 명령을 지금 실행하라"고 지시하는 cron 데몬에 대한 지침이 들어 있는 파일인 crontab ​을 사용하여 특정 사용자가 수행할 작업을 예약합니다. 각 사용자에는 자체 crontab이 있으며, 지정된 crontab의 명령은 해당 쿠키를 소유한 사용자로 실행됩니다.

웹 브라우저에서 cron을 실행하려면 브라우저에서 cron.php 보안을 참조하십시오.

Commerce crontab 만들기 또는 제거

이 섹션에서는 Commerce crontab(즉, Commerce cron 작업에 대한 구성)을 만들거나 제거하는 방법에 대해 설명합니다.

crontab ​은(는) cron 작업을 실행하는 데 사용되는 구성입니다.

Commerce 애플리케이션은 다양한 구성으로 실행할 수 있는 cron 작업을 사용합니다. PHP 명령줄 구성은 인덱서를 다시 인덱싱하고 이메일을 생성하며 사이트 맵을 생성하는 일반적인 cron 작업을 제어합니다.

WARNING
  • 설치 및 업그레이드 중 문제가 발생하지 않도록 PHP 명령줄 구성과 PHP 웹 서버 플러그인 구성에 동일한 PHP 설정을 적용하는 것이 좋습니다. 자세한 내용은 필수 PHP 설정을 참조하세요.
  • 다중 노드 시스템에서 crontab은 한 노드에서만 실행할 수 있습니다. 성능 또는 확장성과 관련된 이유로 둘 이상의 웹 노드를 설정한 경우에만 적용됩니다.

Commerce crontab 만들기

버전 2.2부터 Commerce은 crontab을 만듭니다. Commerce 파일 시스템 소유자에 대해 구성된 crontab에 Commerce crontab을 추가합니다. 즉, 다른 확장 또는 애플리케이션에 대한 crontab을 이미 설정한 경우 해당 설정에 Commerce crontab을 추가합니다.

Commerce crontab은 crontab의 #~ MAGENTO START 및 #~ MAGENTO END 주석 내에 있습니다.

Commerce crontab을 만들려면 다음을 수행하십시오.

  1. 파일 시스템 소유자(으)로 로그인하거나 (으)로 전환합니다.

  2. Commerce 설치 디렉토리로 변경합니다.

  3. 다음 명령을 입력합니다.

    code language-bash 
    bin/magento cron:install [--force]

기존 crontab을 다시 작성하려면 --force을(를) 사용합니다.

INFO
  • magento cron:install이(가) #~ MAGENTO START 내의 기존 crontab과 crontab의 #~ MAGENTO END 주석을 다시 쓰지 않습니다.
  • magento cron:install --force은(는) Commerce 댓글 외부의 cron 작업에 영향을 주지 않습니다.

crontab을 보려면 다음 명령을 파일 시스템 소유자로 입력합니다.

crontab -l

샘플은 다음과 같습니다.

#~ MAGENTO START c5f9e5ed71cceaabc4d4fd9b3e827a2b
* * * * * /usr/bin/php /var/www/html/magento2/bin/magento cron:run 2>&1 | grep -v "Ran jobs by schedule" >> /var/www/html/magento2/var/log/magento.cron.log
#~ MAGENTO END c5f9e5ed71cceaabc4d4fd9b3e827a2b
INFO
update/cron.php 파일이 Commerce 2.4.0에서 제거되었습니다. 이 파일이 설치에 있으면 안전하게 제거할 수 있습니다.
update/cron.php 및 bin/magento setup:cron:run에 대한 모든 참조도 crontab'에서 제거해야 합니다.

Commerce crontab 제거

Commerce 애플리케이션을 제거하기 전에만 Commerce crontab을 제거해야 합니다.

Commerce crontab을 제거하려면:

  1. 파일 시스템 소유자(으)로 로그인하거나 이 소유자로 전환합니다.

  2. Commerce 설치 디렉토리로 변경합니다.

  3. 다음 명령을 입력합니다.

    code language-bash 
    bin/magento cron:remove
INFO
이 명령은 crontab의 #~ MAGENTO START 및 #~ MAGENTO END 주석 외부의 cron 작업에는 영향을 주지 않습니다.

명령줄에서 cron 실행

명령 옵션:

bin/magento cron:run [--group="<cron group name>"]

여기서 --group은(는) 실행할 cron 그룹을 지정합니다(모든 그룹에 대해 cron을 실행하려면 이 옵션을 생략합니다).

인덱싱 cron 작업을 실행하려면 다음을 입력합니다.

bin/magento cron:run --group index

기본 cron 작업을 실행하려면 다음을 입력합니다.

bin/magento cron:run --group default

사용자 지정 cron 작업 및 그룹을 설정하려면 사용자 지정 cron 작업 및 cron 그룹 구성을 참조하십시오.

INFO
실행할 작업을 처음 검색하는 경우 및 작업을 직접 실행하는 경우 cron 을 두 번 실행해야 합니다. 두 번째 cron 실행은 모든 작업에 대해 scheduled_at 시간 또는 그 이후에 수행되어야 합니다.

로깅

모든 cron 작업 정보가 system.log에서 별도의 cron.log(으)로 이동되었습니다.
기본적으로 크론 정보는 <install_directory>/var/log/cron.log에서 찾을 수 있습니다.
크론 작업의 모든 예외가 \Magento\Cron\Observer\ProcessCronQueueObserver::execute에 의해 기록됩니다.

cron.log에 로그인하는 것 외:

  • ERROR 및 MISSED 상태의 실패한 작업이 <install_directory>/var/log/support_report.log에 기록됩니다.

  • ERROR 상태의 작업은 항상 <install_directory>/var/log/exception.log에 CRITICAL(으)로 기록됩니다.

  • 상태가 MISSED인 작업은 <install_directory>/var/log/debug.log 디렉터리에 INFO(개발자 모드만 해당)로 기록됩니다.

INFO
모든 cron 데이터는 Commerce 데이터베이스의 cron_schedule 테이블에도 기록됩니다. 이 표에서는 다음을 포함하여 cron 작업 기록을 제공합니다.
  • 작업 ID 및 코드
  • 상태
  • 만든 날짜
  • 예약된 날짜
  • 실행된 날짜
  • 완료 날짜
테이블에서 레코드를 보려면 명령줄의 Commerce 데이터베이스에 로그인하고 SELECT * from cron_schedule;을(를) 입력하십시오.
recommendation-more-help
386822bd-e32c-40a8-81c2-ed90ad1e198c