빠른 시작: Azure Portal에서 Azure Managed Instance for Apache Cassandra 클러스터 만들기

Apache Cassandra용 Azure Managed Instance는 관리형 오픈 소스 Apache Cassandra 데이터 센터에 대한 자동화된 배포 및 스케일링 작업을 제공하여 하이브리드 시나리오를 가속화하고 지속적인 유지 관리를 줄여줍니다.

이 빠른 시작에서는 Azure Portal을 사용하여 Apache Cassandra 클러스터용 Azure Managed Instance를 만드는 방법을 설명합니다.

사전 요구 사항

Azure 구독이 아직 없는 경우 시작하기 전에 체험 계정을 만듭니다.

관리형 인스턴스 클러스터 만들기

  1. Azure Portal에 로그인합니다.

  2. 검색 창에서 Apache Cassandra용 Managed Instance를 검색하고 결과를 선택합니다.

    Apache Cassandra에 대한 Azure SQL Managed Instance 검색 스크린샷.

  3. Apache Cassandra 클러스터용 Managed Instance 만들기 단추를 선택합니다.

    클러스터를 만듭니다.

  4. Apache Cassandra용 Managed Instance 만들기 창에서 다음 세부 정보를 입력합니다.

    • 구독 - 드롭다운에서 Azure 구독을 선택합니다.
    • 리소스 그룹 - 새 리소스 그룹을 만들지 또는 기존 집합을 사용할지 여부를 지정합니다. 리소스 그룹은 Azure 솔루션에 관련된 리소스를 보유하는 컨테이너입니다. 자세한 내용은 Azure Resource Manager 개요 문서를 참조하세요.
    • 클러스터 이름 - 클러스터의 이름을 입력합니다.
    • 위치 - 클러스터가 배포되는 위치입니다.
    • 최초 Cassandra 관리자 암호 - 클러스터를 만드는 데 사용되는 암호입니다.
    • Cassandra 관리자 암호 확인 - 암호를 다시 입력합니다.
    • Virtual Network - Virtual Network 종료 및 서브넷을 선택하거나 새 서브넷을 만듭니다.
    • 역할 할당 - 관리되는 Cassandra 클러스터를 배포할 수 있도록 하려면 Virtual Networks에 특별한 권한이 필요합니다. 새 Virtual Network를 만들거나 권한이 적용되지 않은 기존 Virtual Network를 사용하는 경우 이 확인란을 선택된 상태로 유지합니다. Azure SQL Managed Instance Cassandra 클러스터를 이미 배포한 가상 네트워크를 사용하는 경우 이 옵션을 선택 취소합니다.

    클러스터 만들기 양식을 작성합니다.

    참고

    Azure Managed Instance for Apache Cassandra를 배포하려면 인터넷 액세스가 필요합니다. 인터넷 액세스가 제한되는 환경에서는 배포가 실패합니다. Managed Cassandra가 올바르게 작동하는 데 필요한 다음과 같은 중요한 Azure 서비스에 대한 VNet 내에서 액세스가 차단되어 있는지 확인합니다. 자세한 내용은 필수 아웃바운드 네트워크 규칙을 참조하세요.

    • Azure Storage
    • Azure KeyVault
    • Azure Virtual Machine Scale Sets
    • Azure 모니터링
    • Azure Active Directory
    • Azure Security
  5. 다음으로, 데이터 센터 탭을 선택합니다.

  6. 다음 세부 정보를 입력합니다.

    • 데이터 센터 이름 - 텍스트 필드에 데이터 센터 이름을 입력합니다.
    • 가용성 영역 - 가용성 영역을 사용하도록 설정하려면 이 확인란을 선택합니다.
    • SKU 크기 - 사용 가능한 가상 머신 SKU 크기 중에서 선택합니다.
    • 아니요. 디스크 수 - 각 Cassandra 노드에 연결할 p30 디스크 수를 선택합니다.
    • 아니요. 노드 수 - 이 데이터 센터에 배포할 Cassandra 노드 수를 선택합니다.

    요약을 검토하고 데이터 센터를 만듭니다.

    경고

    모든 하위 지역에서 가용성 영역이 지원되지 않습니다. 가용성 영역이 지원되지 않는 하위 지역을 선택하면 배포에 실패합니다. 여기에서 지원되는 지역을 참조하세요. 또한 가용성 영역을 성공적으로 배포하는 경우 지정된 하위 지역의 모든 영역에서 컴퓨팅 리소스를 사용할 수 있습니다. 선택한 SKU 또는 용량을 모든 영역에서 사용할 수 없는 경우 배포가 실패할 수 있습니다.

  7. 검토 + 만들기>만들기를 차례로 선택합니다

    참고

    클러스터를 만드는 데 최대 15분이 소요될 수 있습니다.

    요약을 검토하고 클러스터를 만듭니다.

  8. 배포가 완료된 후 리소스 그룹을 확인하여 새로 만든 관리형 인스턴스 클러스터를 확인:

    클러스터를 만든 후의 개요 페이지.

  9. 클러스터 노드를 찾아보려면 클러스터 리소스로 이동하고 데이터 센터 창을 열어서 확인합니다.

    데이터 센터 노드의 스크린샷

