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á.
Conectar o Amazon EC2 manualmente
Tópicos
As etapas a seguir pressupõem que você concluiu as etapas do tópico Pré-requisitos.
Etapa 1: criar uma instância do Amazon EC2
Nesta etapa, você criará uma instância do Amazon EC2 na mesma região e na Amazon VPC que você usará posteriormente para provisionar seu cluster Amazon DocumentDB.
-
No console do Amazon EC2, selecione Iniciar instância.
-
Insira um nome ou identificador no campo Nome, localizado na seção Nome e tags.
-
Na lista suspensa Imagem de máquina da Amazon (AMI), localize a AMI do Amazon Linux 2 e escolha-a.
-
Localize e escolha t3.micro na lista suspensa Tipo de instância.
-
Na seção Par de chaves (login) insira o identificador de um par de chaves existente ou selecione Criar um novo par de chaves.
É necessário fornecer um par de chaves do Amazon EC2.
Se você tiver um par de chaves do Amazon EC2:
-
Selecione um par de chaves, escolha seu par de chaves na lista.
-
Você já deve ter o arquivo de chave privada (arquivo .pem ou .ppk) disponível para fazer login na instância do Amazon EC2.
Se você não tiver um par de chaves do Amazon EC2:
-
Ao escolher Criar novo par de chaves, a caixa de diálogo Criar par de chaves é exibida.
-
Insira um nome no campo Nome do par de chaves.
-
Escolha o Tipo de par de chaves e o Formato de arquivo de chave privada.
-
Escolha Create key pair (Criar par de chaves).
nota
Para fins de segurança, é altamente recomendável usar um par de chaves para conectividade de SSH e de internet com sua instância do EC2.
-
-
Na seção Configurações de rede, em Firewall (grupos de segurança), escolha Criar grupo de segurança ou Selecionar grupo de segurança existente.
Se você optar por selecionar um grupo de segurança existente, selecione um na lista suspensa Grupos de segurança comuns.
Se você optar por criar um novo grupo de segurança, faça o seguinte:
Verifique todas as regras de permissão de tráfego que se aplicam à sua conectividade do EC2.
No campo IP, escolha Meu IP ou selecione Personalizado para escolher em uma lista de blocos CIDR, listas de prefixos ou grupos de segurança. Não recomendamos Qualquer lugar como opção, a menos que sua instância do EC2 esteja em uma rede isolada, pois ela permite que qualquer endereço IP acesse sua instância do EC2.
-
Na seção Resumo, revise sua configuração do EC2 e escolha Iniciar instância, se tudo estiver correto.
Etapa 2: criar um grupo de segurança
Agora você criará um novo grupo de segurança em sua Amazon VPC padrão. O grupo de segurança demoDocDB permite que você se conecte ao seu cluster Amazon DocumentDB na porta 27017 (a porta padrão para o Amazon DocumentDB) a partir da sua instância do Amazon EC2.
-
No console de gerenciamento do Amazon EC2
, em Rede e segurança, escolha Grupos de segurança.
-
Escolha Criar grupo de segurança.
-
Na seção Detalhes básicos:
Em Nome do grupo de segurança, insira
demoDocDB.Em Descrição, insira uma descrição.
Para VPC, aceite o uso da sua VPC padrão.
-
Na seção Regras de entrada, escolha Adicionar regra.
Em Tipo, selecione Regra TCP personalizada (padrão).
Em Intervalo de portas, insira
27017.Em Source, escolha Custom. No campo ao lado, procure o grupo de segurança que você acabou de criar na etapa 1. Talvez seja necessário atualizar seu navegador para que o console do Amazon EC2 preencha automaticamente o nome da fonte.
-
Aceite todos os outros padrões e escolha Criar grupo de segurança.
Etapa 3: criar um cluster do Amazon DocumentDB
Enquanto a instância do Amazon EC2 estiver sendo provisionada, você criará seu cluster Amazon DocumentDB.
-
Navegue até o console do Amazon DocumentDB e escolha Clusters no painel de navegação.
-
Escolha Criar.
-
Deixe a configuração Tipo de cluster com o valor padrão, Cluster baseado em instância.
-
Em Configuração do cluster, em Identificador do cluster, insira um nome exclusivo. Observe que o console mudará todos os nomes de cluster para minúsculas, independentemente de como eles sejam inseridos.
Deixe a Versão do mecanismo com o valor padrão de 5.0.0.
Em Configuração de armazenamento em cluster, deixe a configuração padrão Amazon DocumentDB Padrão.
-
Em Configuração da instância:
Em Classe de instância de banco de dados, escolha Classes otimizadas para memória (incluir classes r) (esse é o padrão).
A outra opção de instância são as classes baseadas em NVMe. Para saber mais, consulte Instâncias baseadas em NVMe.
Em Classe de instância, escolha o tipo de instância que atende às suas necessidades. Para obter uma explicação mais detalhada das classes de instância, consulte Especificações de classe de instância.
Em número de casos, escolha um número que melhor reflita suas necessidades. Lembre-se de que quanto menor o número, menor o custo e menor o volume de leitura/gravação que pode ser gerenciado pelo cluster.
-
Em Conectividade, mantenha a configuração padrão Não se conectar a um recurso computacional do EC2.
nota
A conexão com um recurso computacional do EC2 cria automaticamente grupos de segurança para a conexão com seu cluster. Como você criou manualmente esses grupos de segurança na etapa anterior, deverá selecionar Não se conectar a um recurso computacional do EC2 para não criar um segundo conjunto de grupos de segurança.
-
Na seção Autenticação, insira um nome de usuário para o usuário principal e escolha Autogerenciado. Insira uma senha e confirme-a.
Se, em vez disso, você escolher Gerenciado no AWS Secrets Manager, consulte Gerenciamento de senhas com o Amazon DocumentDB e AWS Secrets Manager para obter mais informações.
-
Selecione Criar cluster.
Etapa 4: conectar a sua instância do Amazon EC2
Para instalar o shell do MongoDB, você deve primeiro se conectar à sua instância do Amazon EC2. A instalação do shell do Mongo permite que você se conecte e consulte seu cluster do Amazon DocumentDB. Execute as etapas a seguir:
-
No console do Amazon EC2, navegue até suas instâncias e veja se a instância que você acabou de criar está em execução. Se for o caso, selecione a instância clicando no respectivo ID.
-
Selecione Conectar.
-
Você verá quatro guias de opções para seu método de conexão: Amazon EC2 Instance Connect, Session Manager, cliente SSH ou Console de Série do EC2. É necessário escolher um e seguir suas instruções. Ao concluir, escolha Conectar.
nota
Se seu endereço IP mudou depois que você iniciou essa demonstração ou se você estiver voltando ao seu ambiente posteriormente, atualize a regra de entrada do grupo de segurança demoEC2 para ativar o tráfego de entrada do seu novo endereço de API.
Etapa 5: instalação do shell do MongoDB
Agora o shell do MongoDB pode ser instalado. Ele é um utilitário de linha de comando que você usa para se conectar e consultar seu cluster do Amazon DocumentDB. Atualmente, existem duas versões do shell do MongoDB: a versão mais recente, mongosh, e a versão anterior, mongo shell.
Importante
Há uma limitação conhecida com os drivers de NodeJS de versão anterior a 6.13.1, que atualmente não têm mais suporte para autenticação de identidades do IAM para o Amazon DocumentDB. Os drivers e ferramentas do Node.js que usam o driver Node.js (por exemplo, mongosh) devem ser atualizados para usar a versão 6.13.1 ou mais recente do driver de Node.js.
Siga as instruções abaixo para instalar o shell do MongoDB em seu sistema operacional.
Etapa 6: gerenciar o Amazon DocumentDB TLS
Faça o download do certificado CA para o Amazon DocumentDB com o seguinte código: wget https://truststore.pki.rds.amazonaws.com/global/global-bundle.pem
nota
O Transport Layer Security (TLS) está habilitado por padrão para qualquer novo cluster do Amazon DocumentDB. Para obter mais informações, consulte Gerenciamento de configurações de TLS do cluster do Amazon DocumentDB.
Etapa 7: conectar ao cluster do Amazon DocumentDB
-
No console do Amazon DocumentDB, em Clusters, localize seu cluster. Escolha o cluster que você criou clicando no identificador do cluster desse cluster.
-
Na guia Conectividade e segurança, localize Conectar a este cluster com o shell mongo na caixa Conectar:
Copie a string de conexão fornecida e cole-a no terminal.
Faça as seguintes alterações:
Certifique-se de que o nome de usuário correto está na string.
Omita
<insertYourPassword>para que você seja solicitado a fornecer a senha pelo shell mongo ao se conectar.Opcional: se você estiver usando a autenticação do IAM ou a versão anterior do shell do MongoDB, modifique sua string de conexão da forma a seguir:
mongo --ssl --host mydocdbcluster.cluster-cozt4xr9xv9b.us-east-1.docdb.amazonaws.com:27017 --sslCAFile global-bundle.pem --username SampleUser1 --passwordSubstitua
mydocdbcluster.cluster-cozt4xr9xv9b.us-east-1pelas mesmas informações do seu cluster.
-
Pressione inserir no seu terminal. Agora você deverá fornecer sua senha. Insira a senha.
-
Ao inserir sua senha e ver o prompt
rs0 [direct: primary] <env-name>>, você se conecta com êxito ao seu cluster do Amazon DocumentDB.
Está tendo problemas para se conectar? Consulte Solução de problemas do Amazon DocumentDB.
Etapa 8: inserir e consultar dados
Agora que você está conectado ao seu cluster, pode executar algumas consultas para se familiarizar com o uso de um banco de dados de documentos.
-
Para inserir um único documento, digite o seguinte:
db.collection.insertOne({"hello":"DocumentDB"})Você obterá o seguinte resultado:
{ acknowledged: true, insertedId: ObjectId('673657216bdf6258466b128c') } -
É possível ler o documento que escreveu com o comando
findOne()(porque ele retorna apenas um único documento). Insira o seguinte:db.collection.findOne()Você obterá o seguinte resultado:
{ "_id" : ObjectId("5e401fe56056fda7321fbd67"), "hello" : "DocumentDB" } -
Para realizar mais algumas consultas, considere um caso de uso de perfis de jogos. Primeiro, insira algumas entradas em uma coleção intitulada
profiles. Insira o seguinte:db.profiles.insertMany([{ _id: 1, name: 'Matt', status: 'active', level: 12, score: 202 }, { _id: 2, name: 'Frank', status: 'inactive', level: 2, score: 9 }, { _id: 3, name: 'Karen', status: 'active', level: 7, score: 87 }, { _id: 4, name: 'Katie', status: 'active', level: 3, score: 27 } ])Você obterá o seguinte resultado:
{ acknowledged: true, insertedIds: { '0': 1, '1': 2, '2': 3, '3': 4 } } -
Use o
find()comando para retornar todos os documentos na coleção de perfis. Insira o seguinte:db.profiles.find()Você obterá um resultado que corresponderá aos dados digitados na Etapa 3.
-
Use uma consulta para um único documento por meio de um filtro. Insira o seguinte:
db.profiles.find({name: "Katie"})Você obterá o seguinte resultado:
{ "_id" : 4, "name" : "Katie", "status": "active", "level": 3, "score":27} -
Agora vamos tentar encontrar um perfil e modificá-lo usando o comando
findAndModify. Atribuiremos ao usuário Matt mais 10z pontos com o código a seguir:db.profiles.findAndModify({ query: { name: "Matt", status: "active"}, update: { $inc: { score: 10 } } })Você obtém o seguinte resultado (observe que a pontuação dele ainda não aumentou):
{ [{_id : 1, name : 'Matt', status: 'active', level: 12, score: 202}] -
É possível verificar se a pontuação dele mudou com a seguinte consulta:
db.profiles.find({name: "Matt"})Você obterá o seguinte resultado:
{ "_id" : 1, "name" : "Matt", "status" : "active", "level" : 12, "score" : 212 }
Etapa 9: explorar
Parabéns! Você concluiu com êxito o Guia de início rápido do Amazon DocumentDB.
E depois? Saiba como aproveitar totalmente esse poderoso banco de dados com alguns de seus atributos populares:
nota
Para economizar, é possível interromper seu cluster Amazon DocumentDB para reduzir custos ou excluir o cluster. Por padrão, após 30 minutos de inatividade, seu AWS Cloud9 ambiente interromperá a instância subjacente do Amazon EC2.