Partilhar via

Migrar uma instância de Gerenciamento de API não injetada por VNet para a plataforma de computação stv2

  • Artigo

APLICA-SE A: Developer | Básico | Padrão | Prémio

Este artigo fornece etapas para migrar uma instância de Gerenciamento de API hospedada stv1 na plataforma de computação in-loco para a stv2 plataforma quando a instância não é injetada (implantada) em uma VNet externa ou interna. Para esse cenário, migre sua instância usando o portal do Azure ou a API REST Migrar para stv2. Descubra se você precisa fazer isso.

Se você precisar migrar um gerenciamento de API injetado stv1 por VNnet hospedado na plataforma, consulte Migrar uma instância de gerenciamento de API injetada por rede virtual para a plataforma stv2.

Importante

O suporte para instâncias de gerenciamento de API hospedadas na stv1 plataforma está sendo desativado. No Azure global, a data de aposentadoria é 31 de agosto de 2024. No Azure Government e no Azure operado pela 21Vianet (Azure na China), a data de desativação é 24 de fevereiro de 2025. Se você tiver instâncias hospedadas na stv1 plataforma, migre-as para a plataforma antes da stv2 data de desativação para evitar interrupções no serviço.

Atenção

  • Migrar sua instância de Gerenciamento de API para uma nova infraestrutura é uma operação de longa duração.
  • Dependendo do seu processo de migração, você pode ter tempo de inatividade temporário durante a migração e talvez seja necessário atualizar suas dependências de rede após a migração para alcançar sua instância de Gerenciamento de API. Planeje sua migração de acordo.
  • A migração para stv2 não é reversível.

O que acontece durante a migração?

A migração da plataforma de gerenciamento de API de stv1 para stv2 envolve a atualização apenas da computação subjacente e não tem impacto na configuração de serviço/API persistida na camada de armazenamento. Para uma instância que não é implantada em uma rede virtual:

  • Você pode escolher se o endereço VIP da instância será alterado ou se o endereço VIP original será preservado.
  • O processo de atualização envolve a criação de uma nova computação em paralelo com a computação antiga.
  • O status de Gerenciamento de API no portal será Atualizando.
  • Se você optar por preservar o endereço VIP, a migração incluirá uma etapa adicional de mover o VIP da computação antiga para a nova computação, durante a qual as APIs não responderão.
  • O Azure gerencia o DNS do ponto de extremidade de gerenciamento e atualiza a nova computação imediatamente após a migração bem-sucedida.
  • O gateway padrão e o DNS do portal apontam para a nova computação imediatamente.
  • Se você optar por fazer com que sua instância de Gerenciamento de API receba um novo endereço VIP, precisará atualizar as dependências de rede para usar o novo endereço VIP.

Pré-requisitos

  • Use o ambiente Bash no Azure Cloud Shell. Para obter mais informações, consulte Guia de início rápido para Bash no Azure Cloud Shell.

  • Se preferir executar comandos de referência da CLI localmente, instale a CLI do Azure. Se estiver a utilizar o Windows ou macOS, considere executar a CLI do Azure num contentor Docker. Para obter mais informações, consulte Como executar a CLI do Azure em um contêiner do Docker.

    • Se estiver a utilizar uma instalação local, inicie sessão no CLI do Azure ao utilizar o comando az login. Para concluir o processo de autenticação, siga os passos apresentados no seu terminal. Para outras opções de entrada, consulte Entrar com a CLI do Azure.

    • Quando solicitado, instale a extensão da CLI do Azure na primeira utilização. Para obter mais informações sobre as extensões, veja Utilizar extensões com o CLI do Azure.

    • Execute o comando az version para localizar a versão e as bibliotecas dependentes instaladas. Para atualizar para a versão mais recente, execute o comando az upgrade.

Migrar a instância para a plataforma stv2

Opções de endereço IP público

