Cloud Automation Patching Service (CAPS) 문제 해결 안내서
패치 작업에 CAPS을(를) 사용할 때 오류 메시지와 함께 성공적인 패치 적용 또는 전환을 방해하는 문제가 발생할 수 있습니다. 이 안내서에서는 가장 일반적인 문제에 대한 해결 방법을 제공합니다.
빠른 문제 해결 단계
패치 작업이 실패한 경우
- 실패한 단계를 이해하려면 작업 상태를 확인하십시오.
- 특정 실패 이유에 대한 오류 메시지 검토
- 기술적인 세부 정보는 오류 로그를 확인하십시오.
- 이 안내서에 제공된 솔루션을 따르십시오.
패치 작업 기간
대부분의 환경에서 다음 타임라인은 패치 작업에 걸리는 시간을 설명하지만 환경 크기와 복잡성에 따라 더 오래 걸릴 수 있습니다.
- 전처리: 2-5분
- 패치 중: 5-15분
- 사후 처리: 10~40분
- 전체: 15-60분
진행 중인 패치 취소
일반적인 성공 메시지
-
"작업이 완료되었습니다" - 문제 없이 패치를 적용/되돌렸습니다.
-
"패치가 적용되었습니다" - 이미 적용된 패치를 적용하려고 합니다. 시스템에서 패치가 사용자 환경에 이미 있음을 감지했습니다. 조치가 필요하지 않습니다.
-
"패치가 되돌려졌습니다." - 이미 되돌려진 패치를 되돌리려고 합니다. 시스템에서 해당 패치가 현재 적용되지 않았음을 감지했습니다. 조치가 필요하지 않습니다.
일반적인 오류 메시지 및 솔루션
패치 응용 프로그램 오류
"CAPS이(가) 코드베이스 또는 패치 파일에서 이러한 문제를 감지했으므로 패치를 적용할 수 없습니다."
발생할 때: 사전 확인 중
원인: 패치가 현재 코드 베이스와 충돌하거나 패치 자체에 문제가 있습니다
솔루션:
- 제공된 자세한 오류 로그를 검토하여 코드베이스 또는 패치 문제인지 확인하십시오
- 코드에서 충돌하는 사용자 지정 확인
- 패치가 Adobe Commerce 버전과 호환되는지 확인합니다
- 수동으로 충돌 해결을 고려하거나 지원 팀에 문의
"이 패치는 CAPS에서 관리되지 않습니다. 되돌릴 수 없음"
되돌리기 작업 중 발생 시
원인: CAPS을(를) 통해 적용되지 않은 패치를 되돌리려고 합니다.
해결 방법: 원래 패치를 적용하는 데 사용한 것과 동일한 방법을 사용하거나 지원 팀에 문의하여 지원을 받으십시오
환경 및 유효성 검사 오류
"환경이 상위 항목과 동기화되지 않음"
유효성 검사 중 발생하는 경우:
원인: 통합 환경이 상위 환경과 다릅니다.
솔루션:
- 환경을 상위 분기와 동기화
- 패치 작업 다시 시도
- 동기화 문제가 지속되는 경우 지원 센터에 문의
"프로덕션 환경 보호 장치가 충족되지 않음"
발생할 때: 프로덕션 환경에 대한 사전 검사 중
원인: 프로덕션 환경이 필요한 안전 조건을 충족하지 않습니다
솔루션:
- 프로덕션 스토어에 대한 유지 관리 모드 활성화
- 프로덕션 환경에서 크론 작업 비활성화
- 다시 시도하기 전에 두 조건이 모두 충족되는지 확인하십시오
"패치가 적용되었지만 상태 검사에 실패했습니다. 되돌리기를 고려하십시오."
발생할 때: 유효성 검사 중 패치 적용 후
원인: 패치가 적용되었지만 상태 검사가 실패했습니다.
솔루션:
- 특정 오류에 대한 응용 프로그램 로그 검토
- 중요한 기능을 수동으로 테스트
- 문제가 지속되면 패치를 되돌리는 것이 좋습니다
- 지원이 필요한 경우 지원 센터에 문의하십시오
인증 및 액세스 오류
"Adobe Commerce 저장소에 대한 인증 실패"
발생 시:
원인: 잘못되었거나 만료된 Adobe Commerce 저장소 자격 증명입니다.
솔루션:
이 문제를 해결하기 위한 두 가지 권장 옵션이 있습니다.
옵션 1: env:COMPOSER_AUTH 환경 수준 변수 수정(권장)
env:COMPOSER_AUTH에 대한 올바른 자격 증명을 설정했는지 확인하십시오.- 클라우드 프로젝트 UI의 왼쪽 상단에 있는 톱니바퀴 아이콘을 클릭하여 전역 구성에 액세스한 다음 변수 탭을 선택합니다.
- 빌드 시간 동안 사용 가능 을 선택하고 런타임 동안 사용 가능 을 선택 취소합니다.
옵션 1로 문제가 해결되지 않으면 옵션 2를 계속 사용하십시오.
옵션 2: auth.json 파일을 수동으로 만들고 배포
- 서버에 SSH를 입력합니다.
- 다음을 사용하여 현재
env:COMPOSER_AUTH변수의 콘텐츠를 검색합니다.echo $COMPOSER_AUTH - 위 단계(JSON 형식)의 모든 콘텐츠를 복사합니다.
- 이 내용으로 이름이
auth.json인 새 파일을 만듭니다. - 새로 만든 이
auth.json파일을 리포지토리의 루트 디렉터리에 커밋합니다. - 새 배포를 트리거합니다.
"환경 액세스에 대한 권한이 충분하지 않음"
발생할 때: 환경을 만들거나 액세스하는 동안
원인: 사용자 계정에 필요한 권한이 없습니다.
솔루션:
- 사용자 역할 및 권한 확인
- 시스템 관리자에게 문의하십시오
- 환경 관리 권한이 있는지 확인
- 배포 권한이 있는지 확인합니다.
리소스 및 할당량 오류
"환경 할당량 초과"
발생할 때: 환경 생성 중
원인: 환경 제한에 도달했습니다.
솔루션:
- 사용하지 않는 환경 비활성화
- 이전 분기 및 배포 정리
- 할당량 증가를 요청하려면 지원팀에 문의하십시오
- 플랜 업그레이드를 고려하십시오.
"작업에 필요한 리소스 부족"
발생 시:
원인: 환경에 충분한 CPU, 메모리 또는 저장소가 없습니다.
솔루션:
- 환경 리소스 사용량 확인
- 파일을 정리하여 리소스 여유 확보
- 리소스를 사용할 수 있을 때까지 대기
- 리소스 문제가 지속되면 지원 센터에 문의
도움말 보기
지원 문의 시기:
다음의 경우 Adobe Commerce Cloud 지원 센터에 문의하십시오.
- 오류 메시지가 명확하지 않거나 세부 정보가 부족합니다.
- 패치 작업이 지속적으로 실패
- 수동 충돌 해결에 대한 지원이 필요합니다.
- 상태 검사에 실패하지만 원인은 명확하지 않습니다.
- 환경 동기화 문제에 대한 도움이 필요합니다.
제공할 정보:
지원에 문의할 때 다음을 제공하십시오.
- 프로젝트 ID - Adobe Commerce Cloud 프로젝트 식별자
- 환경 ID - 문제가 발생한 특정 환경
- 작업 ID - CAPS 작업 식별자
- 오류 세부 정보 - 전체 오류 메시지 및 로그
- 재현 단계 - 오류 발생 시 수행 중인 작업
- 이전 시도 - 문제를 해결하기 위해 이미 시도한 사항
추가 리소스
자세한 기술 정보는 다음을 참조하십시오.
- 실패한 작업과 함께 제공된 전체 오류 로그 검토
- Adobe Commerce 설명서에서 패치별 지침을 확인하십시오
- 환경별 문제는 Adobe Commerce Cloud 지원 센터에 문의하십시오