Experience Modernation Agent 문제 해결 troubleshooting

증상을 찾은 다음 해당 섹션을 따르십시오. 대부분의 문제는 소스 사이트 액세스, Adobe Experience Manager Edge Delivery Services 사이트에 코드 및 콘텐츠를 작성하는 계정 또는 콘솔 작업 영역과 Git 및 콘텐츠 소스에 저장된 사항의 차이에서 발생합니다.

증상
섹션
가져오기에 실패하거나 캡처된 페이지에 오류 또는 로그인 페이지가 표시됩니다.
가져오기 실패
검색 후 URL이 없거나 소스 사이트가 HTTP 403, 429 또는 503을 반환합니다.
보트 보호를 사용하는 Source 사이트
변경 사항이 표시되지 않습니다.
변경 내용이 없습니다
콘솔 미리 보기가 미리 보기 사이트와 일치하지 않습니다.
콘솔 미리 보기가 사이트와 다릅니다
업로드, 가져오기 또는 전송이 실패합니다.
컨텐츠 쓰기 실패
콘솔에 저장소가 나열되지 않거나 푸시할 수 없습니다.
Git 연결 문제
콘솔은 작업 영역을 계속 준비합니다.
Workspace 설정에 시간이 걸리거나 실패합니다
로그인한 후 프로젝트가 사라졌습니다.
프로젝트가 누락된 것 같습니다
메시지를 보내지 못했습니다. 다시 시도하십시오.
메시지를 보내지 못함
가져온 페이지를 제거해야 합니다.
페이지 제거

재설정하거나, 삭제하거나, 대체하거나, 덮어쓰기 전에 영향을 받는 작업을 유지합니다. 코드와 콘텐츠는 별도로 복구됩니다. 릴리스, 복구 및 전달을 참조하세요.

이 페이지에서 문제를 해결하지 못하면 콘솔에서 지원을 요청하거나 자동 모드 페이지에서 도움말 받기​를 선택하십시오.

가져오기 실패 import-fails

오류와 정확한 소스 URL을 유지하고 URL이 브라우저에서 열리는지 확인합니다. 페이지에 로그인이 필요하거나 캡처에 콘텐츠 대신 로그인 페이지가 표시되면 보호된 사이트 인증을 설정하십시오. 소스 사이트가 자동화된 액세스를 차단하는 경우 보트 보호를 사용하는 Source 사이트를 참조하십시오. 소스에 연결할 수 있는 경우 에이전트에게 오류를 알리고 해당 페이지 가져오기를 수정하도록 요청하십시오. 일괄 처리를 반복하기 전에 영향을 받는 페이지 1개를 다시 시도하십시오.

보트 보호를 사용하는 Source 사이트 bot-protection

CDN(Content Delivery Network) 또는 WAF(Web Application Firewall)의 보트 보호는 URL 검색, 사이트 카탈로그, 페이지 캡처 및 가져오기와 같은 모든 워크플로우에서 소스 사이트에 대한 에이전트의 요청을 차단하거나 해결할 수 있습니다. 일반적인 기호는 HTTP 403, 429 또는 503과 같은 액세스 거부 오류, 검색 후 누락된 URL, 실패한 페이지 또는 페이지 콘텐츠 대신 캡처된 문제 또는 확인 페이지입니다.

소유하거나 마이그레이션할 권한이 있는 사이트만 마이그레이션합니다. 보호 작업 대신 사이트 관리자와 액세스를 조율합니다.

  1. 관리자에게 마이그레이션 기간 동안 액세스를 허용하도록 요청하십시오. 예를 들어 CDN 또는 WAF에서 백엔드 주소를 허용 목록에 추가로 제출하십시오.
  2. 보호가 보안 요청 헤더와 같은 자격 증명을 대신 수락하는 경우 콘솔 설정의 보호된 사이트 인증과 같이 워크플로에서 제공하는 인증 컨트롤에 자격 증명을 입력하십시오. 범위 자격 증명을 사용하고 마이그레이션이 완료되면 제거합니다.
  3. 관리자가 액세스 가능한 스테이징 또는 원본 호스트에 동일한 콘텐츠를 제공하는 경우 이를 소스로 사용하고 콘텐츠의 원본 호스트를 기록합니다.
  4. 검색만 차단되는 경우 대신 마이그레이션할 페이지 URL 목록을 제공하십시오.

카탈로그 또는 배치 실행을 시작하기 전에 이미지 및 기타 자산을 포함한 한 페이지를 확인합니다. 액세스 변경 후 실패한 페이지를 다시 시도하고, 캡처를 사용하여 챌린지 또는 액세스 거부된 페이지를 확인한 후 콘텐츠를 수락합니다.

IP 주소 allowlist-ip-addresses

소스 관리자의 승인을 통해 소스 추출을 위한 이러한 백엔드 주소를 생성합니다.

  • 34.228.136.112
  • 54.90.51.39
  • 3.224.194.242

허용 목록에 추가는 네트워크 액세스만 제공합니다. 원본은 인터넷을 통해 계속 연결할 수 있어야 하며 보호된 페이지에는 보호된 사이트 인증이 필요합니다.

