Criação de um grupo de sub-redes do Amazon DocumentDB - Amazon DocumentDB
Como criar um grupo de sub-redes

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

Criação de um grupo de sub-redes do Amazon DocumentDB

Ao criar um cluster do Amazon DocumentDB, você deve escolher uma Amazon VPC e um grupo de sub-rede correspondente dentro dessa Amazon VPC para iniciar o seu cluster. As sub-redes determinam a zona de disponibilidade e intervalo de IP dentro da zona de disponibilidade que você deseja usar para iniciar uma instância.

Um grupo de sub-redes permite que você especifique as sub-redes (ou AZs) que permite a você especificar as zonas de disponibilidade que deseja usar para iniciar instâncias do Amazon DocumentDB. Por exemplo, em um cluster com três instâncias, é recomendável que cada uma dessas instâncias seja provisionada em AZs separadas - fazendo isto, otimiza para alta disponibilidade. Assim, se uma única AZ falhar, ela afetará apenas uma única instância.

As instâncias do Amazon DocumentDB podem ser provisionadas atualmente em até três AZs. Mesmo que um grupo de sub-rede tenha mais de três sub-redes, você só poderá usar três dessas sub-redes para criar um cluster do Amazon DocumentDB. Assim, é recomendável que, ao criar um grupo de sub-redes, você escolha somente as três sub-redes nas quais deseja implantar suas instâncias.

Por exemplo: um cluster é criado e o Amazon DocumentDB escolhe AZs {1A, 1B e 1C}. Se você tentar criar uma instância na AZ {1D} a chamada de API não será bem-sucedida. No entanto, se você optar por criar uma instância, sem especificar a AZ específica, o Amazon DocumentDB escolherá uma AZ por você. O Amazon DocumentDB usa um algoritmo para balancear a carga das instâncias em todas as AZs para ajudar você a alcançar alta disponibilidade. Por exemplo, se três instâncias são provisionadas, por padrão, elas serão provisionadas em três zonas de disponibilidade e não serão provisionadas todas em uma única AZ.

Melhores práticas

  • A menos que você tenha um motivo específico, sempre crie um grupo de sub-rede com três sub-redes. Isso garantirá que clusters com três ou mais instâncias alcancem maior disponibilidade à medida que as instâncias sejam provisionadas em três zonas de disponibilidade.

  • Sempre distribua instâncias em vários AZs para obter alta disponibilidade. Nunca coloque todas as instâncias de um cluster em uma única AZ.

  • Como os eventos de failover podem acontecer a qualquer momento, você não deve presumir que uma instância primária ou de réplica sempre estará em uma determinada AZ.

Como criar um grupo de sub-redes

Você pode usar o AWS Management Console ou AWS CLI para criar um grupo de sub-redes do Amazon DocumentDB:

Using the AWS Management Console

Use as seguintes etapas para criar um grupo de sub-redes do Amazon DocumentDB.

Para criar um grupo de sub-redes do Amazon DocumentDB

  1. Faça login no AWS Management Console e abra o console do Amazon DocumentDB em https://console.aws.amazon.com/docdb.

  2. No painel de navegação, selecione Subnet groups (Grupos de sub-redes) e, depois, escolha Create (Criar).

    dica

    Se você não visualizar o painel de navegação à esquerda da tela, selecione o ícone do menu (Hamburger menu icon with three horizontal lines.) no canto superior esquerdo da página.

  3. Na página Create subnet group (Criar grupo de sub-redes):

    1. Na seção Subnet group details (Detalhes do grupo de sub-redes):

      1. Nome—Digite um nome significativo para o grupo de sub-redes.

      2. Descrição—insira uma descrição para o grupo de sub-redes.

    2. Na seção Adicionar sub-redes:

      1. VPC—Na lista, escolha uma VPC para esse grupo de sub-redes.

      2. Faça um dos seguintes procedimentos:

        • Para incluir todas as sub-redes na VPC escolhida, selecione Add all the subnets related to this VPC (Adicionar todas as sub-redes relacionadas a essa VPC).

        • Para especificar sub-redes para esse grupo de sub-redes, faça o seguinte para cada zona de disponibilidade na qual você deseja incluir sub-redes. Você deve incluir pelo menos duas zonas de disponibilidade.

          1. Zona de disponibilidade—Na lista, escolha uma zona de disponibilidade.

          2. Sub-rede—Na lista, escolha uma sub-rede na zona de disponibilidade escolhida para esse grupo de sub-redes.

          3. Escolha Adicioinar sub-rede.

  4. Escolha Criar. Quando o grupo de sub-rede é criado, ele é listado com seus outros grupos de sub-redes.

    Screenshot: mostrando os detalhes de um grupo de sub-redes.
