Implementação e conexão de uma instância do Cloud Databases

Objetivos

Este tutorial o orienta no processo de implantação de uma instância Cloud Databases e na conexão com um front-end da Web, criando uma página da Web que permite aos visitantes inserir uma palavra e sua definição. Esses valores são então armazenados em um banco de dados executado em Cloud Databases. Você instala a infraestrutura do banco de dados usando o Terraform e seu aplicativo Web usa a popular estrutura Express. O aplicativo pode então ser executado localmente ou usando o Docker.

Entrando em ação

Para iniciar o processo de implementação, instale algumas ferramentas de produtividade indispensáveis:

  • Você precisa ter uma conta no IBM Cloud.
  • Node.js e npm- para instalar pacotes de registros públicos do npm
  • Terraform- para codificar e implementar a infraestrutura
  • Docker opcional- para executar seu aplicativo de forma não local

Obtenha uma chave de API para implementar infraestrutura em sua conta

Siga estas etapas para criar uma chave de API IBM Cloud Que permite que o Terraform provisione a infraestrutura em sua conta. É possível criar até 20 chaves API.

Por motivos de segurança, a chave API está disponível apenas para ser copiada ou transferida por download no momento da criação. Se a chave API for perdida, uma nova chave API deverá ser criada.

Clonar o projeto

Clone o projeto a partir do Cloud Databases Repositório GitHub do projeto Hello World.

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

Instalar a infraestrutura

Nesta etapa, você implementa uma instância do serviço de banco de dados que deseja usar. O repositório GitHub contém pastas para vários recursos Cloud Databases.

  1. Na pasta principal do projeto GitHub, navegue até a pasta de serviço terraform de sua escolha, por exemplo, mysql/terraform.

  2. Em seu computador, crie um documento chamado terraform.tfvars, com os seguintes campos:

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

    O documento terraform.tfvars contém variáveis que você talvez queira manter em sigilo; por isso, ele é ignorado pelo repositório GitHub.

  3. Instale a infraestrutura com o seguinte comando:

    terraform init
terraform apply --auto-approve

    O script Terraform gera os dados de configuração necessários para executar o aplicativo, portanto, copie-o para a pasta raiz:

    terraform output -json >../config.json

Execute seu aplicativo localmente

  1. Para se conectar ao banco de dados a partir do computador local, verifique se você está na pasta de serviços, instale as dependências do nó e execute o serviço com os seguintes comandos:

    npm install

    npm run start

    Se for bem-sucedido, a saída mostrará que você está conectado:

    #Connected!
#Server is listening on port 8080

  2. Abra um navegador e acesse http://localhost:8080 Você é recebido por uma página de boas-vindas com um logotipo do banco de dados exibido na janela do navegador.

  3. Para testar a interface, digite uma palavra e sua definição. O par de dados é adicionado ao banco de dados e aparece em uma lista na parte inferior da página.

Execute o aplicativo em um contêiner Docker (opcional)

A primeira etapa para hospedar seu aplicativo em um serviço como o Code Engine é colocar o código do aplicativo em um contêiner Docker e executá-lo a partir dele.

  1. Verifique se você está conectado à sua conta Docker. Na pasta de serviço do banco de dados escolhido, digite o seguinte comando:

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

  2. Abra um navegador e acesse http://localhost:8080 para ver a mesma página de boas-vindas da Etapa 4.

Parabéns, você criou um aplicativo com um front-end que alimenta os dados em sua implantação Cloud Databases!