Você pode escolher se o endereço IP virtual do Gerenciamento de API será alterado ou se o endereço VIP original será preservado.

  • Novo endereço IP virtual - Se você escolher esse modo, as solicitações de API permanecerão responsivas durante a migração. A configuração da infraestrutura (como domínios personalizados, locais e certificados de CA) será bloqueada por 30 minutos. Após a migração, você precisará atualizar todas as dependências de rede, incluindo DNS, regras de firewall e redes virtuais para usar o novo endereço VIP.

  • Preservar o endereço IP - Se você preservar o endereço VIP, as solicitações de API deixarão de responder por aproximadamente 15 minutos enquanto o endereço IP é migrado para a nova infraestrutura. A configuração da infraestrutura (como domínios personalizados, locais e certificados de CA) será bloqueada por 45 minutos. Nenhuma configuração adicional é necessária após a migração.

Endereço IP pré-criado para migração

Para instâncias de Gerenciamento de API acessíveis por um endereço IP público, o Gerenciamento de API pré-cria um endereço IP público para o processo de migração. Encontre o endereço IP pré-criado na saída JSON das propriedades da sua instância de Gerenciamento de API. Em customProperties, o endereço IP pré-criado é o valor da Microsoft.WindowsAzure.ApiManagement.Stv2MigrationPreCreatedIps propriedade. Para uma implantação em várias regiões, o valor é uma lista separada por vírgulas de endereços IP pré-criados.

Use o endereço IP (ou endereços) precriados para ajudá-lo a gerenciar o processo de migração:

  • Quando você migra e preserva o endereço VIP, o endereço IP pré-criado é atribuído temporariamente à nova stv2 implantação, antes que o endereço IP original seja atribuído à stv2 implantação. Se você tiver regras de firewall limitando o acesso à instância de Gerenciamento de API, por exemplo, poderá adicionar o endereço IP pré-criado à lista de permissões para preservar a continuidade do acesso do cliente durante a migração. Após a conclusão da migração, você pode remover o endereço IP pré-criado da sua lista de permissões.
  • Quando você migra e gera um novo endereço VIP, o endereço IP pré-criado é atribuído à nova stv2 implantação durante a migração e persiste após a conclusão da migração. Use o endereço IP pré-criado para atualizar suas dependências de rede, como DNS e regras de firewall, para apontar para o novo endereço IP.

Passos da Migração

  1. No portal do Azure, navegue até sua instância de Gerenciamento de API.

  2. No menu à esquerda, em Configurações, selecione Migração de plataforma.

  3. Na página Migração da plataforma, selecione uma das duas opções de migração:

    • Novo endereço IP virtual. O endereço VIP da sua instância de Gerenciamento de API será alterado automaticamente. Seu serviço não terá tempo de inatividade, mas após a migração, você precisará atualizar todas as dependências de rede, incluindo DNS, regras de firewall e redes virtuais para usar o novo endereço VIP.

    • Preservar endereço IP - O endereço VIP da sua instância de Gerenciamento de API não será alterado. Sua instância terá tempo de inatividade de até 15 minutos.

      Captura de tela da migração da plataforma de Gerenciamento de API no portal.

  4. Revise as diretrizes para o processo de migração e prepare seu ambiente.

  5. Depois de concluir as etapas de preparação, selecione Li e compreendo o impacto do processo de migração. Selecione Migrar.

Verificar a migração

Para verificar se a migração foi bem-sucedida, quando o status for alterado para Online, verifique a versão da plataforma da sua instância de Gerenciamento de API. Após a migração bem-sucedida, o valor é stv2 ou stv2.1.

Reverter automaticamente se a migração falhar

Se houver uma falha durante o processo de migração, a instância será revertida automaticamente para a stv1 plataforma. Se a migração for concluída com êxito (a versão da plataforma da instância mostra como stv2 ou stv2.1 e o status como Online), você não poderá reverter para a stv1 plataforma.

