Migrando uma zona hospedada para uma conta diferente AWS - Amazon Route 53

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Migrando uma zona hospedada para uma conta diferente AWS

Se quiser migrar uma zona hospedada de uma AWS conta para outra, você pode listar programaticamente os registros na zona hospedada antiga, editar a saída e, em seguida, criar registros programaticamente em uma nova zona hospedada usando a saída editada. Observe o seguinte:

  • Se tiver apenas alguns registros, você também poderá usar o console do Route 53 para criar registros na nova zona hospedada. Para ter mais informações, consulte Criar registros usando o console do Amazon Route 53.

  • Alguns procedimentos usam o AWS Command Line Interface (AWS CLI). Você também pode realizar esses procedimentos usando um dos AWS SDKs, a API do Amazon Route 53 ou AWS Tools for Windows PowerShell. Para este tópico, usamos o AWS CLI porque é mais fácil para um pequeno número de zonas hospedadas.

  • Você também pode usar esse processo para criar registros em uma nova zona hospedada com um nome diferente dos nomes de zonas hospedadas existentes, mas que tenha os mesmos registros.

  • Não é possível migrar registros de alias que roteiam o tráfego para instâncias de política de tráfego.

Etapa 1: instalar ou atualizar o AWS CLI

Para obter informações sobre como baixar, instalar e configurar o AWS CLI, consulte o Guia do AWS Command Line Interface usuário.

nota

Configure a CLI de forma que você possa usá-la quando estiver usando tanto a conta que criou a zona hospedada quanto a conta para onde está migrando a zona hospedada. Para obter mais informações, consulte Configurar no Guia do usuário da AWS Command Line Interface .

Se você já estiver usando o AWS CLI, recomendamos que você atualize para a versão mais recente da CLI para que os comandos da CLI suportem os recursos mais recentes do Route 53.

Etapa 2: criar uma nova zona hospedada

O procedimento a seguir explica como usar o console do Route 53 para criar a zona hospedada para onde você quer migrar.

nota

O Route 53 atribui um novo conjunto de quatro servidores de nome à nova zona hospedada. Depois de migrar uma zona hospedada para outra AWS conta, você precisa atualizar o registro do domínio para usar os servidores de nomes da nova zona hospedada. Lembraremos você sobre esta etapa posteriormente no processo.

Para criar a nova zona hospedada usando uma conta diferente
  1. Faça login AWS Management Console e abra o console do Route 53 em https://console.aws.amazon.com/route53/.

    Faça login com as credenciais da conta para a qual você deseja migrar a zona hospedada.

  2. Crie uma zona hospedada. Para ter mais informações, consulte Criar uma zona hospedada pública.

  3. Anote o ID da zona hospedada. Em alguns casos, você precisará dessa informação mais adiante no processo.

  4. Faça logout do console do Route 53.

Etapa 3: criar um arquivo que contém os registros que você deseja migrar

Para migrar registros de uma zona hospedada para outra, crie um arquivo contendo os registros que deseja migrar, edite o arquivo e, em seguida, use o arquivo editado para criar os registros na nova zona hospedada. Execute o procedimento a seguir para criar o arquivo.

