Déploiement et connexion d'une instance Cloud Databases

Objectifs

Ce tutoriel vous guide dans le processus de déploiement d'une instance Cloud Databases et de sa connexion à un front-end web en créant une page web qui permet aux visiteurs d'entrer un mot et sa définition. Ces valeurs sont ensuite stockées dans une base de données fonctionnant sur Cloud Databases Vous installez l'infrastructure de la base de données à l'aide de Terraform et votre application web utilise le célèbre framework Express. L'application peut ensuite être exécutée localement, ou en utilisant Docker.

Commencer à être productif

Pour commencer le processus de déploiement, installez quelques outils de productivité indispensables :

Vous devez avoir un compte IBM Cloud.
Node.js et npm- pour installer des paquets à partir des registres publics de npm
Terraform- pour codifier et déployer l'infrastructure
Docker optionnel- pour exécuter votre application non localement

Obtenir une clé d'API pour déployer l'infrastructure sur votre compte

Suivez ces étapes pour créer une clé API IBM Cloud Qui permet à Terraform de provisionner l'infrastructure dans votre compte. Vous pouvez créer jusqu'à 20 clés d'API.

Pour des raisons de sécurité, la clé d'API ne peut être copiée ou téléchargée qu'au moment de sa création. Si la clé d'API est perdue, vous devez en créer une autre.

Cloner le projet

Clonez le projet à partir du dépôt GitHub Cloud Databases Hello World project GitHub repository.

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

Installer l'infrastructure

Dans cette étape, vous déployez une instance du service de base de données que vous souhaitez utiliser. Le dépôt GitHub contient des dossiers pour diverses ressources Cloud Databases

Depuis le dossier principal du projet GitHub, naviguez dans le dossier terraform service de votre choix, par exemple, mysql/terraform.
Sur votre machine, créez un document nommé terraform.tfvars, avec les champs suivants :
```
ibmcloud_api_key = "<YOUR_API_KEY_FROM_STEP_1>"
region = "<YOUR_REGION>"
admin_password  = "<CREATE_15_CHARACTER_PASSWORD>"
```
Le document terraform.tfvars contient des variables que vous souhaitez garder secrètes afin qu'elles soient ignorées par le dépôt GitHub.
Installez l'infrastructure à l'aide de la commande suivante :
```
terraform init
terraform apply --auto-approve
```
Le script Terraform fournit les données de configuration nécessaires à l'exécution de l'application, il faut donc le copier dans le dossier racine :
```
terraform output -json >../config.json
```

Exécutez votre application localement

Pour vous connecter à la base de données depuis votre machine locale, assurez-vous d'être dans votre dossier de services, puis installez les dépendances du nœud et exécutez le service avec les commandes suivantes :
```
npm install
```
```
npm run start
```
En cas de succès, la sortie indique que vous êtes connecté :
```
#Connected!
#Server is listening on port 8080
```
Ouvrez un navigateur et visitez le site http://localhost:8080. Vous êtes accueilli par une page de bienvenue avec le logo de la base de données qui s'affiche dans la fenêtre de votre navigateur.
Pour tester l'interface, entrez un mot et sa définition. La paire de données est ajoutée à la base de données et apparaît dans une liste au bas de la page.

Exécuter l'application à partir d'un conteneur Docker (optionnel)

La première étape pour héberger votre application à partir d'un service comme Code Engine est de conteneuriser le code de l'application dans un conteneur Docker et de l'exécuter à partir de là.

Assurez-vous d'être connecté à votre compte Docker. Dans le dossier de service de la base de données choisie, entrez la commande suivante :
```
docker build -t database-hello-world:1.0 .
docker run -p 8080:8080 database-hello-world:1.0
```
Ouvrez un navigateur et visitez http://localhost:8080 pour voir la même page de bienvenue que celle de l'étape 4.

Félicitations, vous avez créé une application avec un front-end qui alimente en données votre déploiement Cloud Databases!