Conecte a Amazon EC2 manualmente - Amazon DocumentDB
Etapa 1: criar uma EC2 instância da AmazonEtapa 2: Criar um grupo de segurançaEtapa 3: criar um cluster do Amazon DocumentDBEtapa 4: Conecte-se à sua EC2 instância AmazonEtapa 5: Instalar o shell do mongoEtapa 6: Gerenciar o Amazon DocumentDB TLS Etapa 7: Conectar ao cluster do Amazon DocumentDBEtapa 8: Inserir e consultar dadosEtapa 9: Explorar

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

Conecte a Amazon EC2 manualmente

As etapas a seguir pressupõem que você tenha concluído as etapas do Pré-requisitos tópico.

Etapa 1: criar uma EC2 instância da Amazon

Nesta etapa, você criará uma EC2 instância da Amazon na mesma região e na mesma Amazon VPC que você usará posteriormente para provisionar seu cluster Amazon DocumentDB.

  1. No EC2 console da Amazon, escolha Launch instance.

    Launch instance button with dropdown and Migrate a server option in AWS EC2 interface.

  2. Insira um nome ou identificador no campo Nome, localizado na seção Nome e tags.

  3. Na lista suspensa Amazon Machine Image (AMI), localize o Amazon Linux 2 AMI e escolha-o.

    Application and OS Images selection interface with Quick Start options for various operating systems.

  4. Localize e escolha t3.micro na lista suspensa Tipo de instância.

    Instance type dropdown showing t3.micro with 2 vCPU, 1 GiB memory, and pricing details.

  5. Na seção Par de chaves (login), insira o identificador de um par de chaves existente ou escolha Criar novo par de chaves.

    Key pair selection dropdown with option to create a new key pair for secure instance connection.

    Você deve fornecer um par de EC2 chaves da Amazon.

    Se você tiver um par de EC2 chaves da Amazon:

    1. Selecione um par de chaves, escolha seu par de chaves na lista.

    2. Você já deve ter o arquivo de chave privada (arquivo.pem ou .ppk) disponível para fazer login na sua instância da Amazon. EC2

    Se você não tiver um par de EC2 chaves da Amazon:

    1. Escolha Criar novo par de chaves, a caixa de diálogo Criar par de chaves é exibida.

    2. Insira um nome no campo Nome do par de chaves.

    3. Escolha o tipo de par de chaves e o formato de arquivo de chave privada.

    4. Escolha Create key pair (Criar par de chaves).

    Create key pair dialog with options for name, type, and private key file format.
    nota

    Para fins de segurança, é altamente recomendável usar um par de chaves para conexão com a Internet SSH e sua instância. EC2

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

    Network settings interface showing VPC, subnet, IP, and security group options.

    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:

    1. Verifique todas as regras de permissão de tráfego que se aplicam à sua EC2 conectividade.

    2. No campo IP, escolha Meu IP ou selecione Personalizado para escolher entre uma lista de CIDR blocos, listas de prefixos ou grupos de segurança. Não recomendamos Anywhere como opção, a menos que sua EC2 instância esteja em uma rede isolada, pois ela permite que qualquer endereço IP acesse sua EC2 instância.

    Text field displaying an IP address with a dropdown arrow.

  7. Na seção Resumo, revise sua EC2 configuração e escolha Launch instance, se estiver correto. Edite grupos de segurança.

    EC2 instance summary showing configuration details and free tier information.

Etapa 2: Criar um grupo de segurança

Agora você criará um novo grupo de segurança em sua Amazon padrãoVPC. 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 da Amazon. EC2

  1. No Amazon EC2 Management Console, em Rede e segurança, escolha Grupos de segurança.

    Navigation menu showing Network & Security options including Security Groups.

  2. Escolha Create security group (Criar grupo de segurança).

    Orange button labeled "Create security group" for initiating the process.

  3. Na seção Detalhes básicos:

    1. Em Nome do grupo de segurança, insira demoDocDB.

    2. Em Descrição, insira uma descrição.

    3. Para VPC, aceite o uso do seu padrãoVPC.

    Security group configuration form with name, description, and VPC selection fields.

  4. Na seção Regras de entrada, escolha Adicionar regra.

    1. Em Tipo, escolha TCPRegra personalizada.

    2. Para Port Range, insira 27017.

    3. Para Destino escolha Personalizado. No campo ao lado, procure o grupo de segurança que você acabou de chamardemoEC2. Talvez seja necessário atualizar seu navegador para que o EC2 console da Amazon preencha automaticamente o nome da demoEC2 fonte.

    Inbound rules configuration interface showing custom TCP rule for port 27017.

  5. Aceite todos os outros padrões e escolha Criar grupo de segurança.

    Orange button labeled "Create security group" for creating a new security group.

