Distribuire un'app Web Node.js + MongoDB in Azure

Il Servizio app di Azure offre un servizio di hosting Web con scalabilità elevata e applicazione automatica di patch basato sul sistema operativo Linux. Questa esercitazione illustra come creare un'app Node.js sicura in app Azure Servizio connesso a un database Azure Cosmos DB per MongoDB. Al termine, si avrà un'app Express.js in esecuzione nel servizio app Azure in Linux.

Questo articolo presuppone che si abbia già familiarità con lo sviluppo di Node.js e che Node e MongoDB siano installati in locale. È anche necessario un account Azure con una sottoscrizione attiva. Se non si ha un account Azure, è possibile crearne uno gratuitamente.

Applicazione di esempio

Per seguire questa esercitazione, clonare o scaricare l'applicazione di esempio dal repository https://github.com/Azure-Samples/msdocs-nodejs-mongodb-azure-sample-app.

git clone https://github.com/Azure-Samples/msdocs-nodejs-mongodb-azure-sample-app.git

Se si vuole eseguire l'applicazione in locale, eseguire le operazioni seguenti:

• Installare le dipendenze del pacchetto eseguendo npm install.
• Copiare il .env.sample file .env in e popolare il valore DATABASE_URL con l'URL mongoDB, ad esempio mongodb://localhost:27017/.
• Avviare l'applicazione usando npm start.
• Per visualizzare l'app, passare a http://localhost:3000.

1. Creare servizio app e Azure Cosmos DB

In questo passaggio si creano le risorse di Azure. I passaggi usati in questa esercitazione creano un set di risorse sicure per impostazione predefinita che includono servizio app e Azure Cosmos DB per MongoDB. Per il processo di creazione, specificare:

• Nome dell'app Web. È il nome usato come parte del nome DNS per l'app Web sotto forma di https://<app-name>.azurewebsites.net.
• Area in cui eseguire l'app fisicamente nel mondo.
• Stack di runtime per l'app. È la posizione in cui si seleziona la versione di Node da usare per l'app.
• Piano di hosting per l'app. Si tratta del piano tariffario che include il set di funzionalità e la capacità di ridimensionamento per l'app.
• Gruppo di risorse per l'app. Un gruppo di risorse consente di raggruppare (in un contenitore logico) tutte le risorse di Azure necessarie per l'applicazione.

Per creare risorse del Servizio app di Azure, accedere al portale di Azure e seguire questa procedura.

2. Configurare la connettività del database

La creazione guidata ha generato automaticamente l'URI di MongoDB, ma l'app necessita di una DATABASE_URL variabile e di una DATABASE_NAME variabile. In questo passaggio si creano le impostazioni dell'app con il formato necessario per l'app.

3. Distribuire il codice di esempio

In questo passaggio si configurerà la distribuzione di GitHub usando GitHub Actions. È solo uno dei molti modi per eseguire la distribuzione nel servizio app, ma anche un ottimo modo per avere l'integrazione continua nel processo di distribuzione. Per impostazione predefinita, ogni git push al repository GitHub avvia l'azione di compilazione e distribuzione.

4. Passare all'app

5. Trasmettere i log di diagnostica

Il Servizio app di Azure acquisisce tutti i messaggi archiviati nella console per facilitare la diagnosi dei problemi con l'applicazione. L'app di esempio restituisce messaggi di log della console in ognuno dei relativi endpoint per illustrare questa funzionalità. Ad esempio, l'endpoint get restituisce un messaggio sul numero di attività recuperate dal database e viene visualizzato un messaggio di errore in caso di errore.

router.get('/', function(req, res, next) {
  Task.find()
    .then((tasks) => {      
      const currentTasks = tasks.filter(task => !task.completed);
      const completedTasks = tasks.filter(task => task.completed === true);

      console.log(`Total tasks: ${tasks.length}   Current tasks: ${currentTasks.length}    Completed tasks:  ${completedTasks.length}`)
      res.render('index', { currentTasks: currentTasks, completedTasks: completedTasks });
    })
    .catch((err) => {
      console.log(err);
      res.send('Sorry! Something went wrong.');
    });
});