Para obter ajuda se a migração falhar, contacte o suporte do Azure.

Se você precisar da capacidade de reverter manualmente, a recomendação é implantar uma nova stv2 instância lado a lado com sua instância original de Gerenciamento de API.

Atualizar dependências de rede

Após a migração bem-sucedida para um novo endereço VIP, atualize todas as dependências de rede, incluindo DNS, regras de firewall e redes virtuais para usar o novo endereço VIP.

Ajuda e suporte

Estamos aqui para ajudá-lo a migrar para a stv2 plataforma com o mínimo de interrupções em seus serviços.

Se você tiver dúvidas, obtenha respostas rápidas de especialistas da comunidade em Perguntas e respostas da Microsoft. Se tiver um plano de suporte e precisar de ajuda técnica, crie um pedido de suporte.

  1. Em Resumo, digite uma descrição do seu problema, por exemplo, "stv1 retirement".
  2. Em Tipo de problema, selecione Técnico.
  3. Em Subscrição, selecione a sua subscrição.
  4. Em Serviço, selecione Meus serviços e, em seguida, selecione Serviço de Gerenciamento de API.
  5. Em Recurso, selecione o recurso do Azure para o qual está a criar um pedido de suporte.
  6. Em Tipo de problema, selecione Administração e gerenciamento.
  7. Para o subtipo Problema, selecione Upgrade, Scale ou SKU Changes.

