Adobe Commerce 배포 문제 해결사

설명 description

환경

클라우드 인프라의 Adobe Commerce

문제/증상

  • 환경에서 배포가 중단되거나 실패함
  • 다른 환경에서의 진행 중인 활동으로 인해 배포가 차단됨
  • 노드에 대한 SSH 액세스 문제
  • 서비스가 실행되지 않음(예: Elasticsearch, cron, Composer-related)
  • 디스크 공간 부족 또는 inode 제한
  • 403/Elasticsearch 버전/구성 오류
  • 원격 클러스터 업로드 실패 또는 재배포 오류
  • 장기 실행 프로세스, 후크 후 실패 또는 타사 확장 충돌
  • 느린 쿼리 및 데이터베이스 측 문제(MySQL)
  • 작성기 구성 문제 또는 패치 제한

해결 방법 resolution

1단계 - 서비스가 실행 중인지 확인

클라우드 인프라 서비스에 대한 Adobe Commerce의 지원 여부

중단 배포 - Adobe Commerce 클라우드 인프라 서비스가 작동합니까? Adobe Commerce Cloud(Experience Cloud 상태 페이지의 Adobe 아래)를 확인하십시오.

  • 예 - 2단계로 진행합니다.
  • 아니요 - 유지 보수 또는 글로벌 가동 중단 예상 기간 및 업데이트를 확인합니다.

2단계 - 다른 환경에서의 배포 확인

기존 환경에서 배포를 차단하는 다른 환경에 배포가 있습니까?

진행 중인 활동 목록을 얻으려면 magento-cloud CLI를 사용하여 다음 명령을 실행합니다(한 클라우드 프로젝트에만 추가된 경우). 참고: 최신 버전의 magento-cloud CLI를 사용하고 있는지 확인하십시오. 단계는 Commerce on Cloud 안내서의 CLI 업데이트를 참조하십시오.

code language-none
magento-cloud --state=in_progress

진행 중인 활동 목록을 얻으려면 magento-cloud를 사용하여 다음 명령을 실행합니다(여러 프로젝트에 추가된 경우).

code language-none
magento-cloud -p <project-id or project-url> --state=in_progress

기존 배포 활동에 대한 정보를 찾으려면(Cloud UI에 "로그 전달" 오류가 있는 경우 배포 로그 확인 참조) 이 명령을 실행하여 해당 활동의 실행 로그를 가져올 수 있습니다.

code language-none
magento-cloud activity:log <activity-id>[ OPTIONAL: <-p project-id or project-url>]
  • 예 - 다른 환경 차단 배포 문제를 해결합니다. 3단계로 진행합니다.
  • 아니요 - 현재 환경 문제를 해결합니다. 3단계로 진행합니다.

3단계 - 모든 노드에서 SSH 확인

모든 노드에 SSH가 성공했습니까?

4단계 - 실행 중인 모든 서비스 확인

모든 서비스가 실행 중입니까?

5단계 - Bitbucket 실행 확인

Bitbucket을 사용하시겠습니까?

6단계 - 오류 코드 확인

오류 코드가 보고되었습니까?
  • 예 - 7단계로 진행합니다.
  • 아니요 - 8단계로 진행합니다.

7단계 - 403 금지됨 오류

403 금지?
  • 예 - 16단계로 진행합니다.
  • 아니요 - 9단계로 진행합니다.

8단계 - 실행 중인 cron 작업 확인

현재 cron 작업이 실행 중입니까?
code language-none
ps aufxx | grep cron
  • 예 - 크론 작업을 종료한 후 잠금 해제합니다.

    code language-none
    php vendor/bin/ece-tools cron:kill
    

    php vendor/bin/ece-tools cron:unlock

  • 아니요 - 17단계로 진행합니다.

9단계 - 원격 클러스터에 응용 프로그램 배포 가능 오류

원격 클러스터에 응용 프로그램을 업로드할 수 없습니까?
  • 예 - 10단계로 진행합니다.
  • 아니요 - 11단계로 진행합니다.

10단계 - 충분한 스토리지 확인

사용할 수 있는 창고죠?

11단계 - 디스크 공간 확인

파일을 쓸 수 없습니다. 경고?
  • 예 -

    • 통합/기초 환경의 경우: .magento.app.yaml에서 디스크 값을 늘린 후 다시 배포하십시오. 이 기능이 작동하지 않으면 지원 티켓을 제출하십시오. 또는 큰 로그 파일
      을(를) 삭제하십시오.
    code language-none
    ls -la var/log
    
  • 아니요 - 12단계로 진행합니다.

12단계 - 환경 재배포 실패 오류

환경 재배포 실패 오류
  • 예 - 13단계를 진행합니다.
  • 아니요 - 8단계로 진행합니다.

13단계 - Elasticsearch 업그레이드 실패 확인

Elasticsearch을 업그레이드하거나 배포하시겠습니까?
  • 예 - Elasticsearch에서 업그레이드 단계가 실패했습니다. Elasticsearch 소프트웨어 호환성을 참조하세요. Elasticsearch 업그레이드가 여전히 작동하지 않으면 지원 티켓을 제출하십시오. 참고: 클라우드 인프라의 Adobe Commerce에서는 인프라 팀에 48시간(영업시간) 통지를 하지 않으면 서비스 업그레이드를 프로덕션 환경으로 푸시할 수 없습니다. 이는 인프라 지원 엔지니어가 운영 환경에 대한 가동 중지 시간을 최소화하면서 원하는 기간 내에 구성을 업데이트할 수 있도록 해야 하기 때문에 필요합니다. 따라서 변경 사항이 프로덕션에 적용되기 48시간 전에 필요한 서비스 업그레이드에 대해 자세히 설명하고 업그레이드 프로세스를 시작할 시간을 기재한 지원 티켓을 제출하십시오.
  • 아니요 - 14단계로 진행합니다.

14단계 - 공간 제한 확인

파일 시스템이 inodes나 space에서 벗어났습니까?

15단계 - Elasticsearch 버전 오류

Elasticsearch 버전에 대한 오류
  • 예 - 16단계로 진행합니다.
  • 아니요 - 21단계로 진행합니다.

16단계 - 작성기 구성 확인

작성기 구성이 올바릅니까?

17단계 - 장기 실행 프로세스 확인

장기 실행 프로세스
  • 예 - 프로세스 종료:

    1. 실행: ps aufx
    2. PID 찾기
    3. 종료: kill -9 <PID>
  • 아니요 - 18단계로 진행합니다.

18단계 - 후크 후 실패 확인

후크 후 실패/중단?
  • 예 - 데이터베이스: 사용 가능한 디스크 공간, 손상, 불완전/손상된 테이블.
  • 아니요 - 19단계로 진행합니다.

19단계 - 서드파티 확장이 배포를 차단하는지 확인

타사 확장을 사용하시겠습니까?

20단계 - 느린 쿼리 확인

오래 실행되는 쿼리

느린 쿼리 로그 및 MySQL 표시 processlist을(를) 확인하십시오.

21단계 - Elasticsearch 버전 다운그레이드

Elasticsearch 버전을 다운그레이드하시겠습니까?
recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f