Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.
프로젝트 마이그레이션 체크리스트
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
이 체크리스트는 조직 리소스 간에 프로젝트를 마이그레이션하는 데 도움이 됩니다. 아래 체크리스트에는 조직 리소스 간 프로젝트 마이그레이션과 관련된 주요 태스크 목록, 각 단계에 대한 간략한 안내, 추가 정보 링크가 포함되어 있습니다.
마이그레이션 계획 만들기
프로젝트 내에서 실행되는 서비스에 대한 마이그레이션의 영향을 분석합니다.
리소스 계층 구조가 변경되면 상속된 정책에 영향을 줄 수 있습니다.
- 이동 분석 실행: Move Analysis API를 사용하여 차단 문제를
자세히 분석합니다.
- 정책 영향 평가: 이동이 상속된
조직 정책 및 ID 및 액세스 관리 (IAM) 정책에 미치는 영향을 확인합니다.
- 다운타임 계획: 전환 중에 일부 서비스가 일시적으로 중단될 수 있습니다.
자세한 내용은 마이그레이션 계획 만들기를 참조하세요.
특수한 사례 해결
프로젝트 또는 조직 수준에서 특별한 처리가 필요한 시나리오를 식별하고 준비합니다.
- 서비스 종속 항목 확인: 프로젝트가 공유 VPC, VPC 서비스 제어와 같은 서비스
에 종속되어 있는지 또는 활성 결제/구독이 있는지 검토합니다.
- 특수한 사례 목록 검토: 자세한 가이드에
나열된 각 서비스에 대한 계획이 있는지 확인합니다.
- 롤백 계획 준비: 문제가 발생할 경우 마이그레이션을 롤백하는 방법을 이해합니다.
특수한 사례의 목록과 이를 처리하는 방법은
특수한 사례 처리를 참조하세요.
ID 및 액세스 관리 역할 할당
소스 및 대상 조직 리소스 모두에서 동일한 주 구성원 이메일 주소에 필요한 IAM 역할을 할당합니다.
다음 역할이 필요합니다.
- 마이그레이션하려는 프로젝트의 프로젝트 IAM 관리자 (
roles/resourcemanager.projectIamAdmin)
- 프로젝트의 상위 리소스 (폴더 또는 조직 리소스)에 대한 프로젝트 이동자 (
roles/resourcemanager.projectMover)
- 대상이 폴더인 경우: 프로젝트 이동자
(
roles/resourcemanager.projectMover) 대상 폴더
- 대상이 조직인 경우: 대상 조직
리소스의 프로젝트 생성자
(
roles/resourcemanager.projectCreator)
- 소스 및 대상 조직 리소스 모두에 대한 조직 정책 관리자 (
roles/orgpolicy.policyAdmin)
자세한 내용은 권한 할당을 참조하세요.
조직 정책 구성
특정 조직 정책을 구성하여 조직 간 프로젝트 마이그레이션을 사용 설정합니다. 이러한 정책이 없으면 마이그레이션이 실패합니다.
- 소스 정책 구성: 대상에 내보내기를 허용하도록
상위 리소스에
constraints/resourcemanager.allowedExportDestinations 제약조건을 설정합니다.
- 대상 정책 구성: 소스에서 가져오기를 허용하도록
대상 리소스에
constraints/resourcemanager.allowedImportSources 제약조건을 설정합니다.
자세한 내용은
조직 정책 구성을 참조하세요.
마이그레이션 수행
Google Cloud 콘솔, Google Cloud CLI 또는
Resource Manager API를 사용하여 마이그레이션을 실행합니다.
- 마이그레이션 실행:
gcloud beta projects move 명령어 또는 Cloud
Console을 사용하여 이동을 수행합니다.
- 마이그레이션 확인: 프로젝트가 새 대상에 표시되는지 확인하고
리소스 액세스를 확인합니다.
- 이전 후 태스크 수행: 상속된 정책을 확인하고 액세스를 감사하며
필요에 따라 결제 계정을 업데이트합니다.
- 정리: 임시 IAM 역할을 취소하고 임시
조직 정책 제약조건을 삭제합니다.
단계별 안내는 마이그레이션 수행을 참조하세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2026-08-19(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2026-08-19(UTC)"],[],[]]