

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 문제 해결
<a name="ct-troubleshooting"></a>

연결이 거부되었거나 서버가 실행되지 않음  
지속적 현대화 CLI에는 실행 중인 서버가 필요합니다. 로 시작하고 로 `atx ct server &` 확인합니다`atx ct status --health`.

검색 스캔은 리포지토리 0개를 반환합니다.  
로컬 소스의 경우 리포지토리가 포함된 상위 디렉터리(예: `/home/user/repos`)를 하위 디렉터리로 `--path` 가리키고 리포지토리를 직접 가리키지 않는지 확인합니다(예: `/home/user/repos/my-app`). 스캐너는 `.git` 폴더가 포함된 하위 디렉터리를 찾습니다.

SETUP\_REQUIRED 오류  
소스가 계정에 존재하지만 자격 증명이이 시스템에 구성되지 않았습니다. 를 실행`atx ct source add --name {{name}}`하여 로컬에서 자격 증명을 구성합니다.

AUTH\_REQUIRED 오류  
소스에 유효한 토큰을 찾을 수 없습니다. 토큰이 올바르고 필요한 범위가 있는지 확인합니다. GitHub의 경우 토큰에 `repo` 범위가 있는지 확인합니다. GitLab의 경우 `api` 범위를 확인합니다.

INVALID\_INPUT 오류  
올바른 분석 유형 이름을 사용하고 있는지 확인합니다. 유효한 값은 `rapid-techdebt-analysis`, `tech-debt-comprehensive`, `security`, `agentic-readiness`, `modernization-readiness`, `custom`입니다.

문제 해결 중 권한 오류  
문제 해결은 리포지토리에 대한 쓰기 액세스 권한이 필요한 브랜치와 풀/병합 요청을 생성합니다. 쓰기 권한으로 토큰을 업데이트합니다. GitHub의 경우 전체 `repo` 범위를 확인합니다. GitLab의 경우 `api` 범위를 확인합니다. Bitbucket의 경우 `write:repository:bitbucket` 및 `write:pullrequest:bitbucket` 범위를 확인합니다.

보안 에이전트 설정 실패  
IAM 사용자 또는 역할에의 보안 에이전트 설정 섹션에 나열된 필수, AWS CloudFormation IAM 및 Amazon S3 권한이 있는지 확인합니다[지속적 현대화 AWS 의 작동 방식](continuous-modernization.md#ct-how-it-works). 를 사용하여 상태를 확인합니다`atx ct setup security-agent --status`.

웹 애플리케이션에 지속적인 현대화가 표시되지 않음  
 AWS 변환 웹 애플리케이션에 로그인한 후에도 지속적인 현대화가 나타나지 않으면 IAM Identity Center 대신 AWS 계정 AWS 변환이 활성화된의 AWS IAM 자격 증명으로 로그인합니다. 단계는 [AWS 웹 애플리케이션 변환(선택 사항)](ct-working-with.md#ct-web-application)를 참조하세요.