Using the AWS CLI

Antes de criar um grupo de sub-redes usando a AWS CLI, você deve determinar quais sub-redes estão disponíveis. Execute a seguinte operação de AWS CLI para listar as zonas de disponibilidade e as sub-redes.

Parâmetros:

  • --db-subnet-group: opcional. A especificação de um determinado grupo de sub-redes lista as zonas de disponibilidade e as sub-redes para esse grupo. Omitir esse parâmetro lista zonas de disponibilidade e as sub-redes para todos os seus grupos de sub-redes. A especificação do grupo de sub-redes default lista todas as sub-redes da VPC.

Para Linux, macOS ou Unix:

aws docdb describe-db-subnet-groups \
    --db-subnet-group-name default \
    --query 'DBSubnetGroups[*].[DBSubnetGroupName,Subnets[*].[SubnetAvailabilityZone.Name,SubnetIdentifier]]'

Para Windows:

aws docdb describe-db-subnet-groups ^
    --db-subnet-group-name default ^
    --query 'DBSubnetGroups[*].[DBSubnetGroupName,Subnets[*].[SubnetAvailabilityZone.Name,SubnetIdentifier]]'

A saída dessa operação é semelhante ao seguinte (formato JSON).

[
    [
        "default",
        [
            [
                "us-east-1a",
                "subnet-4e26d263"
            ],
            [
                "us-east-1c",
                "subnet-afc329f4"
            ],
            [
                "us-east-1e",
                "subnet-b3806e8f"
            ],
            [
                "us-east-1d",
                "subnet-53ab3636"
            ],
            [
                "us-east-1b",
                "subnet-991cb8d0"
            ],
            [
                "us-east-1f",
                "subnet-29ab1025"
            ]
        ]
    ]
]

Usando a saída da operação anterior, você pode criar um novo grupo de sub-redes. O novo grupo de sub-redes deve incluir sub-redes em pelo menos duas zonas de disponibilidade.

Parâmetros:

  • --db-subnet-group-name: obrigatório. O nome para esse grupo de sub-redes.

  • --db-subnet-group-description: obrigatório. A descrição do grupo de sub-redes.

  • --subnet-ids: obrigatório. Uma lista de sub-redes a serem incluídas no grupo de sub-redes. Exemplo: subnet-53ab3636.

  • Tags: opcionais. Uma lista de tags (pares de chave/valor) a serem anexadas a esse grupo de sub-redes.

O código a seguir cria o grupo de sub-redes sample-subnet-group com três sub-redes, subnet-4e26d263, subnet-afc329f4 e subnet-b3806e8f.

Para Linux, macOS ou Unix:

aws docdb create-db-subnet-group \
    --db-subnet-group-name sample-subnet-group \
    --db-subnet-group-description "A sample subnet group" \
    --subnet-ids subnet-4e26d263 subnet-afc329f4 subnet-b3806e8f \
    --tags Key=tag1,Value=One Key=tag2,Value=2

Para Windows:

aws docdb create-db-subnet-group ^
    --db-subnet-group-name sample-subnet-group ^
    --db-subnet-group-description "A sample subnet group" ^
    --subnet-ids subnet-4e26d263 subnet-afc329f4 subnet-b3806e8f ^
    --tags Key=tag1,Value=One Key=tag2,Value=2

A saída dessa operação é semelhante ao seguinte (formato JSON).

{
    "DBSubnetGroup": {
        "DBSubnetGroupDescription": "A sample subnet group",
        "DBSubnetGroupName": "sample-subnet-group",
        "Subnets": [
            {
                "SubnetAvailabilityZone": {
                    "Name": "us-east-1a"
                },
                "SubnetIdentifier": "subnet-4e26d263",
                "SubnetStatus": "Active"
            },
            {
                "SubnetAvailabilityZone": {
                    "Name": "us-east-1c"
                },
                "SubnetIdentifier": "subnet-afc329f4",
                "SubnetStatus": "Active"
            },
            {
                "SubnetAvailabilityZone": {
                    "Name": "us-east-1e"
                },
                "SubnetIdentifier": "subnet-b3806e8f",
                "SubnetStatus": "Active"
            }
        ],
        "VpcId": "vpc-91280df6",
        "DBSubnetGroupArn": "arn:aws:rds:us-east-1:123SAMPLE012:subgrp:sample-subnet-group",
        "SubnetGroupStatus": "Complete"
    }
}