Obiettivi

Questa esercitazione guida l'utente attraverso il processo di distribuzione di un'istanza Cloud Databases e la connessione a un front-end web, creando una pagina web che consenta ai visitatori di inserire una parola e la sua definizione. Questi valori vengono poi memorizzati in un database in esecuzione su Cloud Databases. Si installa l'infrastruttura del database utilizzando Terraform e l'applicazione web utilizza il popolare framework Express. L'applicazione può quindi essere eseguita localmente o utilizzando Docker.

Diventare produttivi

Per iniziare il processo di distribuzione, installate alcuni strumenti di produttività indispensabili:

• È necessario disporre di un accountIBM Cloud.
• Node.js e npm- per installare i pacchetti dai registri pubblici di npm
• Terraform- per codificare e distribuire l'infrastruttura
• Docker opzionale: per eseguire l'applicazione non in locale

Ottenere una chiave API per distribuire l'infrastruttura sul proprio account

Seguire questi passaggi per creare una chiave API IBM Cloud Che consente a Terraform di fornire l'infrastruttura al proprio account. Puoi creare fino a 20 chiavi API.

Per motivi di sicurezza, la chiave API è disponibile per essere copiata o scaricata solo durante la fase di creazione. Se la chiave API viene persa, dovrai crearne una nuova.

Clonare il progetto

Clonare il progetto dal Cloud Databases Del progetto Hello World GitHub.

git clone https://github.com/IBM-Cloud/clouddatabases-helloworld-examples.git

Installare l'infrastruttura

In questo passaggio, si distribuisce un'istanza del servizio di database che si desidera utilizzare. Il repository GitHub contiene cartelle per varie risorse Cloud Databases.

1. Dalla cartella principale del progetto GitHub, navigare nella cartella dei servizi terraform di vostra scelta, ad esempio, mysql/terraform.

2. Sul computer, creare un documento denominato terraform.tfvars, con i seguenti campi:

   ibmcloud_api_key = "<YOUR_API_KEY_FROM_STEP_1>"
   region = "<YOUR_REGION>"
   admin_password  = "<CREATE_15_CHARACTER_PASSWORD>"
   

   Il documento " terraform.tfvars " contiene variabili che potresti voler mantenere riservate, pertanto viene ignorato dal repository " GitHub ".

3. Installa l'infrastruttura con il seguente comando:

   terraform init
   terraform apply --auto-approve
   

   Lo script Terraform fornisce i dati di configurazione necessari per l'esecuzione dell'applicazione, quindi copiarli nella cartella principale:

   terraform output -json >../config.json
   

Eseguire l'applicazione in locale

1. Per connettersi al database dal computer locale, assicurarsi di trovarsi nella cartella dei servizi, quindi installare le dipendenze del nodo ed eseguire il servizio con i seguenti comandi:

   npm install
   

   npm run start
   

   In caso di successo, l'output mostra che si è connessi:

   #Connected!
   #Server is listening on port 8080
   

2. Aprite un browser e visitate http://localhost:8080 L'utente viene accolto da una pagina di benvenuto con il logo del database che viene visualizzato nella finestra del browser.

3. Per testare l'interfaccia, inserite una parola e la sua definizione. La coppia di dati viene aggiunta al database e appare in un elenco in fondo alla pagina.

Eseguire l'applicazione da un contenitore Docker (opzionale)

Il primo passo verso l'hosting dell'applicazione da un servizio come Code Engine consiste nel containerizzare il codice dell'applicazione all'interno di un contenitore Docker ed eseguirlo da lì.

1. Assicuratevi di aver effettuato l'accesso al vostro account Docker. Nella cartella dei servizi del database scelto, inserite il seguente comando:

   docker build -t database-hello-world:1.0 .
   docker run -p 8080:8080 database-hello-world:1.0
   

2. Aprite un browser e visitate il sito http://localhost:8080 per visualizzare la stessa pagina di benvenuto del passaggio 4.

Congratulazioni, avete creato un'applicazione con un front-end che alimenta i dati nella vostra distribuzione Cloud Databases!