Évaluer et migrer Cloud Foundry

Ce document explique comment évaluer votre fondation Cloud Foundry (CF) existante, et comment migrer une fondation, une organisation, un espace ou une application CF vers Kf.

Évaluation de l'adéquation pour la migration

Utilisez la commande kf migrate scan-cf-cluster pour générer un rapport contenant une évaluation de l'aptitude à la migration d'une fondation CF. Vous pouvez formater le rapport sous la forme d'une feuille de calcul (recommandé) ou d'un fichier texte.

Prérequis

  • La CLI Kf. Consultez la section Installer la CLI Kf pour obtenir des instructions d'installation.
  • La CLI cf installée en tant que cf.
  • La CLI cf doit se trouver sur le chemin d'accès.
  • La CLI cf doit être authentifiée et bénéficier de droits d'administrateur en lecture seule ou de privilèges supérieurs sur la fondation CF.

Effectuer une évaluation

  1. Validez la fondation à cibler.

    cf curl /v2/info

  2. Exécutez la commande pour générer une feuille de calcul contenant le rapport d'évaluation.

    kf migrate scan-cf-cluster report.xlsx

  3. Vérifiez l'évaluation.

    Si vous prévoyez de partager l'évaluation, vous pouvez masquer les informations que vous ne souhaitez pas partager.

Migration

Pour migrer des entités à partir de CF, procédez comme suit :

  1. Créez un plan de migration qui décrit la migration.

  2. Modifiez le plan de migration pour personnaliser votre migration.

  3. Appliquez le plan de migration pour effectuer la migration.

Les sections suivantes décrivent ces étapes plus en détail.

Champs d'application de la migration

La première décision à prendre avant d'effectuer une migration consiste à choisir son champ d'application. Le champ d'application détermine l'entité CF que vous souhaitez migrer et les droits nécessaires pour effectuer la migration :

  • Intégralité de la fondation ou de l'organisation : vous devez disposer des droits d'administrateur en lecture seule ou supérieurs sur la fondation CF.

  • Espace ou application uniques : vous devez disposer des droits de développeur de l'espace ou supérieurs.

Prérequis

Pour effectuer une migration, vous avez besoin des éléments suivants :

  • Pour créer le plan de migration : la CLI Kf. Consultez la section Installer la CLI Kf pour obtenir des instructions d'installation.
  • Pour appliquer le plan de migration : un cluster GKE exécutant Kf. Consultez la section Installer Kf pour obtenir des instructions d'installation.
  • L'accès à un cluster avec une installation Cloud Foundry.
  • La CLI CF qui a ciblé la fondation CF.
  • Droits sur la fondation CF requis par le champ d'application de la migration souhaité, comme indiqué ci-dessus.

Créer un plan de migration

Utilisez la commande kf migrate plan pour créer le plan de migration.

Par défaut, la commande écrit le plan de migration vers la sortie standard (stdout). Généralement, la pratique est de rediriger cette sortie vers un fichier YAML afin de pouvoir personnaliser le plan avant de l'appliquer. Par exemple, la commande suivante écrit sur la sortie standard (stdout) :

kf migrate plan

Redirigez la sortie vers un fichier yaml :

kf migrate plan > plan.yaml

Lorsque vous exécutez la commande kf migrate plan, vous devriez voir une sortie dans la fenêtre de commande du formulaire ci-dessous, qui regroupe les étapes effectuées par la commande, ainsi que les problèmes liés aux 'avertissements ou à la migration :

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
    ...

Générer un plan de migration

  1. Assurez-vous de vous être connecté à votre fondation CF à l'aide de la CLI CF.

  2. Effectuez la migration en fonction du champ d'application de la migration souhaité, où :

    • MY_ORG spécifie le nom de l'organisation.
    • MY_SPACE spécifie le nom de l'espace.
    • MY_APP spécifie le nom de l'application.

    1. Générez un plan de migration pour l'ensemble de la fondation CF.

      kf migrate plan > plan.yaml

    2. Générez un plan de migration pour une organisation.

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

    3. Générez un plan de migration pour un espace.

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

    4. Générez un plan de migration pour une application.

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

Si l'erreur suivante s'affiche après l'exécution de l'une de ces commandes :

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

Vous ne disposez pas des droits nécessaires pour lire les points de terminaison nécessaires de l'API Cloud Controller (CAPI).

Modifier le plan de migration

Vous pouvez également examiner et modifier le plan de migration généré pour résoudre les erreurs.

Appliquer le plan de migration

Utilisez la commande kf migrate apply pour appliquer le plan de migration et migrer l'entité CF :

  1. Assurez-vous d'avoir défini .kubeconfig pour cibler votre cluster Kf.

  2. Vérifiez que vous avez accès à un cluster GKE exécutant une installation de Kf complète. Cela signifie que vous avez exécuté la commande suivante pour vous connecter au cluster :

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

  3. Assurez-vous qu'aucun nom d'espace existant sur votre cluster Kf n'entrera en conflit avec un espace référencé dans le plan de migration.

    Les noms d'espace s'affichent au format cf-org - cf-space. Par exemple, si le nom de l'organisation est myorg et que le nom de l'espace est myspace, l'espace Kf sera myorg-myspace.

  4. Appliquez le plan de migration.

    kf migrate apply -v --plan plan.yaml

    L'option détaillée -v est recommandée, mais pas obligatoire. Cette option force la commande à indiquer dans sa sortie les commandes Kf utilisées pour effectuer la migration.