Cloud Bigtable 인스턴스 만들기

Cloud Bigtable 인스턴스는 Cloud Bigtable 클러스터가 최대 4개까지 있는 컨테이너입니다. 복제를 사용하는 인스턴스에는 클러스터가 두 개 이상 있고, 복제를 사용하지 않는 인스턴스에는 클러스터가 한 개밖에 없습니다.

이 페이지에서는 복제 사용 여부에 관계없이 인스턴스를 만드는 방법을 설명합니다. 이 페이지를 읽기 전에 Cloud Bigtable 개요를 숙지해야 합니다. 인스턴스, 클러스터, 노드의 개요도 읽어야 합니다.

시작하기 전에

시작하기 전에 환경을 준비하고 초기 계획을 세워야 합니다.

  1. GCP 프로젝트를 선택하거나 만듭니다.

    프로젝트 선택기 페이지로 이동

  2. Google Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다. 프로젝트에 결제가 사용 설정되어 있는지 확인하는 방법을 알아보세요.

  3. Cloud Bigtable 및 Cloud Bigtable Admin API를 사용 설정합니다.

    API 사용 설정

  4. 사용자 인증 정보로 이동을 클릭합니다.

  5. 사용자 인증 정보 페이지에서 필수 질문에 답변합니다.

    1. '사용 중인 API는 무엇인가요?'에 대한 답변으로 Cloud Bigtable API를 선택합니다.
    2. App Engine 또는 Compute Engine에 대한 질문에 답변합니다. 이 빠른 시작의 경우 사용하지 않습니다.
    3. 어떤 사용자 인증 정보가 필요한가요?를 클릭합니다.
    4. 서비스 계정을 만들라는 메시지가 표시되면 다음 정보를 입력합니다.
      1. 서비스 계정의 이름을 선택합니다.
      2. 역할Cloud Bigtable > Bigtable 관리자를 선택합니다.
      3. 키 유형으로 JSON을 선택합니다.
      4. 계속을 클릭합니다.
      5. 새로 만든 서비스 계정 JSON 파일을 로컬 HOME 디렉터리나 원하는 위치에 저장합니다.
    5. 새 서비스 계정을 만들라는 메시지가 표시되지 않으면 완료를 클릭합니다.
  6. Cloud Bigtable에 명령줄 도구를 사용하려면 Cloud SDKcbt 명령줄 도구(아직 설치되지 않은 경우)를 설치합니다.

  7. 복제를 사용 설정하려는 경우 다음을 수행하세요.

인스턴스 만들기

Cloud Bigtable 인스턴스를 만들려면 다음 안내를 따르세요.

Console

  1. Cloud Console에서 인스턴스 만들기 페이지를 엽니다.

    인스턴스 만들기 페이지 열기

  2. 인스턴스의 이름을 입력합니다.

    인스턴스 식별을 위해 Cloud Console에 이 이름이 표시됩니다.

  3. 인스턴스 ID를 입력합니다.

    인스턴스 ID는 인스턴스의 영구 식별자입니다.

  4. 첫 번째 클러스터의 클러스터 ID를 입력합니다.

    클러스터 ID는 클러스터의 영구 식별자입니다.

  5. 첫 번째 클러스터가 실행될 리전 및 영역을 선택합니다.

    단일 리전 내에서 복제를 사용하려는 경우에는 최소한 한 개 이상의 리전 내 다른 영역에서 Cloud Bigtable을 사용할 수 있는지 확인합니다. 영역 목록 보기

  6. 첫 번째 클러스터의 Cloud Bigtable 노드 수를 선택합니다. 얼마나 많은 노드가 필요한지 잘 모르겠으면 기본값을 사용합니다. 이후에 노드를 더 추가할 수 있습니다. 자세히 알아보기

  7. 지금 복제를 사용 설정하려면 복제된 클러스터 추가를 클릭한 다음 두 번째 클러스터의 설정을 업데이트합니다. 이 단계를 반복하여 인스턴스에 최대 4개의 클러스터를 만듭니다. 클러스터를 추가하여 복제를 사용 설정할 수도 있습니다.

    인스턴스의 클러스터는 각각 고유한 영역에 있어야 합니다. Cloud Bigtable을 사용할 수 있는 모든 영역에 추가 클러스터를 만들 수 있습니다. 클러스터 추가 버튼을 사용할 수 없는 경우 첫 번째 클러스터의 영역을 변경합니다.

  8. 클러스터에 SSD 디스크를 사용할지 HDD 디스크를 사용할지 선택합니다. 대부분의 경우 SSD가 가장 좋습니다. 이 선택은 되돌릴 수 없습니다. 자세히 알아보기

    Cloud Console은 디스크 유형 및 노드 수가 처리량 및 비용에 어떤 영향을 주는지 표시합니다.

  9. 만들기를 클릭하여 인스턴스를 만듭니다.

  10. 다음으로 기본 앱 프로필에서 복제 설정을 검토하여 복제 사용 사례에 적합한지 확인합니다. 기본 앱 프로필을 업데이트하거나 커스텀 앱 프로필을 생성해야 할 수도 있습니다.