데이터 센터 크기 조정

  1. 이제 단일 데이터 센터를 사용하여 클러스터를 배포했으므로 데이터 센터를 강조 표시하고 단추를 선택하여 Scale 노드를 확장 또는 축소할 수 있습니다.

    데이터 센터 노드 크기 조정 스크린샷

  2. 다음으로 슬라이더를 원하는 숫자로 이동하거나 값을 편집하기만 하면됩니다. 완료되면 누릅니다 Scale.

    데이터 센터 노드 수를 선택하는 스크린샷

    참고

    노드 크기를 조정하는 데 걸리는 시간은 다양한 요인에 따라 달라지며 몇 분 정도 걸릴 수 있습니다. Azure에서 크기 조정 작업이 완료되었음을 알릴 때 모든 노드가 Cassandra 링에 조인되었음을 의미하지는 않습니다. 노드는 모두 "정상" 상태를 표시하고 데이터 센터 상태가 "성공"으로 읽히면 완전히 커미션됩니다.

데이터 센터 추가

  1. 다른 데이터 센터를 추가하려면 데이터 센터 창에서 추가 단추를 클릭합니다.

    데이터 센터 추가 스크린샷

    경고

    다른 지역에 데이터 센터를 추가하는 경우 다른 가상 네트워크를 선택해야 합니다. 또한 이 가상 네트워크가 위에서 만든 주 지역의 가상 네트워크(및 관리되는 인스턴스 클러스터 내에서 데이터 센터를 호스팅하는 다른 가상 네트워크)에 연결되어 있는지 확인해야 합니다. 이 문서를 살펴보고 Azure Portal 사용하여 가상 네트워크를 피어하는 방법을 알아봅니다. 또한 아래 CLI 명령을 사용하여 관리되는 인스턴스 클러스터를 배포하기 전에 가상 네트워크에 적절한 역할을 적용했는지 확인해야 합니다.

        az role assignment create \
        --assignee a232010e-820c-4083-83bb-3ace5fc29d0b \
        --role 4d97b98b-1d4f-4787-a291-c67834d212e7 \
        --scope /subscriptions/<subscriptionID>/resourceGroups/<resourceGroupName>/providers/Microsoft.Network/virtualNetworks/<vnetName>
    
  2. 적절한 필드를 입력합니다.

    • 데이터 센터 이름 - 드롭다운에서 Azure 구독을 선택합니다.
    • 가용성 영역 - 이 데이터 센터에서 가용성 영역을 사용하도록 설정하려면 이 확인란을 선택합니다.
    • 위치 - 데이터 센터를 배포할 위치입니다.
    • SKU 크기 - 사용 가능한 가상 머신 SKU 크기 중에서 선택합니다.
    • 아니요. 디스크 수 - 각 Cassandra 노드에 연결할 p30 디스크 수를 선택합니다.
    • 아니요. 노드 수 - 이 데이터 센터에 배포할 Cassandra 노드 수를 선택합니다.
    • Virtual Network - 종료 Virtual Network 및 서브넷을 선택합니다.

    데이터 센터를 추가합니다.

    경고

    데이터 센터를 추가할 때는 새 가상 네트워크를 만들 수 없습니다. 기존 가상 네트워크를 선택해야 하며, 위에서 설명한 대로 데이터 센터가 배포될 대상 서브넷 간에 연결이 있는지 확인해야 합니다. 또한 배포를 허용하려면 VNet에 적절한 역할을 적용해야 합니다(위 참조).

  3. 데이터 센터가 배포되면 데이터 센터 창에서 모든 데이터 센터 정보를 볼 수 있습니다.

    클러스터 리소스를 확인합니다.

Cassandra 구성 업데이트

