Importa dati da altri cloud provider

Il Centro di migrazione consente di importare i dati su prestazioni e utilizzo dall'infrastruttura in hosting su altri cloud provider, come Amazon Web Services (AWS) e Azure.

Per importare i dati da altri cloud provider, segui questi passaggi:

  1. Scarica lo script di raccolta.
  2. Esegui lo script nell'infrastruttura cloud e genera le tabelle di output.
  3. Carica le tabelle di output nel Centro di migrazione.

Best practice per eseguire lo script di raccolta

Quando esegui lo script di raccolta, considera quanto segue:

  • Esegui lo script di raccolta utilizzando un'istanza di AWS CloudShell (per la raccolta dei dati da AWS) o Azure Cloud Shell (per la raccolta dei dati da Azure). L'utilizzo di queste shell evita la necessità di generare, distribuire e mantenere le chiavi di autenticazione per eseguire lo script di raccolta in altri ambienti di runtime.
  • Esegui lo script di raccolta impersonando un account che dispone di autorizzazioni di sola lettura minime. L'uso di autorizzazioni di sola lettura evita modifiche accidentali alle risorse AWS o Azure.
  • Gli script sono open source, quindi se la tua organizzazione ha requisiti normativi specifici, esamina il codice per capire esattamente quale tipo di dati viene raccolto.

Limitazioni

  • La dimensione massima per il caricamento di un file è 100 MB.

Scaricare lo script

Per scaricare gli script, seleziona uno dei seguenti link, a seconda del tuo cloud provider:

Esegui lo script

Per eseguire lo script, segui le istruzioni nel file README del repository. Lo script genera un file ZIP con le tabelle dei dati raccolti. Estrai i file dal file ZIP.

Carica i risultati dello script di raccolta

Per caricare i file:

Console

  1. Vai alla pagina Importazione dati.

    Vai a Importazione dati

  2. Fai clic su Aggiungi dati. Si apre una nuova pagina.

  3. Seleziona Carica file e poi, in Imposta il caricamento di file, inserisci il nome del file caricato.

  4. Dall'elenco, seleziona Esportazioni AWS o Esportazioni di Azure.

  5. Fai clic su Seleziona i file da caricare, quindi seleziona tutti i file che vuoi caricare.

  6. Per confermare e iniziare il caricamento dei file, fai clic su Carica file.

  7. Se i file vengono convalidati correttamente, per creare gli asset a partire dai file, fai clic su Importa dati e poi su Conferma.

API

  1. Crea un job di importazione.

    POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs?importJobId=IMPORT_JOB_ID

{
  "asset_source": "projects/PROJECT_ID/locations/REGION/sources/SOURCE_ID"
}

    Sostituisci quanto segue:

    • PROJECT_ID: ID del progetto per creare il job di importazione.
    • REGION: regione in cui creare il job di importazione.
    • IMPORT_JOB_ID: ID del nuovo job di importazione.
    • SOURCE_ID: ID di un'origine esistente da associare al job di importazione.

  2. (Facoltativo) Per confermare che il job di importazione sia stato creato correttamente, scarica il job di importazione.

    GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID

  3. Crea un file di dati di importazione allegato al job di importazione.

    POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID/importDataFiles?import_data_file_id=DATA_FILE_ID

{
  "format": "IMPORT_JOB_FORMAT"
}

    Sostituisci quanto segue:

    • DATA_FILE_ID: ID del nuovo file di dati
    • IMPORT_JOB_FORMAT: IMPORT_JOB_FORMAT_EXPORTED_AWS_CSV o IMPORT_JOB_FORMAT_EXPORTED_AZURE_CSV

  4. Recupera il file di dati.

    GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID/importDataFiles/DATA_FILE_ID

  5. Copia l'URL dal campo signedUrl dalla risposta.

  6. Carica un file nell'URL copiato.

    PUT -H 'Content-Type: application/octet-stream' --upload-file UPLOAD_FILE_PATH 'COPIED_URL'

    Sostituisci quanto segue:

    • UPLOAD_FILE_PATH: il percorso locale del file caricato.
    • COPIED_URL: l'URL firmato copiato dai passaggi di anteprima.

  7. (Facoltativo) Ripeti i passaggi 3-6 per creare altri file di dati nello stesso job di importazione.

  8. (Facoltativo) Recupera tutti i file di dati di un job di importazione.

    GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID/importDataFiles

  9. Convalida il job di importazione.

    POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID:validate

  10. Recupera il job di importazione e visualizza il report di convalida. Se lo stato è READY, è possibile continuare con i passaggi successivi. In caso contrario, devi correggere il job o file specifici, ciò potrebbe richiedere l'eliminazione di file o il caricamento di nuovi file.

    GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID

  11. Esegui il job di importazione.

    POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID:run

  12. Scarica il job di importazione e visualizza il report di esecuzione. Se lo stato è COMPLETED, il job è stato eseguito correttamente. Altrimenti, se il job non è riuscito e in stato di terminale, il report di esecuzione include gli errori. Crea un nuovo job di importazione e applica le modifiche necessarie.

    GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID

In caso di problemi con il caricamento di file, scopri come risolvere i messaggi di errore più comuni.

Rivedi il caricamento

Dopo aver caricato i file, il Centro di migrazione li convalida per verificare se sono formalmente corretti. Se la convalida ha esito positivo, il Centro di migrazione elabora i dati per creare nuovi asset o aggiornare quelli esistenti. Puoi controllare lo stato dei job di caricamento dalla console Google Cloud.

Per esaminare lo stato del processo di caricamento:

  1. Vai alla pagina Importazione dati e fai clic su Caricamenti di file.
  2. Nell'elenco delle importazioni di file, seleziona il caricamento che vuoi esaminare.
  3. Nella pagina di caricamento del file, in Avanzamento importazione dati, controlla lo Stato dei file caricati.

Puoi visualizzare i file in uno dei seguenti stati.

Elenco di stati

  • Completato. L'importazione del file è riuscita.
  • Pronti. Il file ha superato la convalida ed è pronto per essere importato.
  • In attesa. Il tuo file è in attesa del completamento dell'elaborazione di un altro file.
  • In esecuzione. Il file è in fase di elaborazione.
  • Convalida. Il file è in fase di convalida.
  • Convalida non riuscita. Il file contiene alcuni errori. Correggi gli errori, quindi prova a caricare nuovamente il file.
  • Non riuscita. Impossibile importare il file.

Esamina i dettagli dell'errore

Se si verificano errori dopo l'importazione dei file, puoi esaminare il messaggio di errore direttamente nella console Google Cloud.

Per esaminare gli errori del job di caricamento:

  1. Vai alla pagina Importazione dati e fai clic su Caricamenti di file.
  2. Fai clic sul file di importazione che mostra un avviso o un errore. La pagina dei dettagli del file di importazione mostra l'elenco completo degli errori.

Nella pagina dei dettagli del file di importazione, puoi esaminare gli asset e i campi di dati che causano gli errori, nonché visualizzare una descrizione dell'errore. Gli errori nel job di importazione file potrebbero impedire al Centro di migrazione di creare nuovi asset o aggiornare quelli esistenti con le nuove modifiche. Per correggere l'errore, modifica i file e crea un nuovo job di importazione file per caricarli di nuovo.

Per ulteriori informazioni sui possibili messaggi di errore, consulta Risolvere gli errori di importazione dei file.

Passaggi successivi