6. Esaminare i file distribuiti usando Kudu

app Azure Servizio fornisce una console di diagnostica basata sul Web denominata Kudu che consente di esaminare l'ambiente di hosting del server per l'app Web. Con Kudu è possibile visualizzare i file distribuiti in Azure, esaminare la cronologia di distribuzione dell'applicazione e anche aprire una sessione SSH nell'ambiente di hosting.

7. Pulire le risorse

Al termine, è possibile eliminare tutte le risorse dalla sottoscrizione di Azure eliminando il gruppo di risorse.

Domande frequenti

• Quanto costa questa configurazione?
• Ricerca per categorie connettersi al server Azure Cosmos DB protetto dietro la rete virtuale con altri strumenti?
• Come funziona lo sviluppo di app locali con GitHub Actions?
• Perché la distribuzione di GitHub Actions è così lenta?

Quanto costa questa configurazione?

I prezzi per le risorse di creazione sono i seguenti:

• Il piano di servizio app viene creato nel livello Basic e può essere ridimensionato verso l'alto o verso il basso. Vedere Prezzi del servizio app.
• Il server Azure Cosmos DB viene creato in una singola area e può essere distribuito in altre aree. Vedere Prezzi di Azure Cosmos DB.
• La rete virtuale non comporta alcun addebito a meno che non si configurino funzionalità aggiuntive, ad esempio il peering. Vedere Prezzi della rete virtuale di Azure.
• La zona DNS privata comporta un piccolo addebito. Vedere Prezzi di DNS di Azure.

Ricerca per categorie connettersi al server Azure Cosmos DB protetto dietro la rete virtuale con altri strumenti?

• Per l'accesso di base da uno strumento da riga di comando, è possibile eseguire mongosh dal terminale SSH dell'app. Il contenitore dell'app non è disponibile con mongosh, quindi è necessario installarlo manualmente. Tenere presente che il client installato non persiste tra i riavvii dell'app.
• Per connettersi da un client con interfaccia utente grafica MongoDB, il computer deve trovarsi all'interno della rete virtuale. Ad esempio, potrebbe trattarsi di una macchina virtuale di Azure connessa a una delle subnet o di un computer in una rete locale con una connessione VPN da sito a sito con la rete virtuale di Azure.
• Per connettersi dalla shell MongoDB dalla pagina di gestione di Azure Cosmos DB nel portale, il computer deve trovarsi anche all'interno della rete virtuale. È invece possibile aprire il firewall del server Azure Cosmos DB per l'indirizzo IP del computer locale, ma aumenta la superficie di attacco per la configurazione.

Come funziona lo sviluppo di app locali con GitHub Actions?

Prendere il file del flusso di lavoro generato automaticamente dal servizio app come esempio, ognigit push avvia una nuova esecuzione di compilazione e distribuzione. Da un clone locale del repository GitHub si effettua il push degli aggiornamenti desiderati in GitHub. Ad esempio:

git add .
git commit -m "<some-message>"
git push origin main

Perché la distribuzione di GitHub Actions è così lenta?

Il file del flusso di lavoro generato automaticamente da servizio app definisce l'esecuzione di due processi, build-then-deploy. Poiché ogni processo viene eseguito nel proprio ambiente pulito, il file del flusso di lavoro garantisce che il deploy processo abbia accesso ai file dal build processo:

• Al termine del build processo, caricare i file come artefatti.
• All'inizio del deploy processo scaricare gli artefatti.

La maggior parte del tempo impiegato dal processo a due processi viene impiegato per caricare e scaricare gli artefatti. Se si vuole, è possibile semplificare il file del flusso di lavoro combinando i due processi in uno, eliminando così la necessità di eseguire i passaggi di caricamento e download.

Passaggi successivi