Implementación y conexión de una instancia de Cloud Databases

Objetivos

Este tutorial le guiará a través del proceso de despliegue de una instancia Cloud Databases y su conexión a un front-end web mediante la creación de una página web que permita a los visitantes introducir una palabra y su definición. Estos valores se almacenan en una base de datos que se ejecuta en Cloud Databases. Usted instala la infraestructura de base de datos mediante Terraform y su aplicación web utiliza el popular framework Express. A continuación, la aplicación puede ejecutarse localmente o mediante Docker.

Conseguir productividad

Para comenzar el proceso de despliegue, instale algunas herramientas de productividad imprescindibles:

Debes tener una cuenta en IBM Cloud.
Node.js y npm- para instalar paquetes desde registros npm públicos
Terraform- para codificar y desplegar infraestructuras
Docker opcional- para ejecutar su aplicación de forma no local

Obtener una clave de API para desplegar la infraestructura en su cuenta

Sigue estos pasos para crear una IBM Cloud Que permite a Terraform aprovisionar infraestructura en tu cuenta. Puede crear hasta 20 claves de API.

Por motivos de seguridad, la clave de API sólo está disponible para copiarse o descargarse en el momento de la creación. Si se pierde la clave de API, deberá crear una nueva clave de API.

Clonar el proyecto

Clona el proyecto de Cloud Databases Repositorio GitHub del proyecto Hello World.

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

Instalar la infraestructura

En este paso se despliega una instancia del servicio de base de datos que se desea utilizar. El repositorio GitHub contiene carpetas para varios recursos Cloud Databases.

Desde la carpeta principal del proyecto GitHub, navega a la carpeta de servicios terraform de tu elección, por ejemplo, mysql/terraform.
En su máquina, cree un documento llamado terraform.tfvars, con los siguientes campos:
```
ibmcloud_api_key = "<YOUR_API_KEY_FROM_STEP_1>"
region = "<YOUR_REGION>"
admin_password  = "<CREATE_15_CHARACTER_PASSWORD>"
```
El documento « terraform.tfvars » contiene variables que quizá quieras mantener en secreto, por lo que el repositorio « GitHub » lo ignora.
Instala la infraestructura con el siguiente comando :
```
terraform init
terraform apply --auto-approve
```
El script Terraform genera los datos de configuración necesarios para ejecutar la aplicación, así que cópialos en la carpeta raíz:
```
terraform output -json >../config.json
```

Ejecutar la aplicación localmente

Para conectarte a la base de datos desde tu máquina local, asegúrate de que estás en tu carpeta de servicio, luego instala las dependencias del nodo y ejecuta el servicio con los siguientes comandos:
```
npm install
```
```
npm run start
```
Si tiene éxito, la salida muestra que está conectado:
```
#Connected!
#Server is listening on port 8080
```
Abra un navegador y visite http://localhost:8080 Aparecerá una página de bienvenida con el logotipo de la base de datos en la ventana del navegador.
Para probar la interfaz, introduzca una palabra y su definición. El par de datos se añade a la base de datos y aparece en una lista en la parte inferior de la página.

Ejecutar la aplicación desde un contenedor de Docker (opcional)

El primer paso para alojar su aplicación desde un servicio como Code Engine es contenerizar el código de la aplicación dentro de un contenedor Docker y ejecutarlo desde allí.

Asegúrese de haber iniciado sesión en su cuenta Docker. En la carpeta de servicio de la base de datos elegida, introduzca el siguiente comando:
```
docker build -t database-hello-world:1.0 .
docker run -p 8080:8080 database-hello-world:1.0
```
Abra un navegador y visite http://localhost:8080 para ver la misma página de bienvenida del paso 4.

Enhorabuena, has creado una app con un front-end que alimenta de datos tu despliegue Cloud Databases