View a markdown version of this page

문제 해결 - AWS 변환
로그 위치공통 문제지원 받기S3 액세스 문제

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

문제 해결

이 섹션에서는 사용자 지정 AWS 변환과 관련된 일반적인 문제를 해결하기 위한 지침을 제공합니다.

로그 위치

AWS 변환 CLI는 다음 위치에 로그를 유지합니다.

대화 로그:

Linux and macOS
~/.aws/atx/custom/<conversation_id>/logs/<timestamp>-conversation.log
Windows
%USERPROFILE%\.aws\atx\custom\<conversation_id>\logs\<timestamp>-conversation.log

이러한 로그에는 특정 변환 실행을 디버깅하기 위한 전체 대화 기록이 포함되어 있습니다.

하위 에이전트 로그:

Linux and macOS
~/.aws/atx/custom/<conversation_id>/logs/subagents/<name>.log
Windows
%USERPROFILE%\.aws\atx\custom\<conversation_id>\logs\subagents\<name>.log

이러한 로그에는 변환 중에 기본 에이전트가 생성하는 하위 에이전트의 출력이 포함됩니다. 하위 에이전트를 직접 관리할 필요는 없습니다.

개발자 디버그 로그:

Linux and macOS
~/.aws/atx/logs/debug*.log
~/.aws/atx/logs/error.log
Windows
%USERPROFILE%\.aws\atx\logs\debug*.log
%USERPROFILE%\.aws\atx\logs\error.log

이러한 로그는 CLI 작업 및 오류에 대한 자세한 정보를 제공합니다. 각 로그 파일은 롤오버되기 전에 5MB 제한이 있습니다. 이 디렉터리에는 debug1.log 및 debug2.log와 같은 여러 디버그 로그가 있을 수 있습니다.

공통 문제

설치 문제:

설치에 실패하면 Node.js 22 이상이 설치되어 있는지 확인합니다.

node --version

필요한 경우 https://nodejs.org/en/download Node.js를 다운로드합니다.

인증 문제:

자격 AWS 증명이 올바르게 구성되었는지 확인합니다.

aws sts get-caller-identity

IAM 사용자 또는 역할에 필요한 transform-custom:* 권한이 있는지 확인합니다.

네트워크 연결 문제:

연결 오류가 발생하면 필요한 엔드포인트에 대한 네트워크 액세스를 확인합니다.

  • transform-cli.awsstatic.com

  • transform-custom.<region>.api.aws

  • *.s3.amazonaws.com

인터넷 제한 환경에서 작업하는 경우 방화벽 규칙을 업데이트하여 이러한 URLs 허용 목록에 추가합니다.

리전 구성 문제:

리전 관련 오류가 발생하는 경우:

  • 리전이 지원되는지 확인

  • 구성을 재정의할 수 있는 환경 변수를 확인합니다. echo $AWS_REGION $AWS_DEFAULT_REGION

  • 리전 구성을 확인합니다. aws configure get region

  • 필요한 경우 리전을 업데이트합니다. aws configure set region <your-region>

  • 디버그 로그에서 리전 확인 세부 정보 확인

Git 문제:

Git이 설치되어 있고 리포지토리가 git 소스 제어 대상인지 확인합니다.

git --version
git status

AWS 사용자 지정 변환을 수행하려면 리포지토리가 git 소스 제어 대상이어야 합니다.

변환 실행 문제:

변환에 실패하는 경우:

  1. 에서 대화 로그 검토 ~/.aws/atx/custom/<conversation_id>/logs/

  2. 변환 출력에서 빌드 또는 테스트 실패 확인

  3. 프로젝트에 빌드 명령이 올바른지 확인

  4. 대화형 모드에서 변환을 실행하여 피드백을 제공하세요.

대화 재개 문제:

대화를 재개할 수 없는 경우:

  • 대화가 30일 미만인지 확인

  • 대화 ID가 올바른지 확인

  • 네트워크 연결이 있는지 확인

지원 받기

추가 지원이 필요하면 AWS 콘솔을 통한 AWS 지원을 참조하세요.

지원 티켓을 열 때 다음을 포함합니다.

  • 의 대화 로그 ~/.aws/atx/custom/<conversation_id>/logs/

  • 의 하위 에이전트 로그 ~/.aws/atx/custom/<conversation_id>/logs/subagents/

  • 에서 로그 디버깅 ~/.aws/atx/logs/

  • 문제를 재현하는 단계

  • AWS 변환 CLI 버전(atx --version)

S3 액세스 문제

AWS 변환 사용자 지정 서비스는 S3 미리 서명된 URLs 제공하여 클라이언트 시스템과 잠재적으로 큰 변환 파일을 쉽게 업로드하고 다운로드할 수 있도록 합니다. 즉, CLI는 AWS 변환 서비스 엔드포인트와 상호 작용할 뿐만 아니라 S3 서비스 엔드포인트와도 상호 작용합니다. 이러한 상호 작용은 미리 서명된 URLs 사용하므로 클라이언트의 IAM 자격 증명에 S3 권한이 필요하지 않지만 로컬 시스템의 프록시 서버 구성과 네트워크의 S3 VPC 엔드포인트 정책이이 트래픽을 제한할 수 있습니다.

변환 파일 다운로드 및 업로드와 관련된 도구 실패 또는 S3 액세스 거부의 근본 원인을 찾는 데 도움이 되는 로그 위치 자세한 오류 메시지는를 검토하세요.

https_proxy 및 no_proxy 환경 변수를 활용하는 VPN/프록시 서버를 사용하는 경우 환경 no_proxy 변수 값에 다음 값을 추가하여 S3 및 사용자 지정 서비스 엔드포인트 AWS 변환에 대한 프록시를 우회하는 것이 좋습니다.

Linux and macOS
export no_proxy=.s3.amazonaws.com,transform-custom.<region>.api.aws
Windows (PowerShell)
$env:no_proxy=".s3.amazonaws.com,transform-custom.<region>.api.aws"

VPC에서 AWS Amazon S3용 PrivateLink를 사용하는 경우 S3 트래픽을 제한하는 정책이 정의되어 있을 수 있습니다. S3 VPC 엔드포인트 정책이 사용자 지정 서비스 소유 버킷 AWS 에 대해 GetObject 및 PutObject 작업을 허용하는지 확인하세요. VPC 엔드포인트 정책에 다음 문을 추가하여이 작업을 수행할 수 있습니다.

{
    "Effect": "Allow",
    "Principal": "*",
    "Action": ["s3:PutObject","s3:GetObject"],
    "Resource": "arn:aws:s3:::aws-transform-custom-*/*"
}

정책의 명시적 Deny 문이 Allow 문보다 우선합니다. 액세스를 제한할 수 있는 Deny 문에 대한 S3 VPC 엔드포인트 정책을 검토합니다.