Cloud Databases 인스턴스 배포 및 연결

목표

이 튜토리얼에서는 방문자가 단어와 그 정의를 입력할 수 있는 웹 페이지를 만들어 Cloud Databases 인스턴스를 배포하고 이를 웹 프런트엔드에 연결하는 과정을 안내합니다. 이러한 값은 Cloud Databases 실행되는 데이터베이스에 저장됩니다. Terraform을 사용하여 데이터베이스 인프라를 설치하고 웹 애플리케이션은 널리 사용되는 Express 프레임워크를 사용합니다. 그런 다음 애플리케이션을 로컬에서 실행하거나 Docker 사용하여 실행할 수 있습니다.

생산성 향상

배포 프로세스를 시작하려면 몇 가지 필수 생산성 도구를 설치하세요:

  • IBM Cloud 계정이 있어야 합니다.
  • Node.js 및 npm- 공용 npm 레지스트리에서 패키지 설치하기
  • Terraform- 인프라를 코드화 및 배포하기 위해
  • 선택 사항인 Docker- 애플리케이션을 비로컬로 실행하는 경우

인프라를 사용자 계정에 배치하기 위한 API 키 얻기

다음 단계에 따라 IBM Cloud 생성하세요 API 키를 생성하면 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 리소스에 대한 폴더가 있습니다.

  1. 기본 GitHub 프로젝트 폴더에서 원하는 terraform 서비스 폴더(예: mysql/terraform)로 이동합니다.

  2. 컴퓨터에서 다음 필드가 포함된 terraform.tfvars 이름의 문서를 만듭니다:

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

    terraform.tfvars 문서에는 비밀로 유지해야 할 변수들이 포함되어 있으므로, GitHub 저장소에서는 이 문서를 무시합니다.

  3. 다음 명령어를 사용하여 인프라를 설치하십시오:

    terraform init
terraform apply --auto-approve

    Terraform 스크립트는 애플리케이션을 실행하는 데 필요한 구성 데이터를 출력하므로 루트 폴더에 복사합니다:

    terraform output -json >../config.json

로컬에서 앱 실행

  1. 로컬 컴퓨터에서 데이터베이스에 연결하려면 서비스 폴더에 있는지 확인한 다음 노드 종속성을 설치하고 다음 명령을 사용하여 서비스를 실행합니다:

    npm install

    npm run start

    성공하면 출력에 연결되었다는 메시지가 표시됩니다:

    #Connected!
#Server is listening on port 8080

  2. 브라우저를 열고 http://localhost:8080합니다. 브라우저 창에 데이터베이스 로고가 표시된 환영 페이지가 나타납니다.

  3. 인터페이스를 테스트하려면 단어와 그 정의를 입력합니다. 데이터 쌍이 데이터베이스에 추가되고 페이지 하단의 목록에 표시됩니다.

Docker 컨테이너에서 앱 실행(선택 사항)

Code Engine 같은 서비스에서 애플리케이션을 호스팅하기 위한 첫 번째 단계는 앱 코드를 Docker 컨테이너에 컨테이너화하여 거기에서 실행하는 것입니다.

  1. Docker 계정에 로그인했는지 확인하세요. 선택한 데이터베이스의 서비스 폴더에 다음 명령을 입력합니다:

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

  2. 브라우저를 열고 http://localhost:8080 으로 이동하여 4단계와 동일한 환영 페이지를 확인합니다.

축하합니다. Cloud Databases 배포에 데이터를 공급하는 프런트엔드가 있는 앱을 만들었습니다!