Como criar conjuntos de registros alias de recurso no Route 53 usando a AWS CLI?

Breve descrição

Você pode usar um registro de alias no Route 53 para apontar para um recurso da AWS ou um bucket do Amazon Simple Storage Service (Amazon S3). Você pode criar um registro de alias por meio do console do Route 53 ou da AWS CLI.

Resolução

Observação: se você receber erros ao executar comandos da AWS Command Line Interface (AWS CLI), certifique-se de estar usando a versão mais recente da AWS CLI.

Antes de criar conjuntos de registros de recursos de alias, crie uma zona hospedada para conter os registros para rotear o tráfego ao seu domínio. A zona hospedada e seu domínio devem ter o mesmo nome. Dependendo do seu caso de uso, há duas opções. Você pode criar uma zona hospedada pública para rotear o tráfego da Internet. Ou também pode criar uma zona hospedada privada para rotear o tráfego dentro de uma Amazon Virtual Private Cloud (Amazon VPC).

Criar seu conjunto de registros de recursos de alias

Modifique o exemplo de sintaxe JSON a seguir para criar seu próprio conjunto de registros de recursos de alias e, em seguida, especifique seus próprios valores para registros de alias. Salve o arquivo (por exemplo, amostra.json).

Aviso: certifique-se de usar o ID da zona hospedada dos seus recursos da AWS, e não seu nome de domínio, na sua configuração. No arquivo JSON, esse valor é especificado no par de chave/valor HostedZoneId. Antes de continuar, localize o HostedZoneId para os endpoints do Elastic Load Balancing, AWS Elastic Beanstalk, Amazon S3, and Amazon CloudFront de cada região.

Este exemplo cria o conjunto de registros de recurso de alias para um domínio (elb.example.com) para apontar para um endpoint de balanceador de carga (ALB-xxxxxxxx.us-west-2.elb.amazonaws.com). O corpo da solicitação inclui uma lista de itens de alteração, conhecida como lote de alterações. Itens de alteração estão incluídos com um elemento ChangeResourceRecordSetsRequest.

{
  "Comment": "Creating Alias resource record sets in Route 53",
  "Changes": [
    {
      "Action": "CREATE",
      "ResourceRecordSet": {
        "Name": "elb.example.com",
        "Type": "A",
        "AliasTarget": {
          "HostedZoneId": "Z1H1FL5HABSF5",
          "DNSName": "ALB-xxxxxxxx.us-west-2.elb.amazonaws.com",
          "EvaluateTargetHealth": false
        }
      }
    }
  ]
}

Em seguida, use um comando change-resource-record-sets para criar seu conjunto de registros de recursos em uma zona hospedada. Os valores para a criação de registros são especificados no arquivo de configuração JSON que você criou anteriormente.

Modifique o comando a seguir para sua configuração. Para --hosted-zone-id, forneça seu ID de zona hospedada para o nome do domínio:

$ aws route53 change-resource-record-sets --hosted-zone-id ZXXXXXXXXXX --change-batch file://sample.json

Configurações do Elastic Load Balancing

Se você estiver apontando para um balanceador de carga, sempre inclua dualstack no valor para o par de chave/valor DNSName do arquivo JSON. Por exemplo, se o nome DNS fornecido pela Amazon para seu balanceador de carga for ALB-xxxxxxxx.us-west-2.elb.amazonaws.com, use:

"DNSName": "dualstack.ALB-xxxxxxxx.us-west-2.elb.amazonaws.com"

Configurações de distribuição do CloudFront

Se você estiver apontando para uma distribuição do CloudFront, especifique o nome de domínio de distribuição do CloudFront fornecido pela Amazon no par de chave/valor DNSName do arquivo JSON. Por exemplo, se o nome de domínio fornecido pela Amazon para distribuição do CloudFront for d111111abcdef8.cloudfront.net, use:

"DNSName": "d111111abcdef8.cloudfront.net"

Aviso: você deve incluir um nome de domínio alternativo para usar no lugar do nome atribuído pelo CloudFront. O nome de domínio alternativo deve corresponder ao domínio para o qual você criou o conjunto de registros de recursos de alias. Por exemplo, se quiser acessar sua distribuição do CloudFront usando o domínio example.com, adicione o domínio aos Nomes de domínios alternativos da distribuição.

Configurações do bucket do Amazon S3

Se estiver apontando para um bucket do S3, especifique o nome de domínio do endpoint do site do bucket para o par de chave/valor DNSName no arquivo JSON. Não use o endpoint do S3 que aparece na hospedagem estática do site no console de gerenciamento do S3 para o valor. O nome de domínio para o qual você cria o conjunto de registros de recursos deve corresponder ao nome do seu bucket do Amazon S3.

Você também deve especificar a região em que o bucket está hospedado (por exemplo, us-east-1).

s3-website-us-east-1.amazonaws.com

Veja a seguir um exemplo de sintaxe JSON para apontar para um bucket do S3:

{
  "Comment": "Alias record for S3 bucket",
  "Changes": [
    {
      "Action": "CREATE",
      "ResourceRecordSet": {
        "Name": "new.example.com",
        "Type": "A",
        "AliasTarget": {
          "HostedZoneId": "Z3BJ6K6RIION7M",
          "DNSName": "s3-website-us-west-2.amazonaws.com",
          "EvaluateTargetHealth": false
        }
      }
    }
  ]
}

Observação: além de criar registros de alias apontando para os recursos da AWS, como o CloudFront, o Amazon S3 ou o ELB, você pode criar um registro de recurso de alias. O registro de recurso de alias aponta para outro registro na mesma zona hospedada em que você está criando o registro de alias. O registro de alias deve ter o mesmo tipo do registro ao qual você está roteando.

---

Informações relacionadas

Como corrigir erros durante a criação de conjuntos de registros de recurso do Amazon Route 53 usando a AWS CLI?