Analise os arquivos de implantação gerados

Depois de concluir a migração de uma carga de trabalho usando um cluster de processamento, faça o download dos arquivos YAML que foram gerados como parte da migração.

Esses arquivos, chamados de artefatos de migração, foram gerados para que você possa implantar o contêiner de carga de trabalho migrado em outro cluster, como um cluster de teste ou de produção.

Neste tópico, descrevemos como fazer o download dos arquivos de artefato gerados e analisá-los para uso próprio em outro cluster.

Antes de começar

Sobre os arquivos de artefato gerados

Os arquivos de artefato gerados durante a migração incluem:

  • deployment_spec.yaml -- o arquivo YAML que configura a carga de trabalho.

    É possível usar kubectl apply com esse arquivo para implantar a carga de trabalho em outro cluster, como um cluster de produção ou de teste.

  • Dockerfile: o Dockerfile usado para criar a imagem da VM migrada.

  • blocklist.yaml: a lista de serviços de contêiner a serem desativados com base nas configurações no plano de migração. Edite esse arquivo para controlar a lista de serviços. Consulte Como personalizar a lista de serviços.

  • migration.yaml -- uma cópia do plano de migração.

    É possível usar isso para verificar o que foi feito como parte da migração.

  • logs.yaml: uma lista de arquivos de registros detectados na VM de origem. Os dados gravados nesses arquivos de registro pela carga de trabalho migrada são encaminhados para o Cloud Logging. Edite este arquivo para controlar a gravação de registros. Consulte Como personalizar dados de registro gravados no Cloud Logging.

Esses arquivos são descritos com mais detalhes abaixo.

Fazer o download de todos os arquivos de artefato

migctl

Ao concluir a migração e solicitar o status, você verá uma mensagem como a seguinte:

migctl migration status my-migration

NAME            CURRENT-OPERATION       PROGRESS        STEP            STATUS    AGE
my-migration    GenerateArtifacts       [1/1]           ExtractImage    Completed 14m23s

Quando a migração estiver concluída, faça o download de todos os arquivos de artefato gerados com migctl migration get-artifacts.

migctl migration get-artifacts my-migration

Console

Quando a migração for concluída, você verá a mensagem Artefatos gerados na coluna Status da migração. Para fazer o download de todos os artefatos de migração:

  1. Abra a página "Migrate to Containers" no Console do Google Cloud.

    Acessar a página "Migrate to Containers"

  2. Clique na guia Migrações para exibir uma tabela com as migrações disponíveis.

  3. Clique no Nome da migração na linha para a migração pretendida. A guia Detalhes da migração será aberta.

  4. Selecione a guia Artefatos.

  5. Selecione Arquivo do Docker, especificação de implantação e outros artefatos para abrir o bucket do Cloud Storage que contém os artefatos.

  6. Selecione todos os arquivos e clique em Fazer o download.

CRD

Quando a migração for concluída, faça o download de todos os artefatos de migração:

  1. Consiga o bucket do Cloud Storage que contém os artefatos:

    kubectl get migrations.anthos-migrate.cloud.google.com -n v2k-system my-migration -o jsonpath={.status.artifacts.deploymentFiles.bucket}

    Este comando retorna o nome do bucket no formato:

    bucket-migration-artifacts

  2. Consiga o arquivo YAML de manifestos de migração do Cloud Storage:

    kubectl get migrations.anthos-migrate.cloud.google.com -n v2k-system my-migration -o jsonpath={.status.artifacts.deploymentFiles.artifactsManifestFile}

    Esse comando retorna o nome do arquivo YAML do manifesto no formato:

    bucket-migration-artifacts/v2k-system-my-migration/ID/manifest.yaml

  3. Acesse o Cloud Storage no Console do Google Cloud e busque o arquivo de manifesto. O arquivo de manifesto de exemplo abaixo inclui os URLs de artifacts:

    artifacts:
 - https:/storage.cloud.google.com/bucket-name/v2k-system-my-migration/ID/deployment_spec.yaml
 - https:/storage.cloud.google.com/bucket-name/v2k-system-my-migration/ID/Dockerfile
 - https:/storage.cloud.google.com/bucket-name/v2k-system-my-migration/ID/migration.yaml
imageUrl: gcr.io/velos-auto-1/matanvm:v1.0.0
name: m1-84xqp
namespace: v2k-system
uid: daf762-d9-42-bfc-47b71255a
version: "1.0"

  4. Abra os URLs artifacts em um navegador para fazer o download dos artefatos.

deployment_spec.yaml

Este é um arquivo YAML que pode ser usado para implantar a carga de trabalho em outro cluster, como um cluster de teste ou de produção. Se você não configurar uma migração de dados, gerará um objeto de implantação. Quando a migração de dados é configurada, gera um objeto de conjunto com estado.

Dockerfile

O Dockerfile usado para criar a imagem da VM migrada.

Use esse arquivo se você precisar gerar uma nova versão da imagem. Por exemplo, se quiser instalar um pacote e capturar uma nova imagem posteriormente. A recriação da imagem também pode ser útil quando o Migrate to Containers for atualizado (por exemplo, com uma correção de bug) e você quiser recriar a imagem com o novo ambiente de execução do Migrate to Containers. O ambiente de execução atualizado está disponível no Container Registry.

É possível editar esse arquivo como qualquer outro Dockerfile para personalizar sua imagem. Para dicas, consulte Práticas recomendadas para gravar Dockerfiles (em inglês). Além disso, consulte Atualizações de imagem pós-migração para informações sobre como editar o Dockerfile.

# Please refer to the documentation:
# https://cloud.google.com/migrate/containers/docs/dockerfile-reference

FROM gcr.io/my-project/v2k-run-embedded:v1.12.0

# Image containing data captured from the source VM
FROM gcr.io/my-project/my-vm-instance-1-non-runnable-base:v1.0.0 as source-content

COPY --from=migrate-for-anthos-runtime / /

ADD blocklist.yaml /.m4a/blocklist.yaml

ADD logs.yaml /code/config/logs/logsArtifact.yaml

# If you want to update parts of the image, add your commands here.
# For example:
# RUN apt-get update
# RUN apt-get install -y \
#       package1=version \
#       package2=version \
#       package3=version
# RUN yum update
# RUN wget http://github.com

# Migrate to Containers image includes entrypoint
ENTRYPOINT [ "/.v2k.go" ]

migration.yaml

Este arquivo é uma cópia da migração que você criou. Use esse arquivo para verificar se os detalhes da migração que o Migrate to Containers está usando correspondem aos especificados no plano de migração.

Não use esse arquivo para executar novamente a migração. Depois de executar a migração, só será possível executá-la novamente depois de excluir a migração usando migctl migration delete ou o Console do Google Cloud e executá-la novamente no plano de migração.

blocklist.yaml

Esse arquivo lista os serviços de contêiner a serem desativados com base nas configurações no plano de migração. Consulte Como personalizar a lista de serviços para mais informações sobre como usar esse arquivo.

A seguir