Para criar um arquivo contendo os registros que você deseja migrar
  1. Faça login AWS Management Console e abra o console do Route 53 em https://console.aws.amazon.com/route53/.

    Faça login com as credenciais da conta que criou a zona hospedada que você deseja migrar.

  2. Obtenha o ID da zona hospedada que você deseja migrar:

    1. No painel de navegação, escolha Zonas hospedadas.

    2. Localize a zona hospedada que você deseja migrar. Se você tiver muitas zonas hospedadas, você pode escolher Exact domain name (Nome de domínio exato) e inserir o nome da zona hospedada e pressionar Enter para filtrar a lista.

    3. Obtenha o valor da coluna Hosted zone ID (ID da zona hospedada).

  3. Execute o seguinte comando:

    aws route53 list-resource-record-sets --hosted-zone-id hosted-zone-id > path-to-output-file

    Observe o seguinte:

    • Para hosted-zone-id, especifique o ID da zona hospedada que você obteve na etapa 2 deste procedimento.

    • Para path-to-output-file, especifique o caminho do diretório e o nome do arquivo em que você deseja salvar a saída.

    • O caractere > envia a saída para o arquivo especificado.

    • O manipula AWS CLI automaticamente a paginação para zonas hospedadas que contêm mais de 100 registros. Para obter mais informações, consulte Usando as opções de paginação da interface de linha de AWS comando no Guia do AWS Command Line Interface usuário.

      Se você usar outro método programático para listar registros, como um dos AWS SDKs, poderá obter no máximo 100 registros por página de resultados. Se a zona hospedada contiver mais de 100 registros, você terá que enviar várias solicitações para listar todos os registros.

    • Para executar o comando em versões do Windows PowerShell anteriores à 6.0, use a seguinte sintaxe:

      aws route53 list-resource-record-sets --hosted-zone-id hosted-zone-id | Out-File path-to-output-file -Encoding utf8

    Por exemplo, se você estiver executando o AWS CLI em um computador Windows, poderá executar o seguinte comando:

    aws route53 list-resource-record-sets --hosted-zone-id ZOLDZONE12345 > c:\temp\list-records-ZOLDZONE12345.txt

    Se você estiver executando o AWS CLI em um computador Windows em uma versão do Windows PowerShell anterior à 6.0, você pode executar o seguinte comando:

    $output = aws route53 list-resource-record-sets --hosted-zone-id <hosted-zone-id>; $mypath = <output-path ; [System.IO.File]::WriteAllLines($mypath,$output)
  4. Faça uma cópia dessa saída. Depois de criar registros na nova zona hospedada, recomendamos que você execute o AWS CLI list-resource-record-sets comando na nova zona hospedada e compare as duas saídas para garantir que todos os registros foram criados.

Etapa 4: editar os registros que você deseja migrar

O formato do arquivo que você criou no procedimento anterior é próximo ao formato exigido pelo AWS CLI change-resource-record-sets comando usado para criar registros na nova zona hospedada. No entanto, o arquivo requer algumas edições. Você deverá aplicar algumas alterações em todos os registros. Você pode fazer essas alterações usando a função de pesquisa e substituição em um bom editor de texto.

