프로젝트 마이그레이션 체크리스트

마이그레이션이 프로젝트 내부에서 실행되는 서비스에 미치는 영향을 고려해야 합니다. 프로젝트 마이그레이션으로 인해 리소스 계층 구조가 변경되면 조직 정책, Identity and Access Management 정책 등 상속된 정책이 변경될 수 있습니다.

프로젝트 마이그레이션 중에 잠재적인 영향을 완화할 수 있도록 계획을 만듭니다. 계획에 필요한 정보를 제공하려면 Move Analysis API를 사용하여 프로젝트 마이그레이션의 차단 문제를 자세히 분석합니다.

자세한 내용은 마이그레이션 계획 만들기를 참조하세요.

조직 리소스 간에 프로젝트를 마이그레이션하려면 특정 IAM 역할 집합이 필요합니다. 조직 정책을 만들고 관리할 수 있는 권한도 필요합니다.

다음 역할을 획득하여 이러한 권한을 얻을 수 있습니다.

• 마이그레이션할 프로젝트 및 상위 리소스의 프로젝트 이동자(roles/resourcemanager.projectMover)

• 대상 폴더 또는 조직 리소스의 프로젝트 생성자(roles/resourcemanager.projectCreator)

• 소스 및 대상 조직 리소스 모두에 대한 조직 정책 관리자(roles/orgpolicy.policyAdmin)

필요한 역할 및 권한에 대한 자세한 내용은 권한 할당을 참조하세요.

조직 리소스 간에 프로젝트를 마이그레이션하려면 다음 조직 정책을 설정해야 합니다.

• 마이그레이션하려는 프로젝트의 상위 리소스에 constraints/resourcemanager.allowedExportDestinations 제약조건을 설정합니다. 이 제약조건은 프로젝트를 마이그레이션할 수 있는 조직 리소스를 정의합니다.

• 대상 리소스에 constraints/resourcemanager.allowedImportSources 제약조건을 설정합니다. 이 제약조건은 프로젝트를 가져올 수 있는 조직 리소스를 정의합니다.

이러한 제약조건 중 하나가 올바르게 설정되지 않으면 FAILED_PRECONDITION 오류와 함께 마이그레이션이 실패합니다.

프로젝트 마이그레이션에 필요한 조직 정책을 구성하려면 상위 조직과 대상 조직에 대한 roles/orgPolicy.policyAdmin 역할이 있어야 합니다.

이러한 조직 정책 제약조건에 대한 자세한 내용은 조직 정책 구성을 참조하세요.

조직 리소스 간에 프로젝트를 마이그레이션할 때는 프로젝트 및 조직 리소스 수준에서 특정 시나리오를 해결해야 할 수 있습니다. 마이그레이션 계획의 일부로 고려해야 하는 관련 서비스가 있을 수 있습니다. 프로젝트 운영과 관련된 서비스를 사용하는 경우에 이러한 사례를 고려해야 합니다.

특수한 사례의 목록과 이를 처리하는 방법은 특수한 사례 처리를 참조하세요.

위 단계를 완료하면 Resource Manager API를 사용하여 프로젝트를 마이그레이션할 수 있습니다. 마이그레이션을 수행하는 데 gcloud beta projects move Google Cloud CLI 명령어 또는 projects.update() REST API 메서드를 사용할 수 있습니다.

프로젝트 마이그레이션에 대한 자세한 내용은 마이그레이션 수행을 참조하세요.