Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # Connect tramite Amazon EC2 Questa sezione descrive come configurare la connettività tra un cluster Amazon DocumentDB e Amazon EC2 e accedere al cluster Amazon DocumentDB dall'istanza Amazon EC2. Esistono due opzioni per configurare la connessione EC2: + [Connetti automaticamente la tua istanza EC2 a un database Amazon DocumentDB](connect-ec2-auto.md): utilizza la funzionalità di connessione automatica nella console EC2 per configurare automaticamente la connessione tra l'istanza EC2 e un database Amazon DocumentDB nuovo o esistente. Questa connessione consente al traffico di viaggiare tra l'istanza EC2 e il database Amazon DocumentDB. Questa opzione viene in genere utilizzata per testare e creare nuovi gruppi di sicurezza. + [Connetti manualmente l'istanza EC2 al database Amazon DocumentDB](connect-ec2-manual.md): configura la connessione tra l'istanza EC2 e il database Amazon DocumentDB configurando e assegnando manualmente i gruppi di sicurezza per riprodurre la configurazione creata dalla funzionalità di connessione automatica. Questa opzione viene in genere utilizzata per modificare impostazioni più avanzate e utilizzare i gruppi di sicurezza esistenti. ## Prerequisiti Indipendentemente dall'opzione, e prima di creare il primo cluster Amazon DocumentDB, devi fare quanto segue: **Crea un account Amazon Web Services (AWS)** Prima di iniziare a utilizzare Amazon DocumentDB, devi disporre di un account Amazon Web Services (AWS). L' AWS account è gratuito. Paghi solo per i servizi e le risorse che utilizzi. Se non ne possiedi uno Account AWS, completa i seguenti passaggi per crearne uno. **Per iscriverti a un Account AWS** 1. Apri la [https://portal.aws.amazon.com/billing/registrazione.](https://portal.aws.amazon.com/billing/signup) 1. Segui le istruzioni online. Nel corso della procedura di registrazione riceverai una telefonata o un messaggio di testo e ti verrà chiesto di inserire un codice di verifica attraverso la tastiera del telefono. Quando ti iscrivi a un Account AWS, *Utente root dell'account AWS*viene creato un. L’utente root dispone dell’accesso a tutte le risorse e tutti i Servizi AWS nell’account. Come best practice di sicurezza, assegna l’accesso amministrativo a un utente e utilizza solo l’utente root per eseguire [attività che richiedono l’accesso di un utente root](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks). **Facoltativamente, imposta le autorizzazioni necessarie AWS Identity and Access Management (IAM).** L'accesso alla gestione delle risorse di Amazon DocumentDB come cluster, istanze e gruppi di parametri del cluster richiede credenziali che AWS possono essere utilizzate per autenticare le richieste. Per ulteriori informazioni, consulta [Identity and Access Management per Amazon DocumentDB](security-iam.md). 1. Nella barra di ricerca di Console di gestione AWS, digita IAM e seleziona **IAM** nel menu a discesa visualizzato. 1. Una volta che sei nella console IAM, seleziona **Utenti** dal pannello di navigazione. 1. Seleziona il tuo nome utente. 1. Fai clic sul pulsante **Aggiungi autorizzazioni**. 1. Seleziona **Attach existing policies directly (Collega direttamente le policy esistenti)**. 1. Digita `AmazonDocDBFullAccess` nella barra di ricerca e selezionala quando appare nei risultati della ricerca. 1. Fai clic sul pulsante blu in basso che dice **Avanti: revisione**. 1. Fai clic sul pulsante blu in basso che dice **Aggiungi autorizzazioni**. **Crea un Amazon Virtual Private Cloud (Amazon VPC)** A seconda dell'ambiente in cui Regione AWS ti trovi, potresti avere o meno un VPC predefinito già creato. Se non disponi di un VPC predefinito, completa il passaggio 1 della [Guida introduttiva ad Amazon VPC nella Amazon *VPC*](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-getting-started.html) User Guide. Questa operazione richiederà meno di cinque minuti. # Connect Amazon EC2 automaticamente **Topics** + [Connetti automaticamente un'istanza EC2 a un nuovo database Amazon DocumentDB](#auto-connect-ec2.process) + [Connetti automaticamente un'istanza EC2 a un database Amazon DocumentDB esistente](#auto-connect-ec2-existing-cluster) + [Panoramica della connettività automatica con un'istanza EC2](#auto-connect-ec2.overview) + [Visualizzazione delle risorse di calcolo connesse](#auto-connect-ec2.compute) Prima di configurare una connessione tra un'istanza EC2 e un nuovo database Amazon DocumentDB, assicurati di soddisfare i requisiti descritti in. [Panoramica della connettività automatica con un'istanza EC2](#auto-connect-ec2.overview) Se apporti modifiche ai gruppi di sicurezza dopo aver configurato la connettività, le modifiche potrebbero influire sulla connessione tra l'istanza EC2 e il database Amazon DocumentDB. **Nota** Puoi configurare automaticamente una connessione tra un'istanza EC2 e un database Amazon DocumentDB solo utilizzando. Console di gestione AWS Non puoi configurare automaticamente una connessione con l'API AWS CLI o Amazon DocumentDB. ## Connetti automaticamente un'istanza EC2 a un nuovo database Amazon DocumentDB Il processo seguente presuppone che tu abbia completato i passaggi indicati nell'[Prerequisiti](connect-ec2.md#connect-ec2-prerequisites)argomento. **Topics** + [Fase 1: creare un'istanza Amazon EC2](#auto-connect-ec2.launch-ec2-instance) + [Fase 2: creare un cluster Amazon DocumentDB](#auto-connect-ec2.launch-cluster) + [Fase 3: Connettiti alla tua istanza Amazon EC2](#manual-connect-ec2.connect) + [Passaggio 4: Installare la shell MongoDB](#auto-connect-ec2.install-mongo-shell) + [Fase 5: Gestione del TLS di Amazon DocumentDB](#auto-connect-ec2.tls) + [Fase 6: Connettiti al tuo cluster Amazon DocumentDB](#auto-connect-ec2.connect-use) + [Fase 7: Inserimento e interrogazione dei dati](#auto-cloud9-insert-query) + [Fase 8: Esplora](#auto-connect-ec2.explore) ### Fase 1: creare un'istanza Amazon EC2 In questa fase, creerai un'istanza Amazon EC2 nella stessa regione e Amazon VPC che utilizzerai successivamente per il provisioning del tuo cluster Amazon DocumentDB. 1. Sulla console Amazon EC2, scegli **Launch** instance. ![\[La sezione Launch instance sulla console Amazon EC2.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/ec2/launch-instance.png) 1. Inserisci un nome o un identificatore nel campo **Nome** situato nella sezione **Nome e tag**. 1. Nell'elenco a discesa **Amazon Machine Image (AMI)**, individua l'**AMI Amazon Linux 2** e selezionala. ![\[L'interfaccia delle immagini dell'applicazione e del sistema operativo con l'opzione AMI Amazon Linux 2 selezionata nella sezione Quick Start.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/ec2/linux2-ami.png) 1. Individua e scegli **t3.micro** nell'elenco a discesa del **tipo di istanza**. 1. Nella sezione **Key pair (login)**, inserisci l'identificatore di una coppia di chiavi esistente o scegli **Crea** nuova coppia di chiavi. ![\[L'interfaccia Key pair che mostra il campo del nome della coppia di chiavi e l'opzione Create new key pair.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/ec2/key-pair.png) È necessario fornire una coppia di chiavi Amazon EC2. + Se disponi di una coppia di chiavi Amazon EC2: 1. Seleziona una coppia di chiavi, scegli la tua coppia di chiavi dall'elenco. 1. Devi già avere il file della chiave privata (file.pem o .ppk) disponibile per accedere alla tua istanza Amazon EC2. + Se non disponi di una coppia di chiavi Amazon EC2: 1. Scegli **Crea nuova coppia di chiavi**, viene visualizzata la finestra di dialogo **Crea coppia di chiavi**. 1. Inserisci un nome nel campo **Nome della coppia di chiavi**. 1. Scegli il **tipo di coppia di chiavi** e il **formato del file della chiave privata**. 1. Scegliere **Create key pair** (Crea coppia di chiavi). ![\[L'interfaccia Create key pair con campi per il nome, il tipo e il formato del file della coppia di chiavi. Il pulsante Crea key pair si trova nell'angolo in basso a destra.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/ec2/create-key-pair.png) **Nota** Per motivi di sicurezza, consigliamo vivamente di utilizzare una coppia di chiavi per la connettività SSH e Internet all'istanza EC2. 1. **Facoltativo:** **nella **sezione Impostazioni di rete**, in **Firewall (gruppi di sicurezza)**, scegli Crea gruppo di sicurezza.** ![\[L'interfaccia delle impostazioni di rete mostra le opzioni per la creazione di un gruppo di sicurezza.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/ec2/firewall.png) Scegli **Crea gruppo di sicurezza** (controlla tutte le regole di autorizzazione al traffico che si applicano alla tua connettività EC2). **Nota** Se desideri utilizzare un gruppo di sicurezza esistente, segui le istruzioni riportate in[Connect Amazon EC2 manualmente](connect-ec2-manual.md). 1. Nella sezione **Riepilogo**, esamina la configurazione EC2 e scegli **Launch instance**, se corretta. ### Fase 2: creare un cluster Amazon DocumentDB Durante il provisioning dell'istanza Amazon EC2, crea il tuo cluster Amazon DocumentDB. 1. Accedi alla console Amazon DocumentDB e scegli **Clusters dal pannello** di navigazione. 1. Scegli **Create** (Crea). 1. Lascia l'impostazione del **tipo di cluster** sull'impostazione predefinita di **Instance Based** Cluster. 1. Nella **configurazione del cluster**, per l'**identificatore del cluster**, inserisci un nome univoco. Nota che la console cambierà tutti i nomi dei cluster in lettere minuscole indipendentemente da come vengono inseriti. **Lascia la **versione di Engine** al valore predefinito di 5.0.0.** 1. Per la **configurazione dello storage del cluster**, lascia l'impostazione predefinita di **Amazon DocumentDB Standard**. 1. Nella **configurazione dell'istanza**: + Per la **classe di istanza DB**, scegli **Classi ottimizzate per la memoria (include le classi r)** (questa è l'impostazione predefinita). L'altra opzione di istanza sono **le classi NVMe supportate**. Per ulteriori informazioni, consulta [Istanze supportate da NVMe](db-instance-nvme.md). + Per la **classe Instance**, scegli il tipo di istanza più adatto alle tue esigenze. Per una spiegazione più dettagliata delle classi di istanze, vedi[Specifiche della classe di istanza](db-instance-classes.md#db-instance-class-specs). + Per quanto riguarda **il numero di istanze**, scegli quello che meglio rispecchia le tue esigenze. Ricorda che più basso è il numero, minore è il costo e minore è il read/write volume che può essere gestito dal cluster. ![\[Interfaccia di configurazione con valori predefiniti per l'identificatore del cluster, la versione del motore e la classe di istanza, con il numero di istanze impostato su una.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/create-cluster/instance-config.png) 1. Per **Connettività**, scegli **Connetti a una risorsa di calcolo EC2**. Questa è l'istanza EC2 che hai creato nella Fase 1. ![\[Interfaccia di connettività con l'opzione Connect to an Compute Resource EC2 selezionata.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/ec2-connect.png) **Nota** La connessione a una risorsa di calcolo EC2 crea automaticamente un gruppo di sicurezza per la connessione delle risorse di calcolo EC2 al cluster Amazon DocumentDB. Una volta completata la creazione del cluster e desideri visualizzare il gruppo di sicurezza appena creato, vai all'elenco dei cluster e scegli l'identificatore del cluster. Nella scheda **Connettività e sicurezza**, vai a **Gruppi di sicurezza** e trova il tuo gruppo in **Nome del gruppo di sicurezza (ID)**. Conterrà il nome del tuo cluster e avrà un aspetto simile a questo:`docdb-ec2-docdb-2023-12-11-21-33-41:i-0e4bb09985d2bbc4c (sg-0238e0b0bf0f73877)`. 1. Nella sezione **Autenticazione**, inserisci un nome utente per l'utente principale, quindi scegli **Autogestito**. Inserisci una password, quindi confermala. Se invece hai scelto **Gestito in Gestione dei segreti AWS**, consulta [Gestione delle password con Amazon DocumentDB e Gestione dei segreti AWS](docdb-secrets-manager.md) per ulteriori informazioni. 1. Scegli **Crea cluster**. ### Fase 3: Connettiti alla tua istanza Amazon EC2 Per installare la shell mongo, devi prima connetterti alla tua istanza Amazon EC2. L'installazione della mongo shell ti consente di connetterti e interrogare il tuo cluster Amazon DocumentDB. Completa questa procedura: 1. Sulla console Amazon EC2, accedi alle tue istanze e verifica se l'istanza che hai appena creato è in esecuzione. In caso affermativo, seleziona l'istanza facendo clic sull'ID dell'istanza. ![\[Tabella delle istanze che elenca due istanze nella console Amazon EC2.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/ec2/ec2-instance-table.png) 1. Scegli **Connetti**. ![\[Riepilogo dell'istanza per un'istanza Amazon EC2. Il pulsante Connect si trova nell'angolo superiore destro.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/ec2/ec2-instance-summary.png) 1. Esistono quattro opzioni a schede per il metodo di connessione: Amazon EC2 Instance Connect, Session Manager, client SSH o console seriale EC2. Devi sceglierne una e seguirne le istruzioni. Al termine, scegli **Connect**. ![\[Interfaccia che mostra le opzioni di configurazione per il metodo di connessione EC2 Instance Connect.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/ec2/connect-options.png) **Nota** Se il tuo indirizzo IP è cambiato dopo aver iniziato questa procedura dettagliata o se torni al tuo ambiente in un secondo momento, devi aggiornare la regola in entrata del gruppo di `demoEC2` sicurezza per abilitare il traffico in entrata dal tuo nuovo indirizzo API. ### Passaggio 4: Installare la shell MongoDB Ora puoi installare la shell MongoDB, un'utilità da riga di comando che usi per connettere e interrogare il tuo cluster Amazon DocumentDB. Attualmente esistono due versioni della shell MongoDB: la versione più recente, mongosh, e la versione precedente, mongo shell. **Importante** Esiste una limitazione nota con i driver Node.js precedenti alla versione 6.13.1, che attualmente non sono supportati dall'autenticazione dell'identità IAM per Amazon DocumentDB. I driver e gli strumenti Node.js che utilizzano il driver Node.js (ad esempio, mongosh) devono essere aggiornati per utilizzare il driver Node.js versione 6.13.1 o successiva. Segui le istruzioni riportate di seguito per installare la shell MongoDB per il tuo sistema operativo. ------ #### [ On Amazon Linux ] **Per installare la shell MongoDB su Amazon Linux** Se *non* utilizzi l'autenticazione IAM e desideri utilizzare la shell MongoDB più recente (mongosh) per connetterti al tuo cluster Amazon DocumentDB, segui questi passaggi: 1. Crea il file del repository. Nella riga di comando dell'istanza EC2 che hai creato, esegui il seguente comando: ``` echo -e "[mongodb-org-5.0] \nname=MongoDB Repository\nbaseurl=https://repo.mongodb.org/yum/amazon/2023/mongodb-org/5.0/x86_64/\ngpgcheck=1 \nenabled=1 \ngpgkey=https://pgp.mongodb.com/server-5.0.asc" | sudo tee /etc/yum.repos.d/mongodb-org-5.0.repo ``` 1. Al termine, installa mongosh con una delle due seguenti opzioni di comando al prompt dei comandi: **Opzione 1**: se hai scelto Amazon Linux 2023 predefinito durante la configurazione di Amazon EC2, inserisci questo comando: ``` sudo yum install -y mongodb-mongosh-shared-openssl3 ``` **Opzione 2**: se hai scelto Amazon Linux 2 durante la configurazione di Amazon EC2, inserisci questo comando: ``` sudo yum install -y mongodb-mongosh ``` Se utilizzi l'autenticazione IAM, devi utilizzare la versione precedente della shell MongoDB (5.0) per connetterti al tuo cluster Amazon DocumentDB, segui questi passaggi: 1. Crea il file del repository. Nella riga di comando dell'istanza EC2 che hai creato, esegui il seguente comando: ``` echo -e "[mongodb-org-5.0] \nname=MongoDB Repository\nbaseurl=https://repo.mongodb.org/yum/amazon/2023/mongodb-org/5.0/x86_64/\ngpgcheck=1 \nenabled=1 \ngpgkey=https://pgp.mongodb.com/server-5.0.asc" | sudo tee /etc/yum.repos.d/mongodb-org-5.0.repo ``` 1. Al termine, installa la shell mongodb 5.0 con la seguente opzione di comando al prompt dei comandi: ``` sudo yum install -y mongodb-org-shell ``` ------ #### [ On Ubuntu ] **Per installare mongosh su Ubuntu** 1. Importa la chiave pubblica che verrà utilizzata dal sistema di gestione dei pacchetti. ``` curl -fsSL https://pgp.mongodb.com/server-5.0.asc | sudo gpg --dearmor -o /usr/share/keyrings/mongodb-server-5.0.gpg ``` 1. Crea l'elenco di file `mongodb-org-5.0.list` per MongoDB utilizzando il comando appropriato per la versione di Ubuntu. ``` echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-5.0.gpg ] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/5.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-5.0.list ``` 1. Importa e aggiorna il database locale dei pacchetti usando il seguente comando: ``` sudo apt-get update ``` 1. Installa mongosh. ``` sudo apt-get install -y mongodb-mongosh ``` Per informazioni sull'installazione di versioni precedenti di MongoDB nel sistema Ubuntu, consulta [Installazione di MongoDB Community Edition in Ubuntu](https://docs.mongodb.com/v3.6/tutorial/install-mongodb-on-ubuntu/). ------ #### [ On other operating systems ] Per installare la shell Mongo in altri sistemi operativi, vedi l'argomento relativo all'[installazione di MongoDB Community Edition](https://www.mongodb.com/docs/manual/administration/install-community/) nella documentazione relativa a MongoDB. ------ ### Fase 5: Gestione del TLS di Amazon DocumentDB Scarica il certificato CA per Amazon DocumentDB con il seguente codice: `wget https://truststore.pki.rds.amazonaws.com/global/global-bundle.pem` **Nota** Transport Layer Security (TLS) è abilitato di default per tutti i nuovi cluster Amazon DocumentDB. Per ulteriori informazioni, consulta [Gestione delle impostazioni TLS del cluster Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/security.encryption.ssl.html). ### Fase 6: Connettiti al tuo cluster Amazon DocumentDB 1. Nella console Amazon DocumentDB, in **Clusters, individua il cluster**. Scegli il cluster che hai creato facendo clic sull'**identificatore del cluster per quel** cluster. 1. Nella scheda **Connettività e sicurezza**, **individua Connect to this cluster with the mongo shell** nella casella **Connect**: ![\[Impostazioni di connessione al cluster con stringa di connessione MongoDB evidenziata per la connessione a un cluster Amazon DocumentDB utilizzando la shell mongo.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/connect-mongosh.png) Copia la stringa di connessione fornita e incollala nel tuo terminale. Apporta le seguenti modifiche: 1. Assicurati di avere il nome utente corretto nella stringa. 1. Ometti `` in modo che ti venga richiesta la password dalla shell mongo quando ti connetti. 1. Facoltativo: se utilizzi l'autenticazione IAM o utilizzi la versione precedente della shell MongoDB, modifica la stringa di connessione come segue: `mongo --ssl --host mydocdbcluster.cluster-cozt4xr9xv9b.us-east-1.docdb.amazonaws.com:27017 --sslCAFile global-bundle.pem --username SampleUser1 --password` Sostituiscilo `mydocdbcluster.cluster-cozt4xr9xv9b.us-east-1` con le stesse informazioni del tuo cluster. 1. Premi invio nel tuo terminale. Ora ti verrà richiesta la password. Inserisci la password. 1. Quando inserisci la password e riesci a visualizzare il `rs0 [direct: primary] >` prompt, sei connesso correttamente al tuo cluster Amazon DocumentDB. Hai problemi di connessione? Vedi [Risoluzione dei problemi di Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/troubleshooting.html). ### Fase 7: Inserimento e interrogazione dei dati Ora che sei connesso al cluster, puoi eseguire alcune query per acquisire familiarità con l'utilizzo di un database di documenti. 1. Per inserire un singolo documento, inserisci quanto segue: ``` db.collection.insertOne({"hello":"DocumentDB"}) ``` Otterrete il seguente risultato: ``` { acknowledged: true, insertedId: ObjectId('673657216bdf6258466b128c') } ``` 1. Puoi leggere il documento che hai scritto con il `findOne()` comando (perché restituisce solo un singolo documento). Inserisci quanto segue: ``` db.collection.findOne() ``` Si ottiene il seguente risultato: ``` { "_id" : ObjectId("5e401fe56056fda7321fbd67"), "hello" : "DocumentDB" } ``` 1. Per eseguire qualche altra domanda, considera un caso d'uso dei profili di gioco. Innanzitutto, inserisci alcune voci in una raccolta intitolata`profiles`. Inserisci quanto segue: ``` 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 } ]) ``` Si ottiene il seguente risultato: ``` { acknowledged: true, insertedIds: { '0': 1, '1': 2, '2': 3, '3': 4 } } ``` 1. Utilizzate il `find()` comando per restituire tutti i documenti nella raccolta dei profili. Inserisci quanto segue: ``` db.profiles.find() ``` Otterrai un output che corrisponderà ai dati che hai digitato nel passaggio 3. 1. Usa una query per un singolo documento usando un filtro. Inserisci quanto segue: ``` db.profiles.find({name: "Katie"}) ``` Si ottiene il seguente risultato: ``` { "_id" : 4, "name" : "Katie", "status": "active", "level": 3, "score":27} ``` 1. Ora proviamo a trovare un profilo e modificarlo usando il `findAndModify` comando. Daremo all'utente Matt altri 10 punti con il seguente codice: ``` db.profiles.findAndModify({ query: { name: "Matt", status: "active"}, update: { $inc: { score: 10 } } }) ``` Otterrete il seguente risultato (notate che il suo punteggio non è ancora aumentato): ``` { [{_id : 1, name : 'Matt', status: 'active', level: 12, score: 202}] ``` 1. Puoi verificare che il suo punteggio sia cambiato con la seguente domanda: `db.profiles.find({name: "Matt"})` Si ottiene il seguente risultato: ``` { "_id" : 1, "name" : "Matt", "status" : "active", "level" : 12, "score" : 212 } ``` ### Fase 8: Esplora Complimenti\$1 Hai completato con successo la Guida rapida ad Amazon DocumentDB. Qual è il prossimo passo? Scopri come sfruttare appieno questo potente database con alcune delle sue funzionalità più popolari: + [Gestione di Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/managing-documentdb.html) + [Dimensionamento](https://docs.aws.amazon.com/documentdb/latest/developerguide/operational_tasks.html) + [Backup e ripristino](https://docs.aws.amazon.com/documentdb/latest/developerguide/backup_restore.html) **Nota** Per risparmiare sui costi, puoi interrompere il cluster Amazon DocumentDB per ridurre i costi o eliminare il cluster. Per impostazione predefinita, dopo 30 minuti di inattività, l' AWS Cloud9 ambiente interromperà l'istanza Amazon EC2 sottostante. ## Connetti automaticamente un'istanza EC2 a un database Amazon DocumentDB esistente La procedura seguente presuppone che tu abbia un cluster Amazon DocumentDB esistente e un'istanza Amazon EC2 esistente. **Accedi al tuo cluster Amazon DocumentDB e configura la connessione Amazon EC2** 1. Accedi al tuo cluster Amazon DocumentDB. 1. [Accedi a e apri Console di gestione AWS la console Amazon DocumentDB all'indirizzo https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb) 1. Nel pannello di navigazione scegliere **Cluster**. **Suggerimento** Se il riquadro di navigazione non viene visualizzato sul lato sinistro della schermata, scegliere l'icona del menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/docdb-menu-icon.png)) nell'angolo in alto a sinistra della pagina. 1. Specificate il cluster che desiderate scegliendo il pulsante a sinistra del nome del cluster. 1. Configura la connessione Amazon EC2. 1. Scegli **Azioni**, quindi scegli **Configura connessione EC2**. ![\[L'elenco a discesa Azioni con l'opzione Configura connessione EC2 selezionata.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/ec2/setup-ec2-connect.png) Viene visualizzata la **finestra di dialogo Configura la connessione EC2.** 1. Nel campo dell'**istanza EC2**, scegli l'istanza EC2 che desideri connettere al tuo cluster. ![\[L'interfaccia di connessione Configura EC2 con l'elenco a discesa delle istanze EC2 evidenziato.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/ec2/setup-ec2-connect-dialog.png) 1. Scegli **Continua**. Viene visualizzata la finestra di **dialogo Rivedi e conferma**. 1. Assicurati che le modifiche siano corrette. Quindi scegli **Configura connessione**. ![\[L'interfaccia di revisione e conferma mostra il riepilogo delle modifiche. Il pulsante Configura connessione si trova nell'angolo in basso a destra.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/ec2/setup-ec2-review-confirm.png) In caso di esito positivo, viene visualizzata la seguente verifica: ![\[Messaggio di conferma per una corretta configurazione della connessione tra il database Amazon DocumentDB e l'istanza EC2.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/ec2/setup-ec2-connect-success.png) ## Panoramica della connettività automatica con un'istanza EC2 Quando configuri una connessione tra un'istanza EC2 e un database Amazon DocumentDB, Amazon DocumentDB configura automaticamente il gruppo di sicurezza VPC per l'istanza EC2 e per il database Amazon DocumentDB. Di seguito sono riportati i requisiti per connettere un'istanza EC2 con un database Amazon DocumentDB: + L'istanza EC2 deve esistere nello stesso VPC del database Amazon DocumentDB. Se nello stesso VPC non esistono istanze EC2, allora la console fornisce un collegamento per crearne una. + L'utente che configura la connettività deve disporre delle autorizzazioni per eseguire le seguenti operazioni Amazon EC2: + `ec2:AuthorizeSecurityGroupEgress` + `ec2:AuthorizeSecurityGroupIngress` + `ec2:CreateSecurityGroup` + `ec2:DescribeInstances` + `ec2:DescribeNetworkInterfaces` + `ec2:DescribeSecurityGroups` + `ec2:ModifyNetworkInterfaceAttribute` + `ec2:RevokeSecurityGroupEgress` Se l'istanza database e l'istanza EC2 si trovano in zone di disponibilità diverse, è possibile che all'account vengano addebitati costi tra zone di disponibilità. Quando configuri una connessione a un'istanza EC2, Amazon DocumentDB agisce in base alla configurazione corrente dei gruppi di sicurezza associati al database Amazon DocumentDB e all'istanza EC2, come descritto nella tabella seguente: | Configurazione attuale del gruppo di sicurezza di Amazon DocumentDB | Configurazione del gruppo di sicurezza EC2 corrente | Azione Amazon DocumentDB | | --- | --- | --- | | Esistono uno o più gruppi di sicurezza associati al database Amazon DocumentDB con un nome che corrisponde al modello. DocumentDB-ec2-n Un gruppo di sicurezza che corrisponde al modello non è stato modificato. Questo gruppo di sicurezza include una sola regola in uscita con il gruppo di sicurezza VPC dell'istanza EC2 come origine. | Esistono uno o più gruppi di sicurezza associati all'istanza EC2 con un nome che corrisponde al modello DocumentDB-ec2-n (dove n è un numero). Un gruppo di sicurezza che corrisponde al modello non è stato modificato. Questo gruppo di sicurezza ha una sola regola in uscita con il gruppo di sicurezza VPC del database Amazon DocumentDB come origine. | Amazon DocumentDB non esegue alcuna azione. Era già stata configurata automaticamente una connessione tra l'istanza EC2 e il database Amazon DocumentDB. Poiché esiste già una connessione tra l'istanza EC2 e il database Amazon DocumentDB, i gruppi di sicurezza non vengono modificati. | | Si applica una delle due condizioni seguenti: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/connect-ec2-auto.html) | Si applica una delle due condizioni seguenti: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/connect-ec2-auto.html) | Azione Amazon DocumentDB: creazione di nuovi gruppi di sicurezza | | Esistono uno o più gruppi di sicurezza associati al database Amazon DocumentDB con un nome che corrisponde al modello. DocumentDB-ec2-n Un gruppo di sicurezza che corrisponde al modello non è stato modificato. Questo gruppo di sicurezza include una sola regola in uscita con il gruppo di sicurezza VPC dell'istanza EC2 come origine. | Esistono uno o più gruppi di sicurezza associati all'istanza EC2 con un nome che corrisponde al modello ec2-DocumentDB-n. Tuttavia, Amazon DocumentDB non può utilizzare nessuno di questi gruppi di sicurezza per la connessione con il database Amazon DocumentDB. Amazon DocumentDB non può utilizzare un gruppo di sicurezza che non ha una regola in uscita con il gruppo di sicurezza VPC del database Amazon DocumentDB come origine. Amazon DocumentDB inoltre non può utilizzare un gruppo di sicurezza che è stato modificato. | Azione Amazon DocumentDB: creazione di nuovi gruppi di sicurezza | | Esistono uno o più gruppi di sicurezza associati al database Amazon DocumentDB con un nome che corrisponde al modello. DocumentDB-ec2-n Un gruppo di sicurezza che corrisponde al modello non è stato modificato. Questo gruppo di sicurezza include una sola regola in uscita con il gruppo di sicurezza VPC dell'istanza EC2 come origine. | Esiste un gruppo di sicurezza EC2 valido per la connessione, ma non è associato all'istanza EC2. Questo gruppo di sicurezza ha un nome che corrisponde al modello DocumentDB-ec2-n. Non è stato modificato. Ha una sola regola in uscita con il gruppo di sicurezza VPC del database Amazon DocumentDB come origine. | Azione Amazon DocumentDB: associazione del gruppo di sicurezza EC2 | | Si applica una delle due condizioni seguenti: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/connect-ec2-auto.html) | Esistono uno o più gruppi di sicurezza associati all'istanza EC2 con un nome che corrisponde al modello DocumentDB-ec2-n. Un gruppo di sicurezza che corrisponde al modello non è stato modificato. Questo gruppo di sicurezza ha una sola regola in uscita con il gruppo di sicurezza VPC del database Amazon DocumentDB come origine. | Azione Amazon DocumentDB: creazione di nuovi gruppi di sicurezza | **Azione Amazon DocumentDB: creazione di nuovi gruppi di sicurezza** Amazon DocumentDB esegue le seguenti azioni: + Crea un nuovo gruppo di sicurezza che corrisponde al modello `DocumentDB-ec2-n`. Questo gruppo di sicurezza include una regola in uscita con il gruppo di sicurezza VPC dell'istanza EC2 come origine. Questo gruppo di sicurezza è associato al database Amazon DocumentDB e consente all'istanza EC2 di accedere al database Amazon DocumentDB. + Crea un nuovo gruppo di sicurezza che corrisponde al modello `ec2-DocumentDB-n`. Questo gruppo di sicurezza ha una regola in uscita con il gruppo di sicurezza VPC del database Amazon DocumentDB come origine. Questo gruppo di sicurezza è associato all'istanza EC2 e consente all'istanza EC2 di inviare traffico al database Amazon DocumentDB. **Azione Amazon DocumentDB: associazione del gruppo di sicurezza EC2** Amazon DocumentDB associa il gruppo di sicurezza EC2 valido ed esistente all'istanza EC2. Questo gruppo di sicurezza consente all'istanza EC2 di inviare traffico al database Amazon DocumentDB. ## Visualizzazione delle risorse di calcolo connesse Puoi usare il Console di gestione AWS per visualizzare le risorse di calcolo connesse a un database Amazon DocumentDB. Le risorse mostrate includono le connessioni delle risorse di calcolo configurate automaticamente. È possibile configurare la connettività delle risorse di calcolo automaticamente nei modi seguenti: + È possibile selezionare la risorsa di calcolo quando si crea il database. Per ulteriori informazioni, consulta Creazione di un [Creazione di un cluster Amazon DocumentDB](db-cluster-create.md) cluster DB Multi-AZ. + È possibile configurare la connettività tra un database esistente e una risorsa di calcolo. Per ulteriori informazioni, consulta [Connect Amazon EC2 automaticamente](#connect-ec2-auto). Le risorse di calcolo elencate non includono quelle connesse al database manualmente. Ad esempio, è possibile consentire manualmente a una risorsa di calcolo di accedere a un database aggiungendo una regola al gruppo di sicurezza VPC associato al database. Per garantire la presenza della risorsa di calcolo nell'elenco, è necessario che siano soddisfatte le condizioni elencate di seguito. + Il nome del gruppo di sicurezza associato alla risorsa di calcolo corrisponde al modello `ec2-DocumentDB-n` (dove n è un numero). + Il gruppo di sicurezza associato alla risorsa di calcolo ha una regola in uscita con l'intervallo di porte impostato sulla porta utilizzata dal database Amazon DocumentDB. + Il gruppo di sicurezza associato alla risorsa di calcolo ha una regola in uscita con l'origine impostata su un gruppo di sicurezza associato al database Amazon DocumentDB. + Il nome del gruppo di sicurezza associato al database Amazon DocumentDB corrisponde al modello `DocumentDB-ec2-n` (dove n è un numero). + Il gruppo di sicurezza associato al database Amazon DocumentDB ha una regola in entrata con l'intervallo di porte impostato sulla porta utilizzata dal database Amazon DocumentDB. + Il gruppo di sicurezza associato al database Amazon DocumentDB ha una regola in entrata con l'origine impostata su un gruppo di sicurezza associato alla risorsa di calcolo. **Per visualizzare le risorse di calcolo connesse a un database Amazon DocumentDB** 1. [Accedi a e apri Console di gestione AWS la console Amazon DocumentDB all'indirizzo https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb) 1. Nel riquadro di navigazione, scegli **Database**, quindi scegli il nome del database Amazon DocumentDB. 1. Nella scheda **Connettività e sicurezza**, visualizza le risorse di calcolo nella sezione Risorse di **calcolo connesse**. # Connect Amazon EC2 manualmente **Topics** + [Fase 1: creare un'istanza Amazon EC2](#manual-connect-ec2.launch-ec2-instance) + [Fase 2: creazione di un gruppo di sicurezza](#manual-connect-ec2.security-group) + [Fase 3: creare un cluster Amazon DocumentDB](#manual-connect-ec2.launch-cluster) + [Fase 4: Connettiti alla tua istanza Amazon EC2](#manual-connect-ec2.connect) + [Passaggio 5: Installare la shell MongoDB](#manual-connect-ec2.install-mongo-shell) + [Fase 6: Gestione del TLS di Amazon DocumentDB](#manual-connect-ec2.tls) + [Fase 7: Connettiti al tuo cluster Amazon DocumentDB](#manual-connect-ec2.connect-use) + [Fase 8: Inserimento e interrogazione dei dati](#manual-cloud9-insert-query) + [Fase 9: Esplora](#manual-connect-ec2.explore) I passaggi seguenti presuppongono che tu abbia completato i passaggi indicati nell'[Prerequisiti](connect-ec2.md#connect-ec2-prerequisites)argomento. ## Fase 1: creare un'istanza Amazon EC2 In questa fase, creerai un'istanza Amazon EC2 nella stessa regione e Amazon VPC che utilizzerai successivamente per il provisioning del tuo cluster Amazon DocumentDB. 1. Sulla console Amazon EC2, scegli **Launch** instance. ![\[La sezione Launch instance sulla console Amazon EC2.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/ec2/launch-instance.png) 1. Inserisci un nome o un identificatore nel campo **Nome** situato nella sezione **Nome e tag**. 1. Nell'elenco a discesa **Amazon Machine Image (AMI)**, individua l'**AMI Amazon Linux 2** e selezionala. ![\[L'interfaccia delle immagini dell'applicazione e del sistema operativo con l'opzione AMI Amazon Linux 2 selezionata nella sezione Quick Start.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/ec2/linux2-ami.png) 1. Individua e scegli **t3.micro** nell'elenco a discesa del **tipo di istanza**. 1. Nella sezione **Key pair (login)**, inserisci l'identificatore di una coppia di chiavi esistente o scegli **Crea** nuova coppia di chiavi. ![\[L'interfaccia Key pair che mostra il campo del nome della coppia di chiavi e l'opzione Create new key pair.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/ec2/key-pair.png) È necessario fornire una coppia di chiavi Amazon EC2. + Se disponi di una coppia di chiavi Amazon EC2: 1. Seleziona una coppia di chiavi, scegli la tua coppia di chiavi dall'elenco. 1. Devi già avere il file della chiave privata (file.pem o .ppk) disponibile per accedere alla tua istanza Amazon EC2. + Se non disponi di una coppia di chiavi Amazon EC2: 1. Scegli **Crea nuova coppia di chiavi**, viene visualizzata la finestra di dialogo **Crea coppia di chiavi**. 1. Inserisci un nome nel campo **Nome della coppia di chiavi**. 1. Scegli il **tipo di coppia di chiavi** e il **formato del file della chiave privata**. 1. Scegliere **Create key pair** (Crea coppia di chiavi). ![\[L'interfaccia Create key pair con campi per il nome, il tipo e il formato del file della coppia di chiavi. Il pulsante Crea key pair si trova nell'angolo in basso a destra.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/ec2/create-key-pair.png) **Nota** Per motivi di sicurezza, consigliamo vivamente di utilizzare una coppia di chiavi per la connettività SSH e Internet all'istanza EC2. 1. Nella **sezione Impostazioni di rete**, in **Firewall (gruppi di sicurezza)**, scegli **Crea gruppo di sicurezza o **Seleziona** gruppo di sicurezza** esistente. ![\[L'interfaccia delle impostazioni di rete mostra le opzioni per la creazione di un gruppo di sicurezza.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/ec2/firewall.png) Se hai scelto di selezionare un gruppo di sicurezza esistente, selezionane uno dall'elenco a discesa **Gruppi di sicurezza comuni**. Se hai scelto di creare un nuovo gruppo di sicurezza, procedi come segue: 1. Controlla tutte le regole di autorizzazione al traffico che si applicano alla tua connettività EC2. 1. Nel campo IP, scegli Il **mio IP** o seleziona **Personalizzato** per scegliere da un elenco di blocchi CIDR, elenchi di prefissi o gruppi di sicurezza. Non consigliamo **Anywhere** come scelta, a meno che l'istanza EC2 non si trovi su una rete isolata, perché consente a qualsiasi indirizzo IP di accedere alla tua istanza EC2. ![\[Il menu a discesa My IP.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/ec2/ip-field.png) 1. Nella sezione **Riepilogo**, esamina la configurazione EC2 e scegli **Launch instance, se corretta**. ## Fase 2: creazione di un gruppo di sicurezza Ora creerai un nuovo gruppo di sicurezza nel tuo Amazon VPC predefinito. Il gruppo di sicurezza `demoDocDB` consente di connettersi al cluster Amazon DocumentDB sulla porta 27017 (la porta predefinita per Amazon DocumentDB) dall'istanza Amazon EC2. 1. Nella [Console di gestione Amazon EC2](https://console.aws.amazon.com/ec2), in **Rete e sicurezza**, scegli Gruppi di **sicurezza**. ![\[Pannello di navigazione della console Amazon DocumentDB con l'opzione Gruppi di sicurezza selezionata nel menu a discesa Rete e sicurezza.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/ec2/nav-security-groups.png) 1. Scegliere **Create Security Group** (Crea gruppo di sicurezza). ![\[Il pulsante Crea gruppo di sicurezza.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/ec2/create-sg-btn-2.png) 1. Nella sezione **Dettagli di base**: 1. In **Security group name (Nome gruppo di sicurezza)** immettere `demoDocDB`. 1. In **Description (Descrizione)**, inserire una descrizione. 1. Per **VPC**, accetta l'utilizzo del tuo VPC predefinito. 1. Nella sezione **Regole in entrata**, scegliere **Aggiungi regola**. 1. Per **Tipo**, scegli **Regola TCP personalizzata** (impostazione predefinita). 1. Per **Intervallo di porte**, immettete`27017`. 1. In **Source (Origine)**, scegliere **Custom (Personalizzata)**. Nel campo accanto, cerca il gruppo di sicurezza che hai appena creato nel passaggio 1. Potrebbe essere necessario aggiornare il browser per consentire alla console Amazon EC2 di compilare automaticamente il nome sorgente. ![\[Sezione sulle regole in entrata che mostra i campi per tipo, protocollo, intervallo di porte, origine e descrizione. Il pulsante Aggiungi regola si trova nell'angolo in basso a sinistra.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/ec2/inbound-rules.png) 1. **Accetta tutte le altre impostazioni predefinite e scegli Crea gruppo di sicurezza.** ![\[Il pulsante Crea gruppo di sicurezza.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/ec2/create-sg-btn-2.png) ## Fase 3: creare un cluster Amazon DocumentDB Durante il provisioning dell'istanza Amazon EC2, creerai il tuo cluster Amazon DocumentDB. 1. Accedi alla console Amazon DocumentDB e scegli **Clusters dal pannello** di navigazione. 1. Scegli **Create** (Crea). 1. Lascia l'impostazione del **tipo di cluster** sull'impostazione predefinita di **Instance Based** Cluster. 1. Nella **configurazione del cluster**, per l'**identificatore del cluster**, inserisci un nome univoco. Nota che la console cambierà tutti i nomi dei cluster in lettere minuscole indipendentemente da come vengono inseriti. **Lascia la **versione di Engine** al valore predefinito di 5.0.0.** 1. Per la **configurazione dello storage del cluster**, lascia l'impostazione predefinita di **Amazon DocumentDB Standard**. 1. Nella **configurazione dell'istanza**: + Per la **classe di istanza DB**, scegli **Classi ottimizzate per la memoria (include le classi r)** (questa è l'impostazione predefinita). L'altra opzione di istanza sono **le classi NVMe supportate**. Per ulteriori informazioni, consulta [Istanze supportate da NVMe](db-instance-nvme.md). + Per la **classe Instance**, scegli il tipo di istanza più adatto alle tue esigenze. Per una spiegazione più dettagliata delle classi di istanze, vedi[Specifiche della classe di istanza](db-instance-classes.md#db-instance-class-specs). + Per quanto riguarda **il numero di istanze**, scegli quello che meglio rispecchia le tue esigenze. Ricorda che più basso è il numero, minore è il costo e minore è il read/write volume che può essere gestito dal cluster. ![\[Interfaccia di configurazione con valori predefiniti per l'identificatore del cluster, la versione del motore e la classe di istanza, con il numero di istanze impostato su una.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/create-cluster/instance-config.png) 1. Per la **connettività**, lascia l'impostazione predefinita di **Non connetterti a una risorsa di calcolo EC2**. **Nota** La connessione a una risorsa di calcolo EC2 crea automaticamente gruppi di sicurezza per la connessione al cluster. Poiché hai creato manualmente questi gruppi di sicurezza nel passaggio precedente, dovresti selezionare **Non connetterti a una risorsa di calcolo EC2** per non creare un secondo set di gruppi di sicurezza. 1. Nella sezione **Autenticazione**, inserisci un nome utente per l'utente principale, quindi scegli **Autogestito**. Inserisci una password, quindi confermala. Se invece hai scelto **Gestito in Gestione dei segreti AWS**, consulta [Gestione delle password con Amazon DocumentDB e Gestione dei segreti AWS](docdb-secrets-manager.md) per ulteriori informazioni. 1. Scegli **Crea cluster**. ## Fase 4: Connettiti alla tua istanza Amazon EC2 La connessione alla tua istanza Amazon EC2 ti consentirà di installare la shell MongoDB. L'installazione della mongo shell ti consente di connetterti e interrogare il tuo cluster Amazon DocumentDB. Completa questa procedura: 1. Sulla console Amazon EC2, accedi alle tue istanze e verifica se l'istanza che hai appena creato è in esecuzione. In caso affermativo, seleziona l'istanza facendo clic sull'ID dell'istanza. ![\[Tabella delle istanze che elenca due istanze sulla console Amazon EC2.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/ec2/ec2-instance-table.png) 1. Scegli **Connetti**. ![\[Riepilogo dell'istanza per un'istanza Amazon EC2. Il pulsante Connect si trova nell'angolo superiore destro.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/ec2/ec2-instance-summary.png) 1. Esistono quattro opzioni a schede per il metodo di connessione: Amazon EC2 Instance Connect, Session Manager, client SSH o console seriale EC2. Devi sceglierne una e seguirne le istruzioni. Al termine, scegli **Connect**. ![\[Interfaccia che mostra le opzioni di configurazione per il metodo di connessione EC2 Instance Connect.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/ec2/connect-options.png) **Nota** Se il tuo indirizzo IP è cambiato dopo aver iniziato questa procedura dettagliata o se torni al tuo ambiente in un secondo momento, devi aggiornare la regola in entrata del gruppo di `demoEC2` sicurezza per abilitare il traffico in entrata dal tuo nuovo indirizzo API. ## Passaggio 5: Installare la shell MongoDB Ora puoi installare la shell MongoDB, un'utilità da riga di comando che usi per connettere e interrogare il tuo cluster Amazon DocumentDB. Attualmente esistono due versioni della shell MongoDB: la versione più recente, mongosh, e la versione precedente, mongo shell. **Importante** Esiste una limitazione nota con i driver Node.js precedenti alla versione 6.13.1, che attualmente non sono supportati dall'autenticazione dell'identità IAM per Amazon DocumentDB. I driver e gli strumenti Node.js che utilizzano il driver Node.js (ad esempio, mongosh) devono essere aggiornati per utilizzare il driver Node.js versione 6.13.1 o successiva. Segui le istruzioni riportate di seguito per installare la shell MongoDB per il tuo sistema operativo. ------ #### [ On Amazon Linux ] **Per installare la shell MongoDB su Amazon Linux** Se *non* utilizzi IAM e desideri utilizzare la shell MongoDB più recente (mongosh) per connetterti al tuo cluster Amazon DocumentDB, segui questi passaggi: 1. Crea il file del repository. Nella riga di comando dell'istanza EC2 che hai creato, esegui il seguente comando: ``` echo -e "[mongodb-org-5.0] \nname=MongoDB Repository\nbaseurl=https://repo.mongodb.org/yum/amazon/2023/mongodb-org/5.0/x86_64/\ngpgcheck=1 \nenabled=1 \ngpgkey=https://pgp.mongodb.com/server-5.0.asc" | sudo tee /etc/yum.repos.d/mongodb-org-5.0.repo ``` 1. Al termine, installa mongosh con una delle due seguenti opzioni di comando al prompt dei comandi: **Opzione 1**: se hai scelto Amazon Linux 2023 predefinito durante la configurazione di Amazon EC2, inserisci questo comando: ``` sudo yum install -y mongodb-mongosh-shared-openssl3 ``` **Opzione 2**: se hai scelto Amazon Linux 2 durante la configurazione di Amazon EC2, inserisci questo comando: ``` sudo yum install -y mongodb-mongosh ``` Se utilizzi IAM, devi utilizzare la versione precedente della shell MongoDB (5.0) per connetterti al tuo cluster Amazon DocumentDB, segui questi passaggi: 1. Crea il file del repository. Nella riga di comando dell'istanza EC2 che hai creato, esegui il seguente comando: ``` echo -e "[mongodb-org-5.0] \nname=MongoDB Repository\nbaseurl=https://repo.mongodb.org/yum/amazon/2023/mongodb-org/5.0/x86_64/\ngpgcheck=1 \nenabled=1 \ngpgkey=https://pgp.mongodb.com/server-5.0.asc" | sudo tee /etc/yum.repos.d/mongodb-org-5.0.repo ``` 1. Al termine, installa la shell mongodb 5.0 con la seguente opzione di comando al prompt dei comandi: ``` sudo yum install -y mongodb-org-shell ``` ------ #### [ On Ubuntu ] **Per installare mongosh su Ubuntu** 1. Importa la chiave pubblica che verrà utilizzata dal sistema di gestione dei pacchetti. ``` curl -fsSL https://pgp.mongodb.com/server-5.0.asc | sudo gpg --dearmor -o /usr/share/keyrings/mongodb-server-5.0.gpg ``` 1. Crea l'elenco di file `mongodb-org-5.0.list` per MongoDB utilizzando il comando appropriato per la versione di Ubuntu. ``` echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-5.0.gpg ] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/5.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-5.0.list ``` 1. Importa e aggiorna il database locale dei pacchetti usando il seguente comando: ``` sudo apt-get update ``` 1. Installa mongosh. ``` sudo apt-get install -y mongodb-mongosh ``` Per informazioni sull'installazione di versioni precedenti di MongoDB nel sistema Ubuntu, consulta [Installazione di MongoDB Community Edition in Ubuntu](https://docs.mongodb.com/v3.6/tutorial/install-mongodb-on-ubuntu/). ------ #### [ On other operating systems ] Per installare la shell Mongo in altri sistemi operativi, vedi l'argomento relativo all'[installazione di MongoDB Community Edition](https://www.mongodb.com/docs/manual/administration/install-community/) nella documentazione relativa a MongoDB. ------ ## Fase 6: Gestione del TLS di Amazon DocumentDB Scarica il certificato CA per Amazon DocumentDB con il seguente codice: `wget https://truststore.pki.rds.amazonaws.com/global/global-bundle.pem` **Nota** Transport Layer Security (TLS) è abilitato di default per tutti i nuovi cluster Amazon DocumentDB. Per ulteriori informazioni, consulta [Gestione delle impostazioni TLS del cluster Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/security.encryption.ssl.html). ## Fase 7: Connettiti al tuo cluster Amazon DocumentDB 1. Nella console Amazon DocumentDB, in **Clusters, individua il cluster**. Scegli il cluster che hai creato facendo clic sull'**identificatore del cluster per quel** cluster. ![\[Elenco di cluster Amazon DocumentDB che mostra un cluster regionale con i dettagli dell'istanza principale.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/cluster-connect-choose.png) 1. Nella scheda **Connettività e sicurezza**, **individua Connect to this cluster with the mongo shell** nella casella **Connect**: ![\[Impostazioni di connessione al cluster con stringa di connessione MongoDB evidenziata per la connessione a un cluster Amazon DocumentDB utilizzando la shell mongo.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/connect-mongosh.png) Copia la stringa di connessione fornita e incollala nel tuo terminale. Apporta le seguenti modifiche: 1. Assicurati di avere il nome utente corretto nella stringa. 1. Ometti `` in modo che ti venga richiesta la password dalla shell mongo quando ti connetti. 1. Facoltativo: se utilizzi l'autenticazione IAM o utilizzi la versione precedente della shell MongoDB, modifica la stringa di connessione come segue: `mongo --ssl --host mydocdbcluster.cluster-cozt4xr9xv9b.us-east-1.docdb.amazonaws.com:27017 --sslCAFile global-bundle.pem --username SampleUser1 --password` Sostituiscilo `mydocdbcluster.cluster-cozt4xr9xv9b.us-east-1` con le stesse informazioni del tuo cluster. 1. Premi invio nel tuo terminale. Ora ti verrà richiesta la password. Inserisci la password. 1. Quando inserisci la password e riesci a visualizzare il `rs0 [direct: primary] >` prompt, sei connesso correttamente al tuo cluster Amazon DocumentDB. Hai problemi di connessione? Vedi [Risoluzione dei problemi di Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/troubleshooting.html). ## Fase 8: Inserimento e interrogazione dei dati Ora che sei connesso al cluster, puoi eseguire alcune query per acquisire familiarità con l'utilizzo di un database di documenti. 1. Per inserire un singolo documento, inserisci quanto segue: ``` db.collection.insertOne({"hello":"DocumentDB"}) ``` Otterrete il seguente risultato: ``` { acknowledged: true, insertedId: ObjectId('673657216bdf6258466b128c') } ``` 1. Puoi leggere il documento che hai scritto con il `findOne()` comando (perché restituisce solo un singolo documento). Inserisci quanto segue: ``` db.collection.findOne() ``` Si ottiene il seguente risultato: ``` { "_id" : ObjectId("5e401fe56056fda7321fbd67"), "hello" : "DocumentDB" } ``` 1. Per eseguire qualche altra domanda, considera un caso d'uso dei profili di gioco. Innanzitutto, inserisci alcune voci in una raccolta intitolata`profiles`. Inserisci quanto segue: ``` 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 } ]) ``` Si ottiene il seguente risultato: ``` { acknowledged: true, insertedIds: { '0': 1, '1': 2, '2': 3, '3': 4 } } ``` 1. Utilizzate il `find()` comando per restituire tutti i documenti nella raccolta dei profili. Inserisci quanto segue: ``` db.profiles.find() ``` Otterrai un output che corrisponderà ai dati che hai digitato nel passaggio 3. 1. Usa una query per un singolo documento usando un filtro. Inserisci quanto segue: ``` db.profiles.find({name: "Katie"}) ``` Si ottiene il seguente risultato: ``` { "_id" : 4, "name" : "Katie", "status": "active", "level": 3, "score":27} ``` 1. Ora proviamo a trovare un profilo e modificarlo usando il `findAndModify` comando. Daremo all'utente Matt altri 10 punti con il seguente codice: ``` db.profiles.findAndModify({ query: { name: "Matt", status: "active"}, update: { $inc: { score: 10 } } }) ``` Otterrete il seguente risultato (notate che il suo punteggio non è ancora aumentato): ``` { [{_id : 1, name : 'Matt', status: 'active', level: 12, score: 202}] ``` 1. Puoi verificare che il suo punteggio sia cambiato con la seguente domanda: `db.profiles.find({name: "Matt"})` Si ottiene il seguente risultato: ``` { "_id" : 1, "name" : "Matt", "status" : "active", "level" : 12, "score" : 212 } ``` ## Fase 9: Esplora Complimenti\$1 Hai completato con successo la Guida rapida ad Amazon DocumentDB. Qual è il prossimo passo? Scopri come sfruttare appieno questo potente database con alcune delle sue funzionalità più popolari: + [Gestione di Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/managing-documentdb.html) + [Dimensionamento](https://docs.aws.amazon.com/documentdb/latest/developerguide/operational_tasks.html) + [Backup e ripristino](https://docs.aws.amazon.com/documentdb/latest/developerguide/backup_restore.html) **Nota** Per risparmiare sui costi, puoi interrompere il cluster Amazon DocumentDB per ridurre i costi o eliminare il cluster. Per impostazione predefinita, dopo 30 minuti di inattività, l' AWS Cloud9 ambiente interromperà l'istanza Amazon EC2 sottostante.