Amazon CodeCatalyst는 더 이상 신규 고객에게 공개되지 않습니다. 기존 고객은 정상적으로 서비스를 계속 이용할 수 있습니다. 자세한 내용은 [CodeCatalyst에서 마이그레이션하는 방법](migration.md) 단원을 참조하십시오. 기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # 스페이스와 연결된 계정의 문제 해결 CodeCatalyst에서 스페이스 AWS 계정 에를 추가하여 리소스에 권한을 부여하고 결제를 목적으로 할 수 있습니다. 다음 정보는 CodeCatalyst에서 관련 계정과 관련된 일반적인 문제를 해결하는 데 도움이 될 수 있습니다. **Topics** + [AWS 계정 연결 요청이 잘못된 토큰 오류를 수신함](#troubleshooting-connection-token) + [내 Amazon CodeCatalyst 프로젝트 워크플로가 구성된 계정, 환경 또는 IAM 역할에 대한 오류로 실패합니다](#connections-troubleshoot-workflow) + [프로젝트를 생성하려면 연결된 계정, 역할 및 환경이 필요해요](#connections-troubleshoot-environment) + [의 Amazon CodeCatalyst Spaces 페이지에 액세스할 수 없습니다. AWS Management Console](#connections-troubleshoot-console) + [다른 계정을 청구 계정으로 사용하고 싶어요](#connections-troubleshoot-billing) + [연결 이름 오류와 함께 프로젝트 워크플로가 실패합니다.](#connections-troubleshoot-restriction) ## AWS 계정 연결 요청이 잘못된 토큰 오류를 수신함 **문제:** 연결 토큰으로 연결 요청을 생성할 때 페이지는 토큰을 수락하지 않으며 토큰이 유효하지 않다는 오류를 표시합니다. **가능한 해결 방법:** 스페이스에 추가할 계정 ID를 제공해야 합니다. 에 대한 관리 권한이 AWS 계정 있거나 관리자와 협력하여 계정을 추가할 수 있어야 합니다. 계정 확인을 선택하면 AWS Management Console에서 새 브라우저 창이 열립니다. 콘솔 측에 동일한 계정을 로그인해야 합니다. 다음을 확인한 후 다시 시도하세요. + 스페이스에 추가하려는 AWS 계정 것과 동일한 AWS Management Console 를 사용하여에 로그인합니다. + 리전이 스페이스에 맞는 올바른 리전으로 설정된 AWS Management Console 상태로에 로그인합니다. + 청구 페이지에서 AWS 계정 을 스페이스의 지정된 청구 계정으로 추가하려는 경우 계정이 다른 스페이스 또는 스페이스의 청구 계정으로 할당량에 도달하지 않았는지 확인하세요. ## 내 Amazon CodeCatalyst 프로젝트 워크플로가 구성된 계정, 환경 또는 IAM 역할에 대한 오류로 실패합니다 **문제:** 워크플로가 실행되고 스페이스과 연결된 구성된 계정 또는 IAM 역할을 찾지 못하면 워크플로 YAML에서 역할, 연결 및 환경 필드를 수동으로 입력해야 합니다. 실패한 워크플로 작업을 보고 오류 메시지가 다음과 같은지 확인합니다. + 이 역할은 환경과 연결된 연결과 함께 사용할 수 없습니다. + 작업이 성공하지 못했습니다. 상태: FAILED, 계정 연결 또는 환경에 대해 제공된 값이 유효하지 않습니다. 연결이 스페이스과 연결되어 있고 환경이 프로젝트와 연결되어 있는지 확인합니다. + 작업이 성공하지 못했습니다. 상태: FAILED, IAM 역할에 대해 제공된 값이 유효하지 않습니다. 이름이 존재하고, IAM 역할이 계정 연결에 추가되고, 연결이 이미 Amazon CodeCatalyst 스페이스와 연결되어 있는지 확인합니다. **가능한 해결 방법:** 워크플로 YAML 필드에 [환경](build-action-ref.md#build.environment.connections.role), [연결](build-action-ref.md#build.environment) 및 [역할](build-action-ref.md#build.environment.connections)에 대한 정확한 값이 있는지 확인합니다. 환경이 필요한 CodeCatalyst 워크플로 작업은 AWS 리소스를 실행하거나 AWS 리소스 스택을 생성하는 빌드 또는 배포 작업입니다. 실패한 워크플로 작업 블록을 선택한 다음 **비주얼**을 선택합니다. **구성** 탭을 선택합니다. **환경,** **연결 이름** 및 **역할 이름** 필드가 채워지지 않은 경우 워크플로를 수동으로 업데이트해야 합니다. 워크플로 YAML을 편집하려면 다음 단계를 따르세요. + `/.codecatalyst` 디렉터리를 확장한 다음 `/workflows` 디렉터리를 확장합니다. 워크플로 YAML 파일을 엽니다. 워크플로에 대해 구성한 YAML에 IAM 역할 및 계정 정보가 지정되어 있는지 확인합니다. 예제: ``` Actions: cdk_bootstrap: Identifier: action-@v1 Inputs: Sources: - WorkflowSource Environment: Name: Staging Connections: - Name: account-connection Role: build-role ``` CodeCatalyst 워크플로 빌드를 실행하고 AWS 리소스를 사용하여 작업을 배포하려면 **Environment, Connection, Role** 속성이 필요합니다. 예시는 [Environment](build-action-ref.md#build.environment), [Connections](build-action-ref.md#build.environment.connections) 및 [Role](build-action-ref.md#build.environment.connections.role)에 대한 CodeCatalyst 빌드 작업 참조 YAML 파라미터를 참조하세요. + 스페이스에 계정이 추가되어 있는지 확인하고 계정에 적절한 IAM 역할 또는 계정에 추가된 역할이 있는지 확인합니다. **스페이스 관리자** 역할이 있는 경우 계정을 조정하거나 추가할 수 있습니다. 자세한 내용은 [연결된를 사용하여 AWS 리소스에 대한 액세스 허용 AWS 계정](ipa-connect-account.md) 섹션을 참조하세요. ## 프로젝트를 생성하려면 연결된 계정, 역할 및 환경이 필요해요 **문제:** 프로젝트 생성 옵션에서 프로젝트에 내 스페이스에 사용 가능한 계정이 추가되지 않았거나 프로젝트를 사용하려면 내 스페이스에 다른 계정을 추가해야 합니다. **가능한 수정 사항:** 스페이스 관리자 역할이 있는 경우 **스페이스**에 대해 프로젝트에 AWS 계정 추가할 수 있는 권한을 추가할 수 있습니다. 관리자 권한이 있거나 AWS 관리자와 함께 작업할 수 있는 AWS 계정 도 있어야 합니다. 프로젝트 생성 화면에서 계정과 역할을 사용할 수 있도록 하려면 먼저 계정과 역할을 추가해야 합니다. 자세한 내용은 [연결된를 사용하여 AWS 리소스에 대한 액세스 허용 AWS 계정](ipa-connect-account.md) 섹션을 참조하세요. **CodeCatalystWorkflowDevelopmentRole-{{spaceName}}** 역할 정책이라는 역할 정책을 사용하여 서비스 역할을 생성하도록 선택할 수 있습니다. 역할에는 고유한 식별자가 추가된 `CodeCatalystWorkflowDevelopmentRole-{{spaceName}}` 이름이 있습니다. 역할 및 역할 정책에 대한 자세한 내용은 [**CodeCatalystWorkflowDevelopmentRole-{{spaceName}}** 서비스 역할 이해](ipa-iam-roles.md#ipa-iam-roles-service-role) 섹션을 참조하세요. 역할을 생성하는 단계는 [계정 및 스페이스의 **CodeCatalystWorkflowDevelopmentRole-{{spaceName}}** 역할 생성](ipa-iam-roles.md#ipa-iam-roles-service-create) 섹션을 참조하세요. 역할은 계정에 추가되며 CodeCatalyst의 프로젝트 생성 페이지에서 사용할 수 있습니다. ## 의 Amazon CodeCatalyst Spaces 페이지에 액세스할 수 없습니다. AWS Management Console **문제:**의 Amazon CodeCatalyst 페이지에 액세스하여 내 CodeCatalyst 스페이스에 AWS Management Console 계정을 추가하거나의 계정에 역할을 추가하려고 하면 권한 오류가 AWS발생합니다. **수정 방법:** 스페이스 관리자 역할이 있는 경우 **스페이스**에 대해 프로젝트에 AWS 계정 추가할 수 있는 권한을 추가할 수 있습니다. 관리자 권한이 있거나 AWS 관리자와 함께 작업할 수 있는 AWS 계정 도 있어야 합니다. 먼저 관리하려는 계정 AWS Management Console 과 동일한 계정으로에 로그인했는지 확인해야 합니다. 에 로그인한 후 콘솔을 열고 다시 시도 AWS Management Console할 수 있습니다. AWS Management Console [https://us-west-2.console.aws.amazon.com/codecatalyst/home?region=us-west-2](https://us-west-2.console.aws.amazon.com/codecatalyst/home?region=us-west-2#/)의 Amazon CodeCatalyst 페이지를 엽니다. ## 다른 계정을 청구 계정으로 사용하고 싶어요 **문제:** CodeCatalyst 로그인을 설정할 때 스페이스를 설정하고 권한이 부여된 AWS 계정을 연결하는 여러 단계를 완료했습니다. 이제 다른 계정에 청구 권한을 부여하려고 합니다. **가능한 해결 방법:** **스페이스 관리자** 역할이 있는 경우 스페이스에 대해 청구 계정을 승인할 수 있습니다. 관리자 권한이 있거나 AWS 관리자와 협력할 수 AWS 계정 있는 도 있어야 합니다. 자세한 내용은 Amazon CodeCatalyst 관리자 안내서의 [Managing billing](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-billing.html)을 참조하세요. ## 연결 이름 오류와 함께 프로젝트 워크플로가 실패합니다. **문제:** 프로젝트를 생성한 다음 프로젝트 워크플로를 실행할 때 워크플로가 실패하고 다음과 같이 연결 이름이 유효하지 않다는 오류가 표시됩니다. 에서 실패: 연결 이름이 유효하지 않습니다. **가능한 해결 방법:** 스페이스에 추가할 계정 ID를 제공하고 계정이 프로젝트 제한 계정 연결에 대해 활성화되지 않았는지 확인합니다. 계정이 프로젝트 제한 계정 연결에 대해 활성화된 경우 새 프로젝트에 대한 액세스를 활성화하여 계정 연결을 업데이트해야 할 수 있습니다. 자세한 내용은 [Configuring project-restricted account connections](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-accounts.html#managing-accounts-restriction)를 참조하세요.