Etapa 3: criar um cluster do Amazon DocumentDB

Enquanto a EC2 instância da Amazon estiver sendo provisionada, você criará seu cluster Amazon DocumentDB.

  1. Navegue até o console do Amazon DocumentDB e escolha Clusters no painel de navegação.

    Navigation pane showing Dashboard, Clusters, Performance Insights, and Snapshots options.

  2. Escolha Criar.

    Orange button labeled "Create" for initiating a new item or process.

  3. Deixe a configuração do tipo de cluster como padrão de cluster baseado em instância.

    Cluster type selection with Instance Based Cluster option highlighted.

  4. Para Número de instâncias, escolha 1. Isso minimizará o custo. Deixe as outras configurações como padrão.

    Configuration form with cluster identifier, engine version, instance class, and number of instances.

  5. Em Conectividade, deixe a configuração padrão de Não se conectar a um recurso EC2 computacional.

    Connectivity options for compute resources, with "Don't connect to an EC2 compute resource" selected.
    nota

    A conexão com um recurso EC2 computacional cria automaticamente grupos de segurança para sua conexão de recursos EC2 computacionais com seu cluster. Como você criou manualmente esses grupos de segurança na etapa anterior, selecione Não se conectar a um recurso EC2 computacional para não criar um segundo conjunto de grupos de segurança.

  6. Em Autenticação, insira as credenciais de login. Importante: você precisará das credenciais de login para autenticar seu cluster em uma etapa posterior.

    Authentication form with username and password fields, including input requirements.

  7. Ative Mostrar configurações avançadas.

    Estimated hourly cost for DocumentDB instance with toggle for advanced settings and Create cluster button.

  8. Na seção Configurações de rede, para grupos VPC de segurança da Amazon, escolha demoDocDB.

    Network settings panel showing VPC, subnet group, and security group options for a cluster.

  9. Selecione Criar cluster.

    Orange button labeled "Create cluster" for initiating cluster creation process.

Etapa 4: Conecte-se à sua EC2 instância Amazon

Para instalar o shell mongo, você deve primeiro se conectar à sua EC2 instância da Amazon. A instalação do shell do Mongo permite que você se conecte e consulte seu cluster do Amazon DocumentDB. Execute as etapas a seguir:

  1. No EC2 console da Amazon, navegue até suas instâncias e veja se a instância que você acabou de criar está em execução. Se estiver, selecione a instância clicando no ID da instância.

    EC2 console showing two instances, one stopped and one running, with details like ID and type.

  2. Selecione Conectar.

    Instance summary showing details like ID, IP addresses, state, and other configuration information.

  3. Há quatro opções com guias para seu método de conexão: Amazon EC2 Instance Connect, Session Manager, SSH cliente ou console EC2 serial. Você deve escolher um e seguir suas instruções. Ao concluir, escolha Connect.

    EC2 Instance Connect interface showing connection options and instance details.
nota

Se o seu endereço IP mudou depois que você iniciou este passo a passo, ou se você estiver voltando ao seu ambiente posteriormente, atualize a regra de entrada do grupo de demoEC2 segurança para ativar o tráfego de entrada do seu novo endereço. API

Etapa 5: Instalar o shell do mongo

O shell do Mongo é um utilitário de linha de comando que você usa para se conectar e consultar seu cluster do Amazon DocumentDB. Siga as instruções abaixo para instalar o shell do Mongo em seu sistema operacional.

On Amazon Linux
Para instalar o shell do Mongo no Amazon Linux

  1. Crie o arquivo do repositório. Na linha de comando da sua EC2 instância, execute o seguinte comando:

    echo -e "[mongodb-org-5.0] \nname=MongoDB Repository\nbaseurl=https://repo.mongodb.org/yum/amazon/2/mongodb-org/5.0/x86_64/\ngpgcheck=1 \nenabled=1 \ngpgkey=https://www.mongodb.org/static/pgp/server-5.0.asc" | sudo tee /etc/yum.repos.d/mongodb-org-5.0.repo

  2. Quando estiver concluído, instale o shell do Mongo executando o seguinte comando:

    sudo yum install -y mongodb-org-shell
