Valutazione e migrazione

Questo documento descrive come eseguire una valutazione della tua Cloud Foundry (CF) Foundation esistente e come eseguire la migrazione di Foundation, Organization, Space o App a Kf.

Valutazione dell'idoneità alla migrazione

Utilizza il comando kf migrate scan-cf-cluster per generare un report contenente una valutazione dell'idoneità alla migrazione di una Fondazione CF. Puoi formattare il report come foglio di lavoro (opzione consigliata) o file di testo.

Prerequisiti

Esegui una valutazione

  1. Convalida la Fondazione da scegliere come target.

    cf curl /v2/info

  2. Esegui il comando per generare un foglio di lavoro contenente il report di valutazione.

    kf migrate scan-cf-cluster report.xlsx

  3. Esamina la valutazione.

    Se prevedi di condividere la valutazione, puoi oscurare le informazioni che non vuoi condividere.

Migrazione

Per eseguire la migrazione delle entità da CF:

  1. Crea piano di migrazione che descriva la migrazione.

  2. Modifica il piano di migrazione per personalizzarlo.

  3. Applica il piano di migrazione per eseguire la migrazione.

Le sezioni seguenti descrivono questi passaggi in modo più dettagliato.

Ambiti di migrazione

La prima decisione da prendere quando esegui una migrazione è stabilire l'ambito della migrazione. L'ambito determina l'entità CF di cui vuoi eseguire la migrazione e i privilegi di cui hai bisogno per eseguire la migrazione:

  • Tutta la fondazione o l'intera organizzazione: devi disporre dei privilegi di amministratore di sola lettura o di un livello superiore nella Fondazione CF.

  • Singolo spazio o app: devi disporre dei privilegi di sviluppatore dello spazio o di un livello superiore.

Prerequisiti

Per eseguire una migrazione, devi disporre di:

  • Per creare il piano di migrazione: l'interfaccia a riga di comando Kf. Per le istruzioni di installazione, consulta Installare l'interfaccia a riga di comando Kf.
  • Per applicare il piano di migrazione: un cluster GKE su cui è in esecuzione Kf. Per le istruzioni di installazione, consulta Installare Kf.
  • Accedi a un cluster con un'installazione Cloud Foundry.
  • Interfaccia a riga di comando CF che ha scelto come target la Fondazione CF.
  • I privilegi su CF Foundation richiesti dall'ambito di migrazione desiderato, come mostrato sopra.

Creare un piano di migrazione

Utilizza il comando kf migrate plan per creare il piano di migrazione.

Per impostazione predefinita, il comando scrive il piano di migrazione nello standard out. In genere, reindirizzi l'output a un file yaml in modo da poter personalizzare il piano prima di applicarlo. Ad esempio, il seguente comando scrive l'output nello standard out:

kf migrate plan

Reindirizza l'output a un file yaml:

kf migrate plan > plan.yaml

Quando esegui il comando kf migrate plan, dovresti visualizzare l'output nella finestra dei comandi nel seguente formato, che elenca i passaggi eseguiti dal comando e eventuali avvisi o problemi di migrazione:

kf migrate plan > plan.yaml

    Checking CF CLI is available
    Checking CF CLI is authenticated
    ...

    WARNING: plan has issues
    Issues with domain "apps.internal" in space "kf-team-acceptance":
        E04 - internal domains are not supported

    Issues with application "spring-music" in space "kf-team-app":
        E14 - app manifest must have a single process

    Issues with service instance "logspinner-1" in space "kf-team-app":
        E10 - syslog drain configuration is not supported
    ...

Per generare un piano di migrazione:

  1. Assicurati di aver eseguito l'accesso a CF Foundation utilizzando la CLI CF.

  2. Esegui la migrazione in base all'ambito desiderato, dove:

    • MY_ORG specifica il nome dell'organizzazione.
    • MY_SPACE specifica il nome dello spazio.
    • MY_APP specifica il nome dell'app.

    1. Genera un piano di migrazione per un'intera base di dati CF.

      kf migrate plan > plan.yaml

    2. Genera un piano di migrazione per un'organizzazione.

      kf migrate plan --cf-org MY_ORG > plan.yaml

    3. Generare un piano di migrazione per uno spazio

      kf migrate plan --cf-org MY_ORG --cf-space MY_SPACE > plan.yaml

    4. Genera un piano di migrazione per un'app.

      kf migrate plan --cf-org MY_ORG --cf-space MY_SPACE --cf-app MY_APP > plan.yaml

Se dopo aver eseguito uno di questi comandi viene visualizzato il seguente errore:

You are not authorized to perform the requested action CF-NotAuthorized 10003

Non disponi dei privilegi necessari per leggere gli endpoint CAPI necessari.

Modificare il piano di migrazione

Rivedi e, se opportuno, modifica il piano di migrazione generato per risolvere eventuali errori.

Applica il piano di migrazione

Utilizza il comando kf migrate apply per applicare il piano di migrazione ed eseguire la migrazione dell'entità CF.

Per applicare una migrazione:

  1. Assicurati di aver impostato .kubeconfig come target per il cluster Kf.

  2. Assicurati di avere accesso a un cluster GKE in cui è in esecuzione un'installazione completa di Kf. Ciò significa che hai eseguito il seguente comando per connetterti al cluster:

    gcloud container clusters get-credentials CLUSTER_NAME \
   --project=CLUSTER_PROJECT_ID \
   --zone=CLUSTER_LOCATION

  3. Assicurati che nel cluster Kf non esistano nomi di spazi che entrino in conflitto con uno spazio a cui viene fatto riferimento nel piano di migrazione.

    I nomi degli spazi sono del tipo cf-org-cf-space. Ad esempio, se il nome dell'organizzazione è myorg e il nome dello spazio è myspace, lo spazio Kf sarà myorg-myspace.

  4. Applica il piano di migrazione.

    kf migrate apply -v --plan plan.yaml

    Il flag -v dettagliato è consigliato, ma non obbligatorio. Questo flag fa in modo che il comando stampi i comandi Kf utilizzati per eseguire la migrazione.