Questo documento descrive come eseguire una valutazione della tua piattaforma Cloud Foundry (CF) esistente e come eseguire la migrazione di CF Foundation, Organization, Space o App in Kf.
Valutazione di idoneità della migrazione
Utilizza il comando kf migrate scan-cf-cluster
per generare un report contenente una valutazione dell'idoneità alla migrazione di una base CF.
Puoi formattare il report come foglio di lavoro (consigliato) o file di testo.
Prerequisiti
- L'interfaccia a riga di comando Kf. Per le istruzioni di installazione, consulta Installare l'interfaccia a riga di comando Kf.
- L'interfaccia a riga di comando
cf
è stata installata comecf
. - L'interfaccia a riga di comando
cf
deve essere presente nel 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
Convalida la base da scegliere come target.
cf curl /v2/info
Esegui il comando per generare un foglio di lavoro contenente il report di valutazione.
kf migrate scan-cf-cluster report.xlsx
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:
Crea un piano di migrazione che descriva la migrazione.
Modifica il piano di migrazione per personalizzare la migrazione.
Applica il piano di migrazione per eseguire la migrazione.
Questi passaggi vengono descritti in modo più dettagliato nelle sezioni seguenti.
Ambiti di migrazione
La prima decisione quando esegui una migrazione è decidere l'ambito della migrazione. L'ambito determina l'entità CF di cui vuoi eseguire la migrazione e i privilegi necessari per eseguirla:
Intera organizzazione o fondazione: devi disporre almeno dei privilegi amministrativi di sola lettura di CF Foundation.
App o Spazio singolo: devi disporre almeno dei privilegi di sviluppatore per lo spazio.
Prerequisiti
Per eseguire una migrazione, sono necessari:
- 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 che esegue Kf. Consulta Installazione di Kf per le istruzioni di installazione.
- Accesso a un cluster con un'installazione di Cloud Foundry.
- Interfaccia a riga di comando CF che ha come target 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 nel formato standard. In genere l'output viene reindirizzato a un file YAML in modo da poter personalizzare il piano prima di applicarlo. Ad esempio, il seguente comando scrive l'output nel formato 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 di comando del seguente modulo, 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
Assicurati di aver eseguito l'accesso a CF Foundation utilizzando l'interfaccia a riga di comando CF.
Esegui la migrazione in base all'ambito di migrazione desiderato, dove:
- MY_ORG specifica il nome dell'organizzazione.
- MY_SPACE specifica il nome dello spazio.
- MY_APP specifica il nome dell'app.
Genera un piano di migrazione per un'intera fondazione CF.
kf migrate plan > plan.yaml
Generare un piano di migrazione per un'organizzazione.
kf migrate plan --cf-org MY_ORG > plan.yaml
Genera un piano di migrazione per uno spazio
kf migrate plan --cf-org MY_ORG --cf-space MY_SPACE > plan.yaml
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 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.
Modifica il piano di migrazione
Rivedi e, se vuoi, modifica il piano di migrazione generato per risolvere eventuali errori.
Applicare il piano di migrazione
Utilizza il comando kf migrate apply
per applicare il piano di migrazione ed eseguire la migrazione dell'entità CF:
Assicurati di aver impostato
.kubeconfig
in modo da scegliere come target il cluster Kf.Assicurati di avere accesso a un cluster GKE che esegue un'installazione Kf completa. Ciò significa che devi eseguire il seguente comando per connetterti al cluster:
gcloud container clusters get-credentials CLUSTER_NAME \ --project=CLUSTER_PROJECT_ID \ --zone=CLUSTER_LOCATION
Assicurati che nel cluster Kf non esistano nomi di spazio che entreranno in collisione 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 quello dello spazio èmyspace
, lo spazio Kf saràmyorg-myspace
.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 restituisca i comandi Kf usati per la migrazione.