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

Crons 속성

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

작성 대상:

  • 관리자
  • 개발자

Adobe Commerce은 crons 속성을 사용하여 반복 활동을 예약합니다. 특정 작업이 하루 중 특정 시간에 실행되도록 예약하는 데 이상적입니다. 읽기 전용 환경의 특성으로 인해 클라우드 인프라 프로젝트의 Adobe Commerce에 대한 웹 인스턴스에서는 한 번에 하나의 cron 작업만 실행할 수 있습니다. 장기 실행 작업을 대기열에 추가된 더 작은 작업으로 분류하는 것이 좋습니다. 또는 작업자 인스턴스를 빌드할 수 있습니다.

Adobe은 crons을(를) 파일 시스템 소유자(으)로 실행할 것을 권장합니다. root 또는 웹 서버 사용자로 crons을(를) 실행 안 함 ​하세요.

이 구성은 여러 기본 cron 작업이 있는 Adobe Commerce의 온-프레미스 배포와 다릅니다. 구성 가이드 ​에서 cron 작업 구성을 참조하십시오.

cron 작업 설정

crons 속성은 일정에 따라 트리거되는 프로세스를 설명합니다. 각 작업에는 이름과 다음 옵션이 필요합니다.

  • spec—예약에 사용되는 cron 식입니다.
  • cmd—start 및 stop에서 실행할 명령입니다.
  • shutdown_timeout—(선택 사항) cron 작업이 취소된 경우 작업 또는 프로세스를 중지하기 위해 SIGKILL 신호가 전송된 시간(초)입니다. 기본값은 10초입니다.
  • timeout—(선택 사항) cron 작업을 시간 제한 전에 실행할 수 있는 최대 시간입니다. 기본값은 86400초(24시간)의 최대 허용 값으로 설정되어 있습니다.

기본적으로 모든 Commerce 클라우드 프로젝트에는 .magento.app.yaml 파일에 다음과 같은 기본 crons 구성이 있습니다.

crons:
    cronrun:
        spec: "* * * * *"
        cmd: "php bin/magento cron:run"

프로젝트에 사용자 지정 cron 작업이 필요한 경우 기본 crons 구성에 추가할 수 있습니다. cron 작업 빌드를 참조하십시오.

crontab

Adobe Commerce은 스테이징 및 프로덕션 환경에서 셀프서비스 crons 구성을 지원하기 위해 Pro 프로젝트에만 자동 크론 구성 옵션을 추가했습니다. 이 옵션이 활성화되면 crontab을(를) 사용하여 크론 구성을 검토할 수 있습니다. 시작 프로젝트에서 사용할 수 있는 없음 ​입니다.

crontab을(를) 사용하여 Pro 프로젝트에 대한 구성을 검토할 수 있지만, Adobe Commerce에서는 crontab을(를) 사용하여 클라우드 인프라에 배포된 사이트에 대해 cron 작업을 실행하지 않습니다.

Pro 환경에서 cron 구성을 검토하려면:

  1. SSH을(를) 사용하여 원격 환경에 로그인합니다.

  2. 예약된 cron 프로세스를 나열합니다.

    code language-shell 
    crontab -l
    note note
    NOTE
    crontab -l 명령이 Command not found 오류를 반환하는 경우(Pro 스테이징 및 프로덕션 환경에만 해당) 프로젝트에서 자동 Crons 셀프 서비스 구성 옵션을 활성화하려면 Adobe Commerce 지원 티켓을 제출해야 합니다.

다음 예제에서는 기본 crons 구성만 있는 환경에 대한 crontab 출력을 보여 줍니다.

username@hostname:~$ crontab -l
# Crontab is managed by the system, attempts to edit it directly will fail.
SHELL=/etc/platform/6fck2obu3244c/cron-run
MAILTO=""

# m h  dom mon dow  job_name

* * * * *           cronrun

cron 작업 작성

cron 작업에는 일정 및 시간 지정과 예약된 시간에 실행할 명령이 포함됩니다. Starter 환경 및 Pro integration 환경의 경우 최소 간격은 5분당 한 번입니다. Pro 스테이징 및 프로덕션 환경의 경우 최소 간격은 분당 1회입니다. 클라우드 인프라의 Adobe Commerce에서 사용자 지정 cron 작업을 crons 섹션의 .magento.app.yaml 파일에 추가합니다. 일반 형식은 예약에 spec이고 실행할 명령 또는 사용자 지정 스크립트를 지정하는 데 cmd입니다.

사양

Adobe Commerce은 crons 사양(spec)에 대해 5값 식을 사용합니다. * * * * *

  1. 분 (0~59) 모든 Starter 및 Pro 환경에서 cron 작업에 지원되는 최소 빈도는 5분입니다. 관리자에서 설정을 구성해야 할 수도 있습니다.
  2. 시간(0~23)
  3. 날짜 (1~31)
  4. 개월(1~12)
  5. 요일 (0~6) (일부 시스템의 경우 일요일~토요일; 7)

몇 가지 예:

  • 00 */3 * * *은(는) 처음 1분에 3시간마다 실행됩니다(오전 12시, 오전 3시, 오전 6시).
  • 20 */8 * * *은(는) 8시간마다 20분(오전 12시 20분, 오전 8시 20분, 오후 4시 20분)에 실행됩니다
  • 00 00 * * *은(는) 매일 자정에 한 번 실행됩니다.
  • 00 * * * 1은(는) 주 1회 월요일 자정에 실행됩니다.