gcloud

  1. 먼저 단일 클러스터로 인스턴스를 만듭니다. bigtable instances create 명령어를 사용하여 인스턴스를 만듭니다.

    gcloud bigtable instances create INSTANCE_ID \
        --cluster=CLUSTER_ID \
        --cluster-zone=CLUSTER_ZONE \
        --display-name=DISPLAY_NAME \
        [--cluster-num-nodes=CLUSTER_NUM_NODES] \
        [--cluster-storage-type=CLUSTER_STORAGE_TYPE] \
    

    다음 값을 제공합니다.

    • INSTANCE_ID: 인스턴스의 영구 식별자입니다.
    • CLUSTER_ID: 클러스터의 영구 식별자입니다.
    • CLUSTER_ZONE: 클러스터가 실행되는 영역입니다.

      단일 리전 내에서 복제를 사용하려는 경우에는 최소한 한 개 이상의 리전 내 다른 영역에서 Cloud Bigtable을 사용할 수 있는지 확인합니다. 영역 목록 보기

    • DISPLAY_NAME: Cloud Console에서 인스턴스를 식별하는 사람이 읽을 수 있는 이름입니다.

    이 명령어에는 다음과 같은 선택적 플래그가 사용됩니다.

    • --cluster-num-nodes=CLUSTER_NUM_NODES: 클러스터의 노드 수입니다. 인스턴스의 각 클러스터에는 노드가 하나 이상 있어야 합니다. 기본값은 1입니다. 얼마나 많은 노드가 필요한지 잘 모르겠으면 기본값을 사용합니다. 이후에 노드를 더 추가할 수 있습니다. 자세히 알아보기

    • --cluster-storage-type=CLUSTER_STORAGE_TYPE: 클러스터에 사용할 스토리지 유형입니다. 인스턴스의 각 클러스터가 동일한 스토리지 유형을 사용해야 합니다. SSDHDD 값을 사용합니다. 기본값은 SSD입니다.

      대부분의 경우, 기본값이 가장 좋습니다. 이 선택은 되돌릴 수 없습니다. 자세히 알아보기

  2. 프로덕션 인스턴스에 복제를 사용 설정하려면 bigtable clusters create 명령어를 사용하여 클러스터를 추가합니다.

    gcloud bigtable clusters create CLUSTER_ID \
        --instance=INSTANCE_ID \
        --zone=ZONE \
        [--num-nodes=NUM_NODES] \
        [--storage-type=STORAGE_TYPE]
    

    다음 값을 제공합니다.

    • CLUSTER_ID: 클러스터의 영구 식별자입니다.
    • INSTANCE_ID: 방금 만든 인스턴스의 영구 식별자입니다.
    • ZONE: 클러스터가 실행되는 영역입니다.

      인스턴스의 클러스터는 각각 고유한 영역에 있어야 합니다. Cloud Bigtable을 사용할 수 있는 모든 영역에 추가 클러스터를 만들 수 있습니다. 예를 들어 첫 번째 클러스터가 us-east1-b에 있으면 동일 리전의 다른 영역을 선택하거나(예: us-east1-c), 개별 리전의 영역을 선택할 수 있습니다(예: europe-west2-a).

    이 명령어에는 다음과 같은 선택적 플래그가 사용됩니다.

    • --num-nodes=NUM_NODES: 클러스터의 노드 수입니다. 인스턴스의 각 클러스터에는 노드가 하나 이상 있어야 합니다.

      대다수의 경우 한 인스턴스에 있는 각 클러스터는 노드 수가 동일해야 하지만 예외가 있습니다. 노드 및 복제 알아보기

    • --storage-type=STORAGE_TYPE: 클러스터에 사용할 스토리지 유형입니다. 인스턴스의 각 클러스터가 동일한 스토리지 유형을 사용해야 합니다. SSDHDD 값을 사용합니다. 기본값은 SSD입니다.

  3. 이전 단계를 반복하여 인스턴스에 최대 4개의 클러스터를 만듭니다.

  4. 다음으로 기본 앱 프로필에서 복제 설정을 검토하여 복제 사용 사례에 적합한지 확인합니다. 기본 앱 프로필을 업데이트하거나 커스텀 앱 프로필을 생성해야 할 수도 있습니다.

