Avalie e migre o Cloud Foundry

Este documento descreve como realizar uma avaliação da sua Foundation do Cloud Foundry (CF) existente e como migrar a Foundation, a organização, o espaço ou a app do CF para o Kf.

Avaliação da adequação da migração

Use o comando kf migrate scan-cf-cluster para gerar um relatório que contenha uma avaliação da disponibilidade para migração de uma CF Foundation. Pode formatar o relatório como uma folha de cálculo (recomendado) ou um ficheiro de texto.

Pré-requisitos

Realize uma avaliação

  1. Valide a fundação a segmentar.

    cf curl /v2/info

  2. Execute o comando para gerar uma folha de cálculo com o relatório de avaliação.

    kf migrate scan-cf-cluster report.xlsx

  3. Reveja a avaliação.

    Se planeia partilhar a avaliação, pode ocultar quaisquer informações que não queira partilhar.

Migração

Siga os passos abaixo para migrar entidades do CF:

  1. Crie um plano de migração que descreva a migração.

  2. Edite o plano de migração para personalizar a migração.

  3. Aplique o plano de migração para realizar a migração.

As secções seguintes descrevem estes passos mais detalhadamente.

Âmbitos da migração

A primeira decisão que tem de tomar quando faz uma migração é decidir o âmbito da migração. O âmbito determina a entidade do CF que quer migrar e os privilégios de que precisa para realizar a migração:

Pré-requisitos

Para fazer uma migração, precisa do seguinte:

  • Para criar o plano de migração: a CLI Kf. Consulte o artigo Instale a CLI Kf para ver as instruções de instalação.
  • Para aplicar o plano de migração: um cluster do GKE que execute o Kf. Consulte o artigo Instale o Kf para ver as instruções de instalação.
  • Acesso a um cluster com uma instalação do Cloud Foundry.
  • CF CLI que tenha segmentado a CF Foundation.
  • Os privilégios na CF Foundation necessários para o âmbito de migração pretendido, conforme mostrado acima.

Crie um plano de migração

Use o comando kf migrate plan para criar o plano de migração.

Por predefinição, o comando escreve o plano de migração para a saída padrão. Normalmente, redireciona a saída para um ficheiro YAML para poder personalizar o plano antes de o aplicar. Por exemplo, o seguinte comando escreve a saída para a saída padrão:

kf migrate plan

Redirecione a saída para um ficheiro YAML:

kf migrate plan > plan.yaml

Quando executar o comando kf migrate plan, deve ver o resultado na janela de comandos no formato abaixo, com os passos executados pelo comando e quaisquer problemas de migração ou avisos:

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

Gere um plano de migração

  1. Certifique-se de que iniciou sessão na CF Foundation através da CF CLI.

  2. Faça a migração com base no âmbito de migração pretendido, em que:

    • MY_ORG especifica o nome da organização.
    • MY_SPACE especifica o nome do espaço.
    • MY_APP especifica o nome da app.

    1. Gere um plano de migração para uma CF Foundation completa.

      kf migrate plan > plan.yaml

    2. Gere um plano de migração para uma organização.

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

    3. Gere um plano de migração para um espaço

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

    4. Gere um plano de migração para uma app.

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

Se vir o seguinte erro após executar qualquer um destes comandos:

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

Não tem os privilégios necessários para ler os endpoints da API CAPI necessários.

Edite o plano de migração

Reveja e, opcionalmente, modifique o plano de migração gerado para resolver quaisquer erros.

Aplique o plano de migração

Use o comando kf migrate apply para aplicar o plano de migração e migrar a entidade CF:

  1. Certifique-se de que definiu .kubeconfig para segmentar o seu cluster Kf.

  2. Certifique-se de que tem acesso a um cluster do GKE que executa uma instalação completa do Kf. Isto significa que executou o seguinte comando para se ligar ao cluster:

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

  3. Certifique-se de que não existem nomes de espaços no seu cluster do Kf que entrem em conflito com um espaço referenciado no plano de migração.

    Os nomes dos espaços têm o formato cf-org-cf-space. Por exemplo, se o nome da organização for myorg e o nome do espaço for myspace, o espaço do Kf será myorg-myspace.

  4. Aplique o plano de migração.

    kf migrate apply -v --plan plan.yaml

    A flag detalhada -v é recomendada, mas não é obrigatória. Esta flag faz com que o comando apresente os comandos Kf usados para realizar a migração.