Elenco di controllo per la migrazione dei progetti

Questo elenco di controllo ti aiuterà a eseguire la migrazione dei progetti tra le risorse dell'organizzazione. L'elenco di controllo di seguito contiene un elenco delle attività principali necessarie per eseguire la migrazione di un progetto tra le risorse dell'organizzazione, brevi istruzioni per ogni passaggio e un link per ulteriori informazioni.

Devi considerare l'impatto della migrazione sui servizi in esecuzione all'interno del progetto. Le modifiche alla gerarchia delle risorse causate dalla migrazione di un progetto possono portare a modifiche ai criteri ereditati, come i criteri dell'organizzazione e quelli di gestione di identità e accessi.

Crea un piano per assicurarti che eventuali impatti potenziali vengano mitigati durante la migrazione del progetto. Per definire il tuo piano, utilizza l'API Move Analysis per ottenere un'analisi dettagliata degli elementi che bloccano la migrazione del progetto.

Per ulteriori informazioni, consulta Creare un piano di migrazione.

Per eseguire la migrazione di un progetto tra le risorse dell'organizzazione, è necessario un determinato insieme di ruoli IAM. Inoltre, devi disporre dell'autorizzazione per creare e gestire i criteri dell'organizzazione.

Puoi ottenere queste autorizzazioni acquisendo i seguenti ruoli:

  • Project Mover (roles/resourcemanager.projectMover) nel progetto di cui vuoi eseguire la migrazione e nella relativa risorsa principale.

  • Autore progetto (roles/resourcemanager.projectCreator) nella cartella o nella risorsa dell'organizzazione di destinazione.

  • Amministratore criteri organizzazione (roles/orgpolicy.policyAdmin) sia sulle risorse dell'organizzazione di origine sia su quelle di destinazione.

Per maggiori dettagli sui ruoli e sulle autorizzazioni di cui hai bisogno, consulta Assegnare autorizzazioni.

Per eseguire la migrazione di un progetto tra le risorse dell'organizzazione, devi impostare i seguenti criteri dell'organizzazione:

  • Imposta il vincolo constraints/resourcemanager.allowedExportDestinations sulla risorsa principale del progetto di cui vuoi eseguire la migrazione. Questo vincolo definisce le risorse dell'organizzazione a cui è possibile eseguire la migrazione del progetto.

  • Imposta il vincolo constraints/resourcemanager.allowedImportSources sulla risorsa di destinazione. Questo vincolo definisce le risorse dell'organizzazione da cui è possibile importare i progetti.

Se uno di questi vincoli non è impostato correttamente, la migrazione non andrà a buon fine con un errore FAILED_PRECONDITION.

Per configurare i criteri dell'organizzazione necessari per la migrazione del progetto, devi disporre del ruolo roles/orgPolicy.policyAdmin nell'organizzazione principale e di destinazione.

Per ulteriori informazioni su questi vincoli delle policy dell'organizzazione, consulta Configurare le policy dell'organizzazione.

Quando esegui la migrazione di un progetto tra le risorse dell'organizzazione, è possibile che tu debba gestire determinati scenari a livello di progetto e di risorsa dell'organizzazione. Potrebbero essere coinvolti servizi che devi prendere in considerazione nell'ambito del tuo piano di migrazione. Devi considerare questi casi se hai bisogno dei servizi coinvolti per il funzionamento del tuo progetto.

Per un elenco dei casi speciali e su come gestirli, consulta Gestire i casi speciali.

Una volta completati i passaggi precedenti, puoi utilizzare l'API Resource Manager per eseguire la migrazione di un progetto. Puoi utilizzare il comando gcloud beta projects move Google Cloud CLI o il metodo projects.update() dell'API REST per eseguire la migrazione.

Per maggiori dettagli sulla migrazione del progetto, consulta Eseguire la migrazione.