Adobe Commerce Patching Automation 문제 해결 안내서

패치 작업에 Patching Automation을(를) 사용할 때 오류 메시지와 함께 성공적인 패치 적용 또는 전환을 방해하는 문제가 발생할 수 있습니다. 이 안내서에서는 가장 일반적인 문제에 대한 해결 방법을 제공합니다.

빠른 문제 해결 단계

패치 작업이 실패한 경우

패치 작업 기간

대부분의 환경에서 다음 타임라인은 패치 작업에 걸리는 시간을 설명하지만 환경 크기와 복잡성에 따라 더 오래 걸릴 수 있습니다.

진행 중인 패치 취소

일반적인 성공 메시지

일반적인 오류 메시지 및 솔루션

환경 준비 오류

“마지막 배포가 실패했습니다. 패치를 적용하거나 되돌리기 전에 환경이 안정적인지 확인하십시오.”

발생할 때: 패치 관련 유효성 검사 전 사전 검사 시작 시

원인: 대상 환경의 최신 배포가 완료되지 않았습니다

해결 방법: 대상 환경을 다시 배포하고 배포가 성공적으로 완료되었는지 확인합니다(Cloud Console에서 해당 배포 로그 확인). 그런 다음 패치 작업을 다시 시도합니다.

패치 응용 프로그램 오류

“Patching Automation이(가) 코드베이스 또는 패치 파일에서 이러한 문제를 감지했으므로 패치를 적용할 수 없습니다.”

발생할 때: 사전 확인 중

원인: 패치가 현재 코드 베이스와 충돌하거나 패치 자체에 문제가 있습니다

솔루션:

“Patching Automation을(를) 통해 적용되지 않은 패치를 되돌리려고 합니다. 패치가 수동으로 적용되었을 가능성이 높습니다.”

되돌리기 작업 중 발생 시

원인: Patching Automation을(를) 통해 적용되지 않은 패치를 되돌리려고 합니다.

해결 방법: 원래 패치를 적용하는 데 사용한 것과 동일한 방법을 사용하거나 지원 팀에 문의하여 지원을 받으십시오

환경 및 유효성 검사 오류

“환경이 상위 항목과 동기화되지 않음”

발생할 때: 유효성 검사 중에 동기화 사전 검사에서 통합 환경을 대상 환경에 병합하기 전에

원인: 통합 환경이 상위 환경과 다릅니다. 일반적으로 패치를 테스트하는 동안 대상 환경이 변경되었기 때문입니다

솔루션:

“병합 후 확인 실패: 병합 후 환경이 동기화되지 않습니다.”

발생할 때: 유효성 검사 중에 통합 환경이 이미 대상 환경에 병합된 후

원인: 병합 후 두 환경 코드의 코드가 일치하지 않습니다. 일반적으로 실제 충돌이 아닌 임시 Platform.sh API 전파 지연입니다

솔루션:

“cron이 활성화되고 유지 관리 모드가 비활성화된 경우 프로덕션 환경에서 패치 작업을 만들 수 없습니다. 패치를 적용하기 전에 유지 관리 모드를 활성화하고 크론 작업을 비활성화하십시오.”

발생할 때: 프로덕션 환경에 대한 사전 검사 중

원인: 프로덕션 환경이 필요한 안전 조건을 충족하지 않습니다

솔루션:

“패치 작업이 완료되었지만 환경 상태 검사가 실패했습니다. 이는 배포와 관련된 잠재적 문제를 나타냅니다. 환경 상태를 검토하고 변경 내용을 되돌리는 것을 고려하십시오.”

발생할 때: 패치 적용 또는 복귀 후 유효성 검사 중

원인: 패치가 적용되었거나 복구되었지만 이후 상태 검사가 실패했습니다

솔루션:

인증 및 액세스 오류

“액세스 거부됨”

발생할 때: 환경 만들기 또는 액세스 중에 계정에 필요한 권한이 없을 때

원인: 사용자 계정에 필요한 권한이 없습니다.

솔루션:

GitHub 통합 오류

“Github” 공급자에 사용할 수 있는 Git 자격 증명이 없습니다." 이 저장소용 패치 자동화 GitHub 앱 설치"

발생할 때: GitHub에 연결된 프로젝트에 대한 패치 작업 중

원인: Patching Automation GitHub 앱이 저장소에 설치되지 않았습니다

해결 방법: GitHub 통합 설정 Patching Automation의 단계에 따라

“GitHub API 요청 실패”

발생할 때: GitHub 연결 프로젝트에 대한 패치 작업 중

원인: 일시적인 문제로 인해 서비스가 GitHub에 연결되지 않았습니다.

해결 방법: 몇 분 정도 기다린 후 작업을 다시 시도하십시오. 오류가 계속되면 Adobe Commerce Cloud 지원에 문의하십시오.

“환경이 시간 제한 내에 만들어지지 않음”(GitHub 연결 프로젝트)

통합 환경을 만드는 동안 발생하는 경우:

원인: 프로젝트의 GitHub 통합에서 fetch-branches 옵션이 비활성화되었습니다. 그 결과 서비스에 의해 푸시된 임시 분기는 동기화되지 않고 통합 환경이 생성되지 않습니다.

솔루션: 통합의 fetch-branches 옵션을 사용하도록 설정한 후 작업을 다시 시도하십시오. 다음에 대한 GitHub 통합 설정 Patching Automation을 참조하세요.

환경 활성화 오류

“통합 환경을 활성화할 수 없습니다.”

발생할 때: Patching Automation에서 패치를 안전하게 테스트하는 데 필요한 임시 통합 환경을 활성화할 수 없는 경우.

원인:​은(는) 오류와 함께 표시되는 추가 세부 정보에 따라 다릅니다.

세부 정보에 Composer 또는 Adobe Commerce 패키지가 언급되는 경우:

세부 정보에 환경 슬롯 또는 리소스가 언급되는 경우:

다른 원인: 패치 자동화 UI에서 자세한 오류 로그를 검토하거나 정확한 오류 텍스트를 지원팀에 문의하십시오.

도움말 보기

지원 문의 시기:

다음의 경우 Adobe Commerce Cloud 지원 센터에 문의하십시오.

제공할 정보:

지원에 문의할 때 다음을 제공하십시오.

추가 리소스

자세한 기술 정보는 다음을 참조하십시오.

관련 항목