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

이 체크리스트는 조직 리소스 간에 프로젝트를 마이그레이션하는 데 도움이 됩니다. 아래 체크리스트에는 조직 리소스 간 프로젝트 마이그레이션과 관련된 주요 태스크 목록, 각 단계에 대한 간략한 안내, 추가 정보 링크가 포함되어 있습니다.

마이그레이션 계획 만들기

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

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

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

Identity and Access Management 역할 할당

조직 리소스 간에 프로젝트를 마이그레이션하려면 특정 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 메서드를 사용할 수 있습니다.

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