이 서비스는 포털을 통해 또는 CLI 명령을 사용하여 데이터 센터에서 Cassandra YAML 구성을 업데이트할 수 있습니다. 포털에서 설정을 업데이트하려면 다음을 수행합니다.

  1. 설정에서 찾 Cassandra Configuration 습니다. 구성을 변경하려는 데이터 센터를 강조 표시하고 업데이트를 클릭합니다.

    구성을 업데이트할 데이터 센터 선택 스크린샷

  2. 열리는 창에서 아래와 같이 YAML 형식으로 필드 이름을 입력합니다. 그런 다음 업데이트를 클릭합니다.

    데이터 센터 Cassandra 구성을 업데이트하는 스크린샷

  3. 업데이트가 완료되면 재정의된 값이 창에 Cassandra Configuration 표시됩니다.

    업데이트된 Cassandra 구성의 스크린샷.

    참고

    재정의된 Cassandra 구성 값만 포털에 표시됩니다.

    중요

    제공한 Cassandra yaml 설정이 배포한 Cassandra 버전에 적합한지 확인합니다. Cassandra v3.11 설정은 여기 를 참조하고 v4.0은 여기 를 참조하세요. 다음 YAML 설정은 업데이트할 수 없습니다 .

    • cluster_name
    • seed_provider
    • initial_token
    • autobootstrap
    • client_ecncryption_options
    • server_encryption_options
    • transparent_data_encryption_options
    • audit_logging_options
    • 인증자(authenticator)
    • 인가자
    • role_manager
    • storage_port
    • ssl_storage_port
    • native_transport_port
    • native_transport_port_ssl
    • listen_address
    • listen_interface
    • broadcast_address
    • hints_directory
    • data_file_directories
    • commitlog_directory
    • cdc_raw_directory
    • saved_caches_directory

문제 해결

Azure CLI를 사용하여 Virtual Network에 권한을 적용할 때 'e5007d2c-4b13-4a74-9b6a-605d99f03501'에 대한 그래프 데이터베이스에서 사용자 또는 서비스 주체를 찾을 수 없음과 같은 오류가 발생하는 경우 Azure Portal에서 동일한 권한을 수동으로 적용할 수 있습니다. 여기에서 이 작업을 수행하는 방법을 알아봅니다.

참고

Azure Cosmos DB 역할 할당은 배포 목적으로만 사용됩니다. Azure Managed Instanced for Apache Cassandra에는 Azure Cosmos DB에 대한 백 엔드 종속성이 없습니다.

클러스터에 연결

Apache Cassandra용 Azure Managed Instance는 공용 IP 주소가 포함된 노드를 만들지 않으므로 새로 만든 Cassandra 클러스터에 연결하려면 VNet 내에 다른 리소스를 만들어야 합니다. 애플리케이션이나 Apache의 오픈 소스 쿼리 도구인 CQLSH가 포함된 가상 머신이 설치될 수 있습니다. 템플릿을 사용하여 Ubuntu 가상 머신을 배포할 수 있습니다. 배포된 경우 SSH를 사용하여 가상 머신에 연결하고 아래 명령을 사용하여 CQLSH를 설치합니다.

# Install default-jre and default-jdk
sudo apt update
sudo apt install openjdk-8-jdk openjdk-8-jre

# Install the Cassandra libraries in order to get CQLSH:
echo "deb http://www.apache.org/dist/cassandra/debian 311x main" | sudo tee -a /etc/apt/sources.list.d/cassandra.sources.list
curl https://downloads.apache.org/cassandra/KEYS | sudo apt-key add -
sudo apt-get update
sudo apt-get install cassandra

# Export the SSL variables:
export SSL_VERSION=TLSv1_2
export SSL_VALIDATE=false

# Connect to CQLSH (replace <IP> with the private IP addresses of a node in your Datacenter):
host=("<IP>")
initial_admin_password="Password provided when creating the cluster"
cqlsh $host 9042 -u cassandra -p $initial_admin_password --ssl

리소스 정리

이 관리형 인스턴스 클러스터를 더 이상 사용하지 않으려면 다음 단계에 따라 삭제합니다.

  1. Azure Portal의 왼쪽 메뉴에서 리소스 그룹을 선택합니다.
  2. 목록에서 이 빠른 시작에서 만든 리소스 그룹을 선택합니다.
  3. 리소스 그룹 개요 창에서 리소스 그룹 삭제를 선택합니다.
  4. 새 창에서 삭제할 리소스 그룹의 이름을 입력한 다음, 삭제를 선택합니다.

다음 단계

이 빠른 시작에서 Azure Portal을 사용하여 Apache Cassandra 클러스터용 Azure Managed Instance를 생성하는 방법을 알아보았습니다. 이제 클러스터 사용을 시작할 수 있습니다.