Perguntas mais frequentes

  • De que informações precisamos para escolher um caminho de migração?

    • Qual é o modo de rede da instância de Gerenciamento de API?
    • Os domínios personalizados estão configurados?
    • Há um firewall envolvido?
    • Alguma dependência conhecida tomada por upstream/downstream nos IPs envolvidos?
    • É uma implantação multirregião?
    • Podemos modificar a instância existente ou é necessária uma configuração paralela?
    • Pode haver tempo de inatividade?
    • A migração pode ser feita fora do horário comercial?

  • Quais são os pré-requisitos para a migração?

    Para instâncias não injetadas por VNet, nenhum pré-requisito é necessário. Se você migrar preservando seu endereço IP público, isso tornará sua instância de Gerenciamento de API sem resposta por aproximadamente 15 minutos. Pode não haver um tempo de inatividade se você escolher a opção Novo endereço IP virtual que disponibiliza o Gerenciamento de API em um novo IP. As instâncias configuradas com um domínio personalizado usando um registro A e/ou com dependências de rede no endereço IP virtual público terão um tempo de inatividade quando um novo endereço IP virtual for solicitado.

  • A migração causará um tempo de inatividade?

    Para instâncias sem injeção de VNet, há um tempo de inatividade de aproximadamente 15 minutos somente se você optar por preservar o endereço IP original. No entanto, não haverá tempo de inatividade se você migrar com um novo endereço IP e não tiver dependências de rede no novo IP. As dependências de rede incluem nome de domínio personalizado sem CNAME, listagem de permissões de IP, regras de firewall e redes virtuais.

  • Podem ocorrer perdas de dados ou de configuração por/durante a migração?

    stv1 A migração envolve a stv2 atualização da plataforma de computação sozinha e a camada de armazenamento interno não é alterada. Portanto, toda a configuração é segura durante o processo de migração. Isso inclui a identidade gerenciada atribuída ao sistema, que, se habilitada, é preservada.

  • Como confirmar se a migração foi concluída e bem-sucedida?

    A migração é considerada concluída e bem-sucedida quando o status na página de visão geral lê Online junto com a versão da plataforma sendo ou stv2 stv2.1. Verifique também se o status da rede na folha de rede mostra verde para toda a conectividade necessária.

  • Posso fazer a migração usando o portal?

    Sim, a folha Migração de plataforma no portal do Azure orienta a migração para instâncias não injetadas por VNet.

  • Posso preservar o endereço IP da instância?

    Sim, o endereço IP pode ser preservado, mas haverá um tempo de inatividade de aproximadamente 15 minutos.

  • Existe um caminho de migração sem modificar a instância existente?

    Sim, você precisa de uma migração lado a lado. Isso significa que você cria uma nova instância de Gerenciamento de API em paralelo com sua instância atual e copia a configuração para a nova instância.

  • O que acontece se a migração falhar?

    Se sua instância de Gerenciamento de API não mostrar a versão da plataforma como stv2 ou stv2.1 e status como Online depois que você iniciou a migração, provavelmente falhou. Seu serviço é automaticamente revertido para a instância antiga e nenhuma alteração é feita. Se você tiver problemas (como se o status for Atualizando por mais de 2 horas), entre em contato com o suporte do Azure.

  • Que funcionalidade não está disponível durante a migração?

    Para instâncias não injetadas por VNet:

    • Se você optou por preservar o endereço IP original: as solicitações de API não respondem por aproximadamente 15 minutos enquanto o endereço IP é migrado para a nova infraestrutura. A configuração da infraestrutura (como domínios personalizados, locais e certificados de CA) é bloqueada por 45 minutos.
    • Se você optou por migrar para um novo endereço IP: as solicitações de API permanecem responsivas durante a migração. A configuração da infraestrutura (como domínios personalizados, locais e certificados de CA) é bloqueada por 30 minutos. Após a migração, você precisará atualizar todas as dependências de rede, incluindo DNS, regras de firewall e redes virtuais para usar o novo endereço VIP.

  • Quanto tempo demorará a migração?

    A duração esperada para toda a migração é de aproximadamente 45 minutos. O indicador para verificar se a migração já foi realizada é verificar se o Status da sua instância está de volta para Online e não Atualizando. Se estiver escrito Atualizar por mais de 2 horas, entre em contato com o suporte do Azure.

  • Posso reverter a migração, se necessário?

    Se houver uma falha durante o processo de migração, a instância será revertida automaticamente para a stv1 plataforma. No entanto, depois que o serviço for migrado com êxito, você não poderá reverter para a stv1 plataforma.

  • Há alguma alteração necessária em domínios personalizados/zonas DNS privadas?

    Para instâncias injetadas não VNet, nenhuma alteração será necessária se o IP for preservado. Se optou por um novo IP, os domínios personalizados referentes ao IP devem ser atualizados.

  • Minha instância stv1 é implantada em várias regiões do Azure (várias regiões). Como faço para atualizar para stv2?

    Para um Gerenciamento de API que não é injetado em uma VNet, siga as etapas de migração usando o portal ou a CLI do Azure. Todas as regiões serão migradas para stv2.

  • O que devemos considerar para gateways auto-hospedados?

    Você não precisa fazer nada em seus gateways auto-hospedados. Você só precisa migrar instâncias de Gerenciamento de API em execução no Azure que são afetadas pela desativação da stv1 plataforma. Observe que pode haver um novo IP para o ponto de extremidade de configuração da instância de Gerenciamento de API e quaisquer restrições de rede fixadas ao IP devem ser atualizadas.

  • Como o portal do desenvolvedor é afetado pela migração?

    Não há impacto no portal do desenvolvedor. Se forem usados domínios personalizados, o registro DNS deve ser atualizado com o IP efetivo, pós-migração. No entanto, se os domínios padrão estiverem em uso, eles serão atualizados automaticamente após a migração bem-sucedida. Não há tempo de inatividade para o portal do desenvolvedor durante a migração.

  • Existe algum impacto no custo depois de migrarmos para o stv2?

    O modelo de faturamento permanece o mesmo e stv2 não haverá mais custos incorridos durante e após a migração.

  • Quais permissões RBAC são necessárias para a migração stv1 para stv2?

    O usuário/processo que realiza a migração precisa de acesso de gravação à instância de Gerenciamento de API.

Conteúdos relacionados