Abra uma cópia do arquivo que você criou em Etapa 3: criar um arquivo que contém os registros que você deseja migrare faça as seguintes alterações:

  • Exclua as duas primeiras linhas na parte superior da saída:

    { "ResourceRecordSets": [
  • Exclua as linhas relacionadas aos registros de NS e de SOA. A nova zona hospedada já tem esses registros.

  • Opcional: adicione um elemento Comment.

  • Adicione um elemento Changes.

  • Para cada registro, adicione uma Action e um elemento ResourceRecordSet.

  • Adicione as chaves de abrir e fechar ( { } ), conforme necessário para tornar o código JSON válido.

    nota

    Você pode usar um validador JSON para verificar se todas as chaves e colchetes estão nos locais corretos. Para encontrar um validador JSON online, realize uma pesquisa na Internet com "json validator".

  • Se a zona hospedada contiver algum alias que faça referência a outros registros na mesma zona hospedada, faça as seguintes alterações:

    • Altere o ID da zona hospedada para o ID da nova zona hospedada.

      Importante

      Se o registro de alias estiver apontando para outro recurso, por exemplo, um balanceador de carga, não altere o ID da zona hospedada para o ID da zona hospedada do próprio recurso, não o ID da zona hospedada do domínio. Se você alterar a ID da zona hospedada acidentalmente, reverta a ID da zona hospedada para a ID da zona hospedada do próprio recurso, não para a ID da zona hospedada do domínio. Esse ID da zona hospedada pode ser encontrado no AWS console em que o recurso foi criado.

    • Mova os registros de alias para a parte inferior do arquivo. O Route 53 deve criar o registro ao qual um registro de alias se refere antes de criar o registro de alias.

      Importante

      Se um ou mais registros de alias se referem a outros registros de alias, os registros que são o destino do alias devem aparecer no arquivo antes dos registros de alias que fazem a referência. Por exemplo, se alias.example.com for o destino de alias para alias.alias.example.com, alias.example.com deve aparecer primeiro no arquivo.

    • Exclua os registros de alias que roteiam o tráfego para uma instância de política de tráfego. Anote os registros para que você possa recriá-los posteriormente.

  • Você pode usar esse processo para criar registros em uma zona hospedada com um nome diferente. Para cada registro na saída, altere a parte do nome de domínio do elemento Name para o nome da nova zona hospedada. Por exemplo, se você lista os registros na zona hospedada example.com e deseja criar registros em uma zona hospedada example.net, altere a parte example.com do nome de cada registro para example.net:

    From:

    • "Name": "example.com."

    • "Name": "www.example.com."

    Para:

    • "Name": "example.net."

    • "Name": "www.example.net."

O exemplo a seguir mostra a versão editada dos registros de uma zona hospedada para example.com. O texto em itálico vermelho, é novo:

{ "Comment": "string", "Changes": [ { "Action": "CREATE", "ResourceRecordSet":{ "ResourceRecords": [ { "Value": "192.0.2.4" }, { "Value": "192.0.2.5" }, { "Value": "192.0.2.6" } ], "Type": "A", "Name": "route53documentation.com.", "TTL": 300 } }, { "Action": "CREATE", "ResourceRecordSet":{ "AliasTarget": { "HostedZoneId": "Z3BJ6K6RIION7M", "EvaluateTargetHealth": false, "DNSName": "s3-website-us-west-2.amazonaws.com." }, "Type": "A", "Name": "www.route53documentation.com." } } ] }

Etapa 5: dividir os arquivos grandes em arquivos menores

Se você tiver uma grande quantidade de registros ou se tiver registros que têm uma grande quantidade de valores (por exemplo, uma grande quantidade de endereços IP), pode ser necessário dividir o arquivo em arquivos menores. Estes são os máximos:

  • Cada arquivo pode ter um máximo de 1.000 registros.

  • O tamanho máximo combinado dos valores em todos os elementos Value é de 32.000 bytes.

Etapa 6: criar registros na nova zona hospedada

Para criar registros na nova zona hospedada, use o seguinte AWS CLI comando:

aws route53 change-resource-record-sets --hosted-zone-id id-of-new-hosted-zone --change-batch file://path-to-file-that-contains-records

Por exemplo: .

aws route53 change-resource-record-sets --hosted-zone-id ZNEWZONE1245 --change-batch file://c:/temp/change-records-ZNEWZONE1245.txt

Se você tiver excluído os registros de alias que encaminham o tráfego para uma instância de política de tráfego, recrie-os usando o console do Route 53. Para ter mais informações, consulte Criar registros usando o console do Amazon Route 53.

Etapa 7: comparar registros das zonas hospedadas nova e antiga

Para confirmar que você criou com êxito todos os registros na nova zona hospedada, recomendamos que você liste os registros na nova zona hospedada e compare a saída com a lista de registros da antiga zona hospedada. Para fazer isso, execute o procedimento a seguir.

Para comparar registros das zonas hospedadas nova e antiga
  1. Execute o seguinte comando:

    aws route53 list-resource-record-sets --hosted-zone-id hosted-zone-id --output json > path-to-output-file

    Especifique os seguintes valores:

    • Para hosted-zone-id, especifique o ID da nova zona hospedada.

    • Para path-to-output-file, especifique o caminho do diretório e o nome do arquivo em que você deseja salvar a saída. Use um nome de arquivo que seja diferente do nome do arquivo que você usou em Etapa 3: criar um arquivo que contém os registros que você deseja migrar. Ao usar um nome de arquivo diferente, você garante que o arquivo novo não substituirá o arquivo antigo.

    • O caractere > envia a saída para o arquivo especificado.

    Por exemplo, se você estiver usando um computador com o Windows, poderá executar o seguinte comando:

    aws route53 list-resource-record-sets --hosted-zone-id ZNEWZONE67890 --output json > c:\temp\list-records-ZNEWZONE67890.txt
  2. Compare a saída obtida com a saída de Etapa 3: criar um arquivo que contém os registros que você deseja migrar.

    A não ser pelos valores dos registros de NS e de SOA e por todas as alterações feitas em Etapa 4: editar os registros que você deseja migrar (como IDs de zona hospedada ou nomes de domínio diferentes), as duas saídas devem ser idênticas.

  3. Se os registros na nova zona hospedada não correspondem aos registros na antiga zona hospedada, você pode realizar uma das seguintes ações:

Etapa 8: atualizar o registro do domínio para usar servidores de nome para a nova zona hospedada

Ao concluir a criação de registros na nova zona hospedada, altere os servidores de nome do registro do domínio para usarem os servidores de nome da nova zona hospedada.

Importante

Se você não atualizar o registro do domínio para usar os servidores de nome da nova zona hospedada, o Route 53 continuará usando a zona hospedada antiga para encaminhar o tráfego para o domínio. Se você excluir a zona hospedada antiga sem atualizar os servidores de nome do registro do domínio, o domínio ficará indisponível na Internet. Se você adicionar, atualizar ou excluir registros na nova zona hospedada sem atualizar os servidores de nome do registro do domínio, o tráfego não será roteado com base nessas alterações.

Para ter mais informações, consulte Como transformar o Amazon Route 53 no serviço de DNS para um domínio existente.

nota

Se você usar o processo para migrar o serviço DNS para um domínio que está em uso ou o processo para um domínio inativo, poderá ignorar as etapas a seguir, pois já criou uma nova zona hospedada e os registros na zona hospedada:

  • Etapa 1: obter a configuração DNS atual do provedor de serviço de DNS atual

  • Etapa 2: criar uma zona hospedada

  • Etapa 3: criar registros

Etapa 9: aguardar os resolvedores DNS começarem a usar a nova zona hospedada

Se seu domínio estiver em uso, por exemplo, se os usuários estiverem usando o nome de domínio para navegar em um site ou acessar uma aplicação Web, os resolvedores DNS terão armazenado em cache os nomes dos servidores de nomes que foram fornecidos por seu provedor de serviço DNS atual. Um resolvedor DNS que armazenou essas informações em cache há alguns minutos irá salvá-los por até dois dias.

nota

Se você tiver criado registros na nova zona hospedada que não aparecem na zona hospedada antiga, os usuários não poderão usar os novos registros para acessar seus recursos até que os resolvedores comecem a usar os servidores de nome da nova zona hospedada. Por exemplo, suponha que você crie um registro, teste.exemplo.com, na nova zona hospedada que deve rotear o tráfego de Internet para seu site. Se o registro não aparecer na zona hospedada antiga, você não poderá inserir teste.exemplo.com em um navegador da Web até que os resolvedores comecem a usar a nova zona hospedada.

Para garantir que a migração de uma zona hospedada para outra AWS conta tenha sido concluída antes de excluir a zona hospedada antiga, aguarde dois dias após atualizar o registro do domínio para usar servidores de nomes para a nova zona hospedada. Após o TTL de dois dias expirar e os resolvedores solicitarem os servidores de nome de seu domínio, os resolvedores obterão os servidores de nome atuais. Você também pode habilitar Log de consultas do Resolver para monitorar consultas nas novas zonas hospedadas. Para obter informações sobre os preços do registro de consultas do Resolver, consulte CloudWatch preços.

Etapa 10: (opcional) excluir a zona hospedada antiga

Opcionalmente, quando você estiver certo de que não precisa mais da zona hospedada antiga, poderá excluí-la.

Importante

Não exclua a zona hospedada antiga ou quaisquer registros nessa zona hospedada por pelo menos 48 horas depois de atualizar o registro do domínio para usar servidores de nome da nova zona hospedada. Se você excluir a zona hospedada antiga antes dos resolvedores DNS pararem de usar os registros nessa zona hospedada, seu domínio poderá estar indisponível na Internet até que os resolvedores comecem a usar a nova zona hospedada.

A zona hospedada deve estar vazia, com exceção dos registros de NS e SOA padrão. Se a antiga zona hospedada contém uma grande quantidade de registros, excluí-los usando o console pode levar muito tempo. Uma opção é executar as etapas a seguir:

  1. Faça uma cópia do arquivo editado a partir de Etapa 4: editar os registros que você deseja migrar.

  2. Na cópia do arquivo, altere "Action": "CREATE" para "Action": "DELETE" em todos os registros.

  3. Use o AWS CLI comando a seguir para excluir os registros:

    aws route53 change-resource-record-sets --hosted-zone-id id-of-old-hosted-zone --change-batch file:///path-to-file-that-contains-records
    Importante

    Certifique-se de que o valor especificado para o ID da zona hospedada é o ID da zona hospedada antiga, e não o ID da zona hospedada nova.

  4. Exclua todos os demais registros e a zona hospedada:

    1. Faça login AWS Management Console e abra o console do Route 53 em https://console.aws.amazon.com/route53/.

      Faça login com as credenciais da conta que criou a zona hospedada antiga.

    2. No painel de navegação, escolha Zonas hospedadas.

    3. Escolha o nome da zona hospedada antiga. Se você tiver muitas zonas hospedadas, você pode escolher Exact domain name (Nome de domínio exato) e inserir o nome da zona hospedada e pressionar Enter para filtrar a lista.

    4. Se a zona hospedada contiver algum registro que não seja um registro padrão de NS e SOA (como registros de alias que encaminham o tráfego para uma instância de política de tráfego), marque as caixas de seleção correspondentes e escolha Delete (Excluir).

    5. No painel de navegação, escolha Zonas hospedadas.

    6. Na lista de zonas hospedadas, escolha o botão de opção da zona hospedada que você deseja excluir.

    7. Escolha Excluir.