部署和连接 Cloud Databases 实例

目标

本教程将指导您部署Cloud Databases实例，并通过创建一个允许访问者输入单词及其定义的网页将其连接到网络前端。这些值随后会存储在运行于Cloud Databases数据库中。您可以使用 Terraform安装数据库基础架构，网络应用程序则使用流行的 Express框架。然后，应用程序可以在本地运行，也可以使用 Docker 运行。

提高生产力

要开始部署流程，请安装一些必备的生产力工具：

您需要有一个 IBM Cloud账户。
Node.js和 npm- 从公共 npm 注册表安装软件包
Terraform- 用于编码和部署基础设施
可选的 Docker- 用于非本地运行应用程序

获取API密钥，以便在您的账户中部署基础设施

按照这些步骤创建IBM CloudAPI 密钥，以便 Terraform 向您的账户提供基础设施。您最多可以创建 20 个 API 密钥。

出于安全原因，API 密钥仅在创建时才可复制或下载。如果 API 密钥丢失，必须创建新的 API 密钥。

复制项目

从Cloud Databases Hello World 项目GitHub存储库克隆项目。

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

安装基础设施

在此步骤中，您需要部署一个要使用的数据库服务实例。 GitHub存储库中包含各种Cloud Databases资源的文件夹。

从GitHub项目主文件夹，导航到所选的 terraform 服务文件夹，例如 mysql/terraform。
在计算机上创建一个名为 terraform.tfvars 的文档，其中包含以下字段：
```
ibmcloud_api_key = "<YOUR_API_KEY_FROM_STEP_1>"
region = "<YOUR_REGION>"
admin_password  = "<CREATE_15_CHARACTER_PASSWORD>"
```
文件 terraform.tfvars 包含的变量可能需要保密，因此会被GitHub仓库忽略。
使用以下命令安装基础设施：
```
terraform init
terraform apply --auto-approve
```
Terraform 脚本会输出运行应用程序所需的配置数据，因此请将其复制到根文件夹中：
```
terraform output -json >../config.json
```

在本地运行您的应用程序

要从本地计算机连接到数据库，请确保已进入服务文件夹，然后安装节点依赖项，并使用以下命令运行服务：
```
npm install
```
```
npm run start
```
如果成功，输出将显示您已连接：
```
#Connected!
#Server is listening on port 8080
```
打开浏览器，访问http://localhost:8080 浏览器窗口中会显示一个带有数据库徽标的欢迎页面。
要测试界面，请输入一个单词及其定义。数据对被添加到数据库中，并显示在页面底部的列表中。

从 Docker 容器运行应用程序（可选）

通过 Code Engine等服务托管应用程序的第一步是将应用程序代码装入Docker容器，并在其中运行。

确保您已登录Docker账户。在所选数据库的服务文件夹中，输入以下命令：
```
docker build -t database-hello-world:1.0 .
docker run -p 8080:8080 database-hello-world:1.0
```
打开浏览器，访问http://localhost:8080，查看与步骤 4 相同的欢迎页面。

恭喜您，您已经创建了一个带有前端的应用程序，可以将数据输入到您的Cloud Databases部署中！