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를 사용하여 다음 명령을 실행합니다(여러 프로젝트에 추가된 경우).
| code language-none |
|---|
|
기존 배포 활동에 대한 정보를 찾으려면(Cloud UI에 "로그 전달" 오류가 있는 경우 배포 로그 확인 참조) 이 명령을 실행하여 해당 활동의 실행 로그를 가져올 수 있습니다.
| code language-none |
|---|
|
- 예 - 다른 환경 차단 배포 문제를 해결합니다. 3단계로 진행합니다.
- 아니요 - 현재 환경 문제를 해결합니다. 3단계로 진행합니다.
3단계 - 모든 노드에서 SSH 확인
모든 노드에 SSH가 성공했습니까?
- 예 - 4단계로 진행합니다.
- 아니요 - 지원 티켓을 제출.
4단계 - 실행 중인 모든 서비스 확인
모든 서비스가 실행 중입니까?
- 예 - 5단계로 진행합니다.
- 아니요 - 지원 티켓을 제출.
5단계 - Bitbucket 실행 확인
Bitbucket을 사용하시겠습니까?
- 예 - status.bitbucket.com을(를) 확인하십시오.
- 아니요 -빌드 및 배포 로그에서 배포 로그 오류를 확인합니다. 6단계로 진행합니다.
6단계 - 오류 코드 확인
오류 코드가 보고되었습니까?
- 예 - 7단계로 진행합니다.
- 아니요 - 8단계로 진행합니다.
7단계 - 403 금지됨 오류
403 금지?
- 예 - 16단계로 진행합니다.
- 아니요 - 9단계로 진행합니다.
8단계 - 실행 중인 cron 작업 확인
현재 cron 작업이 실행 중입니까?
| code language-none |
|---|
|
-
예 - 크론 작업을 종료한 후 잠금 해제합니다.
code language-none php vendor/bin/ece-tools cron:killphp vendor/bin/ece-tools cron:unlock -
아니요 - 17단계로 진행합니다.
9단계 - 원격 클러스터에 응용 프로그램 배포 가능 오류
원격 클러스터에 응용 프로그램을 업로드할 수 없습니까?
- 예 - 10단계로 진행합니다.
- 아니요 - 11단계로 진행합니다.
10단계 - 충분한 스토리지 확인
사용할 수 있는 창고죠?
-
예 - 11단계를 진행합니다.
-
아니요 - 디스크 공간 관리를 검토합니다.
11단계 - 디스크 공간 확인
12단계 - 환경 재배포 실패 오류
환경 재배포 실패 오류
- 예 - 13단계를 진행합니다.
- 아니요 - 8단계로 진행합니다.
13단계 - Elasticsearch 업그레이드 실패 확인
Elasticsearch을 업그레이드하거나 배포하시겠습니까?
- 예 - Elasticsearch에서 업그레이드 단계가 실패했습니다. Elasticsearch 소프트웨어 호환성을 참조하세요. Elasticsearch 업그레이드가 여전히 작동하지 않으면 지원 티켓을 제출하십시오. 참고: 클라우드 인프라의 Adobe Commerce에서는 인프라 팀에 48시간(영업시간) 통지를 하지 않으면 서비스 업그레이드를 프로덕션 환경으로 푸시할 수 없습니다. 이는 인프라 지원 엔지니어가 운영 환경에 대한 가동 중지 시간을 최소화하면서 원하는 기간 내에 구성을 업데이트할 수 있도록 해야 하기 때문에 필요합니다. 따라서 변경 사항이 프로덕션에 적용되기 48시간 전에 필요한 서비스 업그레이드에 대해 자세히 설명하고 업그레이드 프로세스를 시작할 시간을 기재한 지원 티켓을 제출하십시오.
- 아니요 - 14단계로 진행합니다.
14단계 - 공간 제한 확인
파일 시스템이 inodes나 space에서 벗어났습니까?
- 예 - 디스크 공간 관리를 참조하십시오.
- 아니요 - 15단계로 진행합니다.
15단계 - Elasticsearch 버전 오류
Elasticsearch 버전에 대한 오류
- 예 - 16단계로 진행합니다.
- 아니요 - 21단계로 진행합니다.
16단계 - 작성기 구성 확인
작성기 구성이 올바릅니까?
- 예 - 10단계로 진행합니다.
- 아니요 - 작성기 문제 해결사 웹 페이지를 검토합니다.
17단계 - 장기 실행 프로세스 확인
장기 실행 프로세스
-
예 - 프로세스 종료:
- 실행:
ps aufx - PID 찾기
- 종료:
kill -9 <PID>
- 실행:
-
아니요 - 18단계로 진행합니다.
18단계 - 후크 후 실패 확인
후크 후 실패/중단?
- 예 - 데이터베이스: 사용 가능한 디스크 공간, 손상, 불완전/손상된 테이블.
- 아니요 - 19단계로 진행합니다.
19단계 - 서드파티 확장이 배포를 차단하는지 확인
타사 확장을 사용하시겠습니까?
- 예 - 타사 확장을 사용하지 않도록 설정한 후 다시 배포해 보십시오.
- 아니요 - 20단계로 진행합니다.
20단계 - 느린 쿼리 확인
오래 실행되는 쿼리
느린 쿼리 로그 및 MySQL 표시 processlist을(를) 확인하십시오.
- 예 - 오래 실행되는 쿼리를 모두 종료합니다. MySQL Kill을 검토합니다.
- 아니요 - 지원 티켓을 제출.
21단계 - Elasticsearch 버전 다운그레이드
recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f