On Ubuntu 18.04
Para instalar o shell do Mongo no Ubuntu 18.04

  1. Importe a chave pública que será usada pelo sistema de gerenciamento de pacotes.

    sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 2930ADAE8CAF5059EE73BB4B58712A2291FA4AD5

  2. Crie o arquivo de lista /etc/apt/sources.list.d/mongodb-org-3.6.list para o MongoDB usando o comando apropriado para a versão do Ubuntu.

    Ubuntu 18.04

    echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu xenial/mongodb-org/3.6 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-3.6.list
    nota

    O comando acima instalará o shell do Mongo 3.6 para Bionic e Xenial.

  3. Recarregue o banco de dados do pacote local usando o seguinte comando:

    sudo apt-get update

  4. Instale o shell do MongoDB.

    sudo apt-get install -y mongodb-org-shell

Para obter informações sobre como instalar versões anteriores do MongoDB no sistema do Ubuntu, consulte Instalar o MongoDB Community Edition no Ubuntu.

 

On other operating systems

Para instalar o shell do Mongo em outros sistemas operacionais, consulte Instalar o MongoDB Community Edition na documentação do MongoDB.

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 Amazon DocumentDB. Para obter mais informações, consulte Gerenciando as configurações de cluster TLS do Amazon DocumentDB.

Etapa 7: Conectar ao cluster do Amazon DocumentDB

  1. No console do Amazon DocumentDB, em Clusters, localize seu cluster. Escolha o cluster que você criou clicando no identificador do cluster.

    DocumentDB cluster list showing one cluster with identifier, role, version, region, and status.

  2. Na guia Conectividade e segurança, localize Conectar a este cluster com o shell mongo na caixa Conectar:

    Command to connect to a MongoDB cluster using mongo shell with SSL and authentication details.

    Copie a string de conexão fornecida e cole-a em seu terminal.

    Faça as seguintes alterações:

    1. Verifique se você tem o nome de usuário correto na string.

    2. Omita <insertYourPassword> para que você seja solicitado a fornecer a senha pelo shell mongo ao se conectar.

    Sua string de conexão deve ser semelhante a esta:

    mongo --ssl host docdb-2020-02-08-14-15-11. cluster.region.docdb.amazonaws.com:27107 --sslCAFile global-bundle.pem --username demoUser --password

  3. Pressione enter no seu terminal. Agora você será solicitado a fornecer sua senha. Insira a senha.

  4. Ao inserir sua senha e ver a rs0:PRIMARY> solicitação, você se conecta com sucesso ao seu cluster 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.

  1. Para inserir um único documento, digite o seguinte:

    db.collection.insert({"hello":"DocumentDB"})

  2. Você obterá o seguinte resultado:

    WriteResult({ "nInserted" : 1 })

  3. É possível ler o documento que escreveu com o comando findOne() (porque ele retorna apenas um único documento). Insira o seguinte:

    db.collection.findOne()

  4. Você obterá o seguinte resultado:

    { "_id" : ObjectId("5e401fe56056fda7321fbd67"), "hello" : "DocumentDB" }

  5. 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}
            ])

  6. Você obterá o seguinte resultado:

    { "acknowledged" : true, "insertedIds" : [ 1, 2, 3, 4 ] }

  7. Use o find() comando para retornar todos os documentos na coleção de perfis. Insira o seguinte:

    db.profiles.find()

  8. Você obterá um resultado que corresponderá aos dados digitados na Etapa 5.

  9. Use uma consulta para um único documento por meio de um filtro. Insira o seguinte:

    db.profiles.find({name: "Katie"})

  10. Você deve obter este resultado:

    { "_id" : 4, "name" : "Katie", "status": "active", "level": 3, "score":27}

  11. Agora vamos tentar encontrar um perfil e modificá-lo usando o comando findAndModify. Atribuiremos ao usuário Matt mais dez pontos com o seguinte código:

    
    db.profiles.findAndModify({
        query: { name: "Matt", status: "active"},
        update: { $inc: { score: 10 } }
    })

  12. 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
    }

  13. É possível verificar se a pontuação dele mudou com a seguinte consulta:

    db.profiles.find({name: "Matt"})

  14. 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 EC2 instância subjacente da Amazon.