Valutazione e migrazione di Cloud Foundry

Questo documento descrive come eseguire una valutazione dei tuoi Cloud Foundry (CF) Foundation e come migrare la CF Foundation Organization (Organizzazione, Spazio) o App to Kf.

Valutazione dell'idoneità alla migrazione

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

Nota: il report non contiene tutte le informazioni recuperate dall'API CF. Si rivolge invece a dati specifici che possono essere utilizzati per stimare la portabilità a Kubernetes.

Prerequisiti

• L'interfaccia a riga di comando Kf. Vedi Installare l'interfaccia a riga di comando Kf per istruzioni sull'installazione.
• L'interfaccia a riga di comando cf configurata come cf.
• L'interfaccia a riga di comando cf deve essere sul tuo percorso.
• L'interfaccia a riga di comando cf deve essere autenticata con privilegi di sola lettura amministratore o superiore su CF Foundation.

Eseguire una valutazione

1. Convalida gli elementi di base da scegliere come target.

   cf curl /v2/info

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

   Nota: la valutazione viene eseguita localmente sulla tua workstation utilizzando l'interfaccia a riga di comando Kf e nessun dato viene inviato a Google.

   kf migrate scan-cf-cluster report.xlsx

3. Rivedi 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, segui questi passaggi:

1. Crea un piano di migrazione che descriva la migrazione.

2. Modifica il piano di migrazione per personalizzare la migrazione.

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

Questi passaggi sono descritti nelle sezioni seguenti in modo più dettagliato.

Ambiti di migrazione

La prima decisione che prendi quando esegui una migrazione è decidere l'ambito della migrazione. L'ambito determina l'entità CF di cui eseguire la migrazione e i privilegi devi eseguire la migrazione:

• Tutta la fondazione o l'organizzazione: devi disporre di privilegi di sola lettura amministratore o superiori in CF Foundation.

• Spazio singolo o app: devi disporre almeno dei privilegi di sviluppatore per lo spazio.

  Nota: se hai ambiti scim.read e cloud_controller.admin_read_only, puoi anche eseguire query su tutte le app in tutti gli spazi di un'organizzazione.

Prerequisiti

Per eseguire una migrazione, devi disporre di:

• Per creare il piano di migrazione: l'interfaccia a riga di comando Kf. Vedi Installare l'interfaccia a riga di comando Kf per istruzioni sull'installazione.
• Per applicare il piano di migrazione: un cluster GKE che esegue Kf. Per le istruzioni sull'installazione, consulta la sezione Installare Kf.
• Accesso a un cluster con un'installazione Cloud Foundry.
• L'interfaccia a riga di comando CF che ha preso di mira CF Foundation.
• 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 su Standard. In genere reindirizzi l'output in un file YAML in modo da poter personalizzare il piano prima di applicarlo. Ad esempio, il seguente comando scrive l'output in uscita standard:

kf migrate plan

Reindirizza l'output a un file YAML:

kf migrate plan > plan.yaml

Quando esegui il comando kf migrate plan, dovresti vedere l'output nella finestra dei comandi nel modulo che segue, in cui sono elencati i passaggi eseguiti dal comando ed 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
    ...

Genera un piano di migrazione

1. Assicurati di aver eseguito l'accesso alla tua piattaforma CF tramite l'interfaccia a riga di comando 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 CF Foundation.

      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. Generare 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 visualizzi il seguente errore dopo aver eseguito uno di questi comandi:

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

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

Modifica il piano di migrazione

Esamina e, facoltativamente, 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 Entità CF:

1. Assicurati di aver impostato .kubeconfig come target del cluster Kf.

2. Assicurati di avere accesso a un cluster GKE che esegue un Installazione Kf. Ciò significa che hai eseguito per connetterti al cluster:

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

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

   I nomi degli spazi sono nel formato cf-org-cf-space. Ad esempio: Se il nome dell'organizzazione è myorg e il nome dello spazio è myspace, la Lo spazio kf sarà myorg-myspace.

4. Applica il piano di migrazione.

   kf migrate apply -v --plan plan.yaml

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

   Nota: potresti visualizzare errori nel passaggio di applicazione. Ad esempio: E04 - internal domains are not supported. In alcune situazioni, puoi ignorare questi errori specificando il flag --allow-issues. In alternativa, puoi modificare il piano di migrazione in modo da risolvere l'errore.