변경 사항이 누락되었습니다. missing-change

코드와 컨텐츠가 다른 위치에 저장되므로 각각 콘솔 작업 영역, 업로드된 컨텐츠, 푸시된 분기 및 미리보기 페이지를 확인합니다. 다시 가져오기는 로컬 콘텐츠 변경 사항을 덮어쓰므로 페이지를 다시 가져오기 전에 편집 내용을 업로드하거나 조정합니다. 콘솔 미리 보기를 미리 보기 사이트와 비교하려면 콘솔 미리 보기가 사이트와 다름을 참조하십시오.

콘솔 미리보기가 사이트와 다름 preview-differs

보고 있는 결과 확인에서 설명한 대로 콘솔 미리 보기와 미리 보기 사이트는 콘텐츠 및 코드의 다른 복사본을 렌더링합니다. 다음 원인 중 하나를 찾으십시오.

  • 컨텐츠가 업로드되지 않음: 콘솔에서 변경된 페이지가 아직 Experience Workspace에 없습니다. 동기화 > 푸시 > 콘텐츠​를 사용하여 업로드합니다.
  • 다른 곳에서 편집된 콘텐츠: Experience Workspace에서 변경된 페이지가 아직 콘솔 작업 영역에 없습니다. 동기화 > 끌어오기 > 콘텐츠​를 사용하여 해당 페이지에 대한 로컬 편집 내용을 덮어씁니다. 새로 고침​은 렌더링만 다시 로드합니다.
  • 다른 코드: 코드가 푸시되지 않았거나 미리 보기 URL에서 다른 분기를 사용합니다. 코드를 푸시하고 코드가 있는 분기의 미리 보기 URL을 엽니다.
  • 다른 너비: 콘솔 미리 보기는 기본적으로 패널을 채웁니다. 뷰포트 메뉴를 사용하여 동일한 너비에서 비교합니다.
  • 미리 보기 사이트에서 제거하는 마크업: Edge Delivery Services은 섹션, 블록 및 기본 콘텐츠만 유지하므로 페이지 마크업 내의 스타일이 손실됩니다. 에이전트에게 프로젝트의 CSS로 이동하도록 요청합니다. 미리 보기 작동 방식을 참조하세요.

컨텐츠 쓰기 실패 write-errors

코드와 컨텐츠는 서로 다른 계정을 사용합니다. 코드는 다른 Git 호스트에 대해 GitHub 연결 또는 Cloud Manager 연결과 함께 푸시됩니다. 콘텐츠는 로그인한 Adobe 계정으로 Experience Workspace에 기록됩니다. 따라서 콘텐츠 업로드가 실패하는 동안 또는 그 반대의 방법으로 코드 푸시가 성공할 수 있습니다.

업로드, 가져오기 또는 전송에서 문서 작성 세션이 만료되었을 수 있다고 표시되면 다시 로그인하고 다시 시도하십시오. 세션이 유효하지만 Adobe 계정에 사이트 콘텐츠에 대한 쓰기 권한이 없는 경우 콘솔에 동일한 메시지가 표시됩니다. 지속되면 사이트 관리자에게 요청하여 콘솔에서 사용하는 이메일 주소 및 조직이 포함된 계정이 Experience Workspace의 사이트에 쓸 수 있는지 확인하십시오. Adobe Admin Console의 Experience Manager에 대한 액세스 권한 자체로는 사이트 콘텐츠에 대한 쓰기 액세스 권한을 부여하지 않습니다. 콘솔에 속도 제한이 있다고 표시되면 잠시 기다린 후 다시 시도하십시오.

Git 연결 문제 git-connection

각 GitHub 앱의 기능에 대해서는 저장소에서 시작을 참조하십시오.

문제
할 일
조직 또는 저장소가 나열되지 않았습니다.
AEM 코드 커넥터 앱이 조직 또는 계정에서 누락되었거나, 선택한 다른 저장소만 다루거나, 조직 소유자의 승인을 기다립니다. 리포지토리에서 시작에 설명된 대로 추가하십시오. 개인 액세스 토큰을 사용하면 콘솔에는 푸시할 수 있는 저장소만 나열됩니다.
저장소에 대한 쓰기 액세스 권한이 없습니다.
연결에 푸시 액세스가 필요합니다. 저장소 관리자에게 쓰기 액세스 권한을 요청하거나 다른 저장소를 연결합니다.
콘솔에서 미리보기 URL을 확인할 수 없습니다.
저장소에 AEM 코드 동기화가 없으면 사이트에 미리보기 URL이 없습니다. 앱이 있는지, URL이 https://{branch}--{site}--{organization}.aem.page 패턴을 따르는지 확인하십시오.
AEM 코드 커넥터 앱이 설치될 때까지 푸시를 사용할 수 없습니다 또는 AEM 코드 커넥터가 필요합니다.
콘솔은 저장소를 읽을 수 있지만 쓸 수 없습니다. AEM 코드 동기화를 통해 Edge Delivery Services은 코드를 읽을 수 있고 AEM 코드 커넥터만 콘솔로 변경할 수 있습니다. 저장소에 AEM 코드 커넥터를 추가합니다.
토큰이 잘못되었거나 만료된 경우 또는 토큰에 사용자 읽기 액세스 권한이 없습니다.
새 토큰을 만듭니다. 클래식 토큰 또는 사용자 계정을 읽고 저장소의 콘텐츠에 쓸 수 있는 세분화된 토큰을 사용하십시오.
LLM에서 내 git 자격 증명을 사용할 수 있도록 허용​이(가) 설정에 없습니다.
아직 설정을 사용할 수 없습니다. 에이전트는 콘솔 작업 영역에서 코드를 변경할 수 있습니다. 동기화 > 푸시 > 코드​를 사용하여 직접 푸시합니다.
푸시 거부: Cloud Manager에서 배포 관리자 역할이 필요합니다.
Cloud Manager을 통해 연결된 저장소의 경우 관리자에게 Cloud Manager의 배포 관리자 역할을 요청하십시오.

