설명서CommerceCommerce KB

Adobe Commerce 배포 문제 해결사

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

  • 개발자

배포 문제 해결사 도구를 사용하여 Adobe Commerce에서 배포가 중단되고 배포가 실패하는 문제를 해결할 수 있습니다. 각 질문을 클릭하여 문제 해결사의 각 단계에서 답변을 표시합니다.

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

클라우드 인프라 서비스에 Adobe Commerce이 있습니까?

중단 배포 - Adobe Commerce 클라우드 인프라 서비스가 작동합니까? Adobe Commerce Cloud을(를) 확인하세요.

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

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

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

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

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

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

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

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

code language-bash 
magento-cloud activity:log <activity-id> [OPTIONAL: <-p project-id or project-url>]

a. 예 - 기존 환경에서 배포를 차단하는 다른 환경 문제를 해결합니다. 3단계로 진행합니다.

b. 아니요 - 현재 환경 문제를 해결합니다. 3단계로 진행합니다.

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

모든 노드에 SSH가 성공했습니까?
a. 예 - 4단계로 진행합니다.
b. 아니요 - 지원 티켓을 제출.

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

모든 서비스가 실행 중입니까?
a. 예 - 5단계로 진행합니다.
b. 아니요 - 지원 티켓을 제출.

5단계 - Bitbucket 실행 확인 step-5

Bitbucket을 사용하고 있습니까?
a. 예 - status.bitbucket.com을(를) 확인하십시오.
b. 아니요 - 로그 작성 및 배포에서 배포 로그 오류를 확인합니다. 6단계로 진행합니다.

6단계 - 오류 코드 확인 step-6

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

7단계 - 403 금지됨 오류 step-7

403 사용할 수 없음?
a. 예 - 16단계로 진행합니다.
b. 아니요 - 9단계로 진행합니다.

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

cron 작업이 현재 실행 중입니까? 분기에서 ssh로 로그인하고 ps aufxx |grep cron을(를) 실행합니다.
a. 예 - 영향을 받는 분기(예: 기본)에서 ssh로 로그인합니다. 크론 작업을 죽이고 잠금을 해제합니다. 이로 인해 크론 작업이 종료되고 상태가 재설정됩니다. php vendor/bin/ece-tools cron:kill을(를) 실행한 다음 php vendor/bin/ece-tools cron:unlock을(를) 실행합니다. 한 환경을 다른 환경으로 병합하는 중이었다면 두 환경에서 cron을 실행하는지 확인하십시오.
b. 아니요 - 17단계로 진행합니다.

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

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

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

사용 가능한 저장소는 괜찮습니까?
a. 예 - 11단계를 진행합니다.
b. 아니요 - 디스크 공간 관리를 검토합니다.

11단계 - 디스크 공간 확인 step-11

파일을 쓸 수 없습니다. 경고<>?
a. 예 - .magento.app.yaml에서 디스크 값을 늘린 다음 다시 배포하십시오. 이 기능이 작동하지 않으면 지원 티켓을 제출하십시오.
b. 아니요 - 12단계를 진행합니다.

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

환경 재배포에 실패했습니다.
a. 예 - 13단계를 진행합니다.
b. 아니요 - 8단계를 진행합니다.

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

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

14단계 - 공간 제한 확인 step-14

파일 시스템에 inodes 또는 space가 없습니다.
a. 예 - 디스크 공간 관리를 참조하십시오.
b. 아니요 - 15단계로 진행합니다.

15단계 - Elasticsearch 버전 오류 step-15

Elasticseach 버전에 대해 오류가 있습니까?
a. 예 - 16단계로 진행합니다.
b. 아니요 - 21단계로 진행합니다.

16단계 - 작성기 구성 확인 step-16

작성기 구성이 올바르십니까?
a. 예 - 10단계로 진행합니다.
b. 아니요 - 작성기 문제 해결사 웹 페이지를 검토합니다.

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

장기 실행 프로세스

a. 예 - 장기 실행 프로세스를 식별한 다음 프로세스를 종료합니다.

  1. 터미널에서 ps aufx 명령을 실행합니다.
  2. 장기 실행 프로세스의 PID를 찾습니다.
  3. kill -9 <PID>을(를) 사용하여 프로세스를 종료합니다.

재발생에 대해 배포를 모니터링합니다.

b. 아니요 - 18단계로 진행합니다.

18단계 - 후크 후 실패 확인 step-18

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

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

타사 확장을 사용합니까?
a. 예 - 특히 오류에 확장 이름이 있는 경우 타사 확장을 사용하지 않도록 설정하고 배포를 실행(문제의 원인이 되는지 확인)해 보십시오.
b. 아니요 - 20단계로 진행합니다.

20단계 - 느린 쿼리 확인 step-20

오래 실행되는 쿼리

느린 쿼리 로그 및 MySQL 표시 프로세스 목록을 확인합니다.

a. 예 - 오래 실행되는 쿼리를 모두 종료합니다. MySQL Kill 구문을 검토합니다.
b. 아니요 - 지원 티켓을 제출.

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

Elasticsearch 버전을 다운그레이드하시겠습니까?
a. 예 - 구성을 통해 수행할 수 없습니다. 지원 티켓을 제출.
b. 아니요 - 지원 티켓을 제출.

1단계로 돌아가기

recommendation-more-help
8bd06ef0-b3d5-4137-b74e-d7b00485808a