cbt

  1. 먼저 단일 클러스터로 인스턴스를 만듭니다. createinstance 명령어를 사용하여 인스턴스를 만듭니다.

    cbt createinstance INSTANCE_ID DISPLAY_NAME CLUSTER_ID CLUSTER_ZONE \
        CLUSTER_NUM_NODES CLUSTER_STORAGE_TYPE
    

    다음 값을 제공합니다.

    • INSTANCE_ID: 인스턴스의 영구 식별자입니다.
    • DISPLAY_NAME: Cloud Console에서 인스턴스를 식별하는 사람이 읽을 수 있는 이름입니다.
    • CLUSTER_ID: 클러스터의 영구 식별자입니다.
    • CLUSTER_ZONE: 클러스터가 실행되는 영역입니다.

      단일 리전 내에서 복제를 사용하려는 경우에는 최소한 한 개 이상의 리전 내 다른 영역에서 Cloud Bigtable을 사용할 수 있는지 확인합니다. 영역 목록 보기

    • CLUSTER_NUM_NODES: 클러스터의 노드 수입니다. 인스턴스의 각 클러스터에는 노드가 하나 이상 있어야 합니다. 얼마나 많은 노드가 필요한지 잘 모르겠으면 기본값을 사용합니다. 이후에 노드를 더 추가할 수 있습니다. 자세히 알아보기

    • CLUSTER_STORAGE_TYPE: 클러스터에 사용할 스토리지 유형입니다. 인스턴스의 각 클러스터가 동일한 스토리지 유형을 사용해야 합니다. SSDHDD 값을 사용합니다. 대부분의 경우 SSD가 가장 좋습니다. 이 선택은 되돌릴 수 없습니다. 자세히 알아보기

  2. 복제를 사용 설정하려면 createcluster 명령어를 사용하여 클러스터를 추가합니다.

    
    cbt -instance=INSTANCE_ID createcluster CLUSTER_ID ZONE NUM_NODES STORAGE_TYPE
    
    

    다음 값을 제공합니다.

    • INSTANCE_ID: 방금 만든 인스턴스의 영구 식별자입니다.
    • CLUSTER_ID: 클러스터의 영구 식별자입니다.
    • ZONE: 클러스터가 실행되는 영역입니다.

      인스턴스의 클러스터는 각각 고유한 영역에 있어야 합니다. Cloud Bigtable을 사용할 수 있는 모든 영역에 추가 클러스터를 만들 수 있습니다. 예를 들어 첫 번째 클러스터가 us-east1-b에 있으면 동일 리전의 다른 영역을 선택하거나(예: us-east1-c), 개별 리전의 영역을 선택할 수 있습니다(예: europe-west2-a).

    • NUM_NODES: 클러스터의 노드 수입니다. 인스턴스의 각 클러스터에는 노드가 하나 이상 있어야 합니다.

      대다수의 경우 한 인스턴스에 있는 각 클러스터는 노드 수가 동일해야 하지만 예외가 있습니다. 노드 및 복제 알아보기

    • STORAGE_TYPE: 클러스터에 사용할 스토리지 유형입니다. 인스턴스의 각 클러스터가 동일한 스토리지 유형을 사용해야 합니다. SSDHDD 값을 사용합니다.

  3. 다음으로 기본 앱 프로필에서 복제 설정을 검토하여 복제 사용 사례에 적합한지 확인합니다. 기본 앱 프로필을 업데이트하거나 커스텀 앱 프로필을 생성해야 할 수도 있습니다.

다음 단계