충돌하는 변경 내용과 보호된 분기의 경우 푸시 코드 변경을 참조하세요.

Workspace 설정에 시간이 소요되거나 실패함 workspace-setup

작업 영역을 준비하는 데 최대 10분이 소요되며, 처음 로그인할 때와 재설정 후 시간이 걸립니다. 모든 작업 영역이 사용 중인 경우 콘솔에 알려주고 사용 가능한 작업 영역이 있는 즉시 설정을 시작합니다. 다시 시도할 필요가 없습니다. 더 빨리 필요한 경우 지원 요청​을 선택하십시오. 설정에 실패하면 콘솔이 다시 시도할 것을 제공합니다. 계속해서 실패하면 설치 화면에서 지원 요청 링크를 사용하십시오. 콘솔에서 계정을 사용할 수 없다고 판단되면 Adobe 계정 팀에 문의하십시오. 작업 영역이 일시 중지됨​을 보여주는 작업 영역의 경우 Experience Modernation Console 열기를 참조하십시오.

프로젝트가 누락된 것 같습니다. missing-workspace

여러 Adobe 조직에 속해 있는 경우 프로젝트가 다른 조직의 콘솔 작업 영역에 있을 수 있습니다. 로그아웃한 다음 동일한 계정으로 로그인하고 이전에 사용한 조직의 프로필을 선택합니다. 조사하는 동안 작업 영역을 다시 설정하지 않음: 재설정하면 푸시하지 않은 작업이 삭제됩니다. 프로젝트가 여전히 누락된 경우 프로젝트 이름과 미리 보기 URL을 사용하여 지원을 요청합니다. 푸시된 코드와 업로드된 콘텐츠는 어느 방식으로든 Git 저장소 및 콘텐츠 소스에서 안전합니다.

메시지 전송 실패 send-failed

메시지를 보내지 못했습니다. 다시 시도하십시오. 는 콘솔이 에이전트에게 프롬프트를 전달할 수 없음을 의미합니다. 메시지가 네트워크 연결, 만료된 로그인 또는 임시 서비스 문제의 원인을 제공하지 않습니다.

  1. 네트워크 연결을 확인하고 메시지를 다시 보냅니다. 콘솔이 자동으로 다시 시도되지 않습니다.
  2. 다시 실패하면 프롬프트를 복사하고 페이지를 다시 로드한 다음 메시지가 표시되면 로그인합니다. 채팅 기록이 유지됩니다.
  3. 몇 분 후에도 계속 실패하는 경우 설정의 지원 요청​을 사용하여 실패 시간과 프로젝트 이름을 지정하십시오.

콘솔에 용량이 표시된다면 Workspace 설정에 시간이 걸리거나 실패합니다를 참조하십시오.

페이지 제거 remove-pages

콘솔의 안전 조치는 에이전트가 프로젝트의 콘텐츠 폴더에 있는 파일을 삭제하지 못하도록 하여 마이그레이션된 콘텐츠가 실수로 제거되지 않도록 합니다. 따라서 에이전트에게 페이지 삭제를 요청하는 것은 작동하지 않습니다. 이러한 항목이 있는 각 위치에서 직접 제거합니다.

  • 콘솔 작업 영역: 콘텐츠 보기에서 페이지를 선택하고 한 번에 한 페이지씩 삭제​를 사용합니다. 이렇게 하면 콘솔 작업 영역 복사본만 제거됩니다.
  • 콘텐츠 원본: Experience Workspace 또는 작성자 인스턴스에서 업로드된 페이지를 삭제합니다. 이 작업을 수행하기 전까지는 콘솔에서 삭제한 페이지가 클라우드 아이콘으로 콘텐츠 보기에 다시 나타납니다.
  • 미리 보기 및 라이브 사이트: AEM Sidekick을(를) 사용하여 미리 보고 게시된 페이지를 게시 취소하거나 삭제합니다.

페이지를 잘못된 경로로 가져온 경우 올바른 경로로 다시 가져와서 확인한 다음 잘못된 경로에서 사본을 삭제하십시오.

recommendation-more-help
experience-manager-cloud-service-help-main-toc