NOTE
.magento.app.yaml 파일에 지정된 crons 시간은 데이터베이스의 저장소 구성 값에 지정된 시간대가 아니라 서버 시간대를 기반으로 합니다.

일정을 결정할 때 작업을 완료하는 데 걸리는 시간을 고려합니다. 예를 들어 3시간마다 작업을 실행하고 작업을 완료하는 데 40분이 걸리는 경우 예약된 시간을 변경하는 것이 좋습니다.

명령

cmd은(는) 실행할 명령 또는 사용자 지정 스크립트를 지정합니다. 명령 스크립트 형식에는 다음이 포함될 수 있습니다.

<path-to-php-binary> <project-dir>/<script-command>

For example:

crons:
    spec: "00 */8 * * *"
    cmd: "/usr/bin/php /app/abc123edf890/bin/magento export:start catalog_category_product"

이 예제에서 <path-to-php-binary>은(는) /usr/bin/php입니다. 프로젝트 ID가 포함된 설치 디렉터리는 /app/abc123edf890/bin/magento이고 스크립트 작업은 export:start catalog_category_product입니다.

프로젝트에 사용자 정의 크론 작업 추가

클라우드 인프라 플랫폼의 Adobe Commerce에서 .magento.app.yaml 파일의 crons 섹션에 사용자 지정을 추가할 수 있습니다.

NOTE
Starter 환경 및 Pro integration 환경의 경우 최소 간격은 5분당 한 번입니다. Pro 스테이징 및 프로덕션 환경의 경우 최소 간격은 분당 1회입니다. 기본 최소 간격보다 더 빈번한 간격을 구성할 수는 없습니다.

.magento.app.yaml 파일을 사용하여 스테이징 및 프로덕션 환경에 사용자 지정 크론 작업을 추가하려면 먼저 Adobe Commerce Pro 프로젝트에서 자동 크론 기능을(를) 사용하도록 설정해야 합니다. 이 기능이 활성화되어 있지 않으면 Adobe Commerce 지원 티켓을 제출하여 자동 크론을 활성화하십시오.

사용자 지정 크론 작업을 추가하려면:

  1. 로컬 개발 환경에서 Adobe Commerce /app 디렉터리에서 .magento.app.yaml 파일을 편집합니다.

  2. crons 섹션에서 다음 형식을 사용하여 사용자 지정을 추가합니다.

    code language-yaml 
    crons:
    <cron_name_1>:
        spec: "<schedule_time>"
        cmd: "<schedule_command>"
    <cron_name_2>:
        spec: "<schedule_time>"
        cmd: "<schedule_command>"

    다음 예에서 productcatalog 작업은 매 8시간마다 시간 후 20분마다 제품 카탈로그를 내보냅니다.

    code language-yaml 
    crons:
    magento:
        spec: '* * * * *'
        cmd: 'php bin/magento cron:run'
    productcatalog:
        spec: '20 */8 * * *'
        cmd: 'bin/magento export:start catalog_product_category'

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

    code language-bash 
    git add .magento.app.yaml && git commit -m "cron config updates" && git push origin <branch-name>

cron 작업 업데이트

사용자 지정된 작업을 추가, 제거 또는 업데이트하려면 .magento.app.yaml 파일의 crons 섹션에서 구성을 변경하십시오. 그런 다음 변경 사항을 스테이징 및 프로덕션 환경에 푸시하기 전에 원격 integration 환경에서 업데이트를 테스트하십시오.

cron 작업 비활성화

성능 문제를 방지하기 위해 리인덱싱 또는 캐시 정리와 같은 유지 관리 작업을 완료하기 전에 cron 작업을 수동으로 비활성화할 수 있습니다. ece-tools CLI 명령 cron:disable을(를) 사용하여 모든 cron 작업을 비활성화하고 활성 cron 프로세스를 중지할 수 있습니다.

cron 작업을 사용하지 않도록 설정하려면:

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

  2. SSH를 사용하여 원격 환경에 로그인합니다.

    code language-bash 
    magento-cloud ssh

  3. cron 작업을 비활성화하고 활성 cron 프로세스를 중지합니다.

    code language-shell 
    ./vendor/bin/ece-tools cron:disable

  4. 필요한 유지 관리 작업을 완료한 후 cron 작업을 다시 활성화해야 합니다.

    code language-shell 
    ./vendor/bin/ece-tools cron:enable

크론 작업 문제 해결

Adobe이 Adobe Commerce on cloud infrastructure platform의 cron 처리를 최적화하고 cron 관련 문제를 수정하도록 Adobe Commerce on cloud infrastructure 패키지를 업데이트했습니다. cron 처리 문제가 발생하면 프로젝트에서 ece-tools 패키지의 최신 버전을 사용하고 있는지 확인하십시오. ECE 도구 업데이트를 참조하십시오.

각 환경의 애플리케이션 수준 로그 파일에서 cron 처리 정보를 검토할 수 있습니다. 응용 프로그램 로그를 참조하세요.

cron 관련 문제를 해결하는 데 도움이 필요하면 다음 Adobe Commerce 지원 문서를 참조하십시오.

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