快速入門:從 Azure 入口網站 建立適用于 Apache Cassandra 叢集的 Azure 受控執行個體

適用于 Apache Cassandra 的 Azure 受控執行個體提供受控開放原始碼 Apache Cassandra 資料中心的自動化部署和調整作業,加速混合式案例並減少持續維護。

本快速入門示範如何使用 Azure 入口網站 來建立適用于 Apache Cassandra 叢集的 Azure 受控執行個體。

必要條件

如果您沒有 Azure 訂用帳戶,請在開始前建立免費帳戶

建立受控執行個體叢集

  1. 登入 Azure 入口網站

  2. 從搜尋列中搜尋apache Cassandra 的受控執行個體,然後選取結果。

    搜尋 Apache Cassandra Azure SQL 受控執行個體的螢幕擷取畫面。

  3. 選取[為 Apache Cassandra 叢集建立受控執行個體] 按鈕。

    建立叢集。

  4. [建立 Apache Cassandra 的受控執行個體] 窗格中,輸入下列詳細資料:

    • 用帳戶 - 從下拉式清單中,選取您的 Azure 訂用帳戶。
    • 資源群組- 指定您要建立新的資源群組或使用現有的資源群組。 資源群組是存放 Azure 方案相關資源的容器。 如需詳細資訊,請參閱 Azure 資源群組 概觀一文。
    • 叢集名稱 - 輸入叢集的名稱。
    • 位置 - 將部署叢集的位置。
    • 初始 Cassandra 系統管理員密碼 - 用來建立叢集的密碼。
    • 確認 Cassandra 系統管理員密碼 - 重新輸入密碼。
    • 虛擬網路- 選取結束虛擬網路和子網,或建立新的子網。
    • 指派角色 - 虛擬網路需要特殊許可權,才能允許部署受控 Cassandra 叢集。 如果您要建立新的虛擬網路,或使用現有的虛擬網路而不套用許可權,請保留此方塊。 如果您使用已部署Azure SQL 受控執行個體 Cassandra 叢集的虛擬網路,請取消核取此選項。

    填寫建立叢集表單。

    注意

    Apache Cassandra 的 Azure 受控執行個體部署需要網際網路存取。 在網際網路存取受限的環境中,部署失敗。 請確定您不會封鎖 VNet 記憶體取下列重要 Azure 服務,而受控 Cassandra 才能正常運作。 如需詳細資訊,請參閱 必要的輸出網路規則

    • Azure 儲存體
    • Azure KeyVault
    • Azure 虛擬機器擴展集
    • Azure 監視
    • Azure Active Directory
    • Azure 安全性
  5. 接下來,選取 [資料中心 ] 索引標籤。

  6. 輸入下列詳細資料:

    • 資料中心名稱 - 在文字欄位中輸入資料中心名稱。
    • 可用性區域 - 如果您想要啟用可用性區域,請核取此方塊。
    • SKU 大小 - 從可用的虛擬機器 SKU 大小中選擇。
    • 不是 磁片數目 - 選擇要連結至每個 Cassandra 節點的 p30 磁片數目。
    • 不是 節點數目 - 選擇將部署至此資料中心的 Cassandra 節點數目。

    檢閱建立資料中心的摘要。

    警告

    並非所有區域都支援可用性區域。 如果您選取不支援可用性區域的區域,部署將會失敗。 如需支援的區域,請參閱這裡。 可用性區域是否能成功部署也受限於指定區域中所有區域的計算資源可用性。 如果您選取的 SKU 或容量無法在所有區域使用,部署可能會失敗。

  7. 接下來,按一下[檢閱 + 建立]>

    注意

    建立叢集最多可能需要 15 分鐘的時間。

    檢閱摘要以建立叢集。

  8. 部署完成後,請檢查您的資源群組以查看新建立的受控實例叢集:

    建立叢集之後的概觀頁面。

  9. 若要流覽叢集節點,請流覽至叢集資源,然後開啟 [資料中心 ] 窗格以檢視它們:

    資料中心節點的螢幕擷取畫面。

調整資料中心

  1. 既然您已部署具有單一資料中心的叢集,您可以藉由醒目提示資料中心來相應增加或減少節點,然後選取 Scale 按鈕:

    調整資料中心節點的螢幕擷取畫面。

  2. 接下來,將滑杆移至所需的數位,或只編輯值。 完成時,按 Scale

    選取資料中心節點數目的螢幕擷取畫面。

    注意

    節點調整所需的時間長度取決於各種因素,可能需要幾分鐘的時間。 當 Azure 通知您調整作業已完成時,這並不表示所有節點都已加入 Cassandra 通道。 當節點全部顯示狀態為「狀況良好」時,節點將會完全受委任,而資料中心狀態會讀取為「成功」。

新增資料中心

  1. 若要新增另一個資料中心,請按一下 [資料中心 ] 窗格中的 [新增] 按鈕:

    新增資料中心的螢幕擷取畫面。

    警告

    如果您要在不同的區域中新增資料中心,則必須選取不同的虛擬網路。 您也必須確保此虛擬網路能夠連線到在上述 (建立的主要區域虛擬網路,以及裝載受控實例叢集內資料中心的任何其他虛擬網路) 。 請參閱本文以瞭解如何使用 Azure 入口網站對等互連虛擬網路。 您也必須確定您已使用下列 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 節點數目。
    • 虛擬網路- 選取結束虛擬網路和子網。

    新增 Datacenter。

    警告

    請注意,我們不允許在新增資料中心時建立新的虛擬網路。 您必須選擇現有的虛擬網路,如前所述,您必須確保目標子網之間有部署資料中心的連線能力。 您也需要將適當的角色套用至 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
    • 驗證器
    • 授權者
    • 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 將許可權套用至虛擬網路時發生錯誤,例如在圖形資料庫中找不到 'e5007d2c-4b13-4a74-9b6a-605d99f03501' 的使用者或服務主體,您可以從Azure 入口網站手動套用相同的許可權。 瞭解如何 在這裡執行這項操作。

注意

Azure Cosmos DB 角色指派僅供部署之用。 適用于 Apache Cassandra 的 Azure 受控實例在 Azure Cosmos DB 上沒有後端相依性。

連線到您的叢集

適用于 Apache Cassandra 的 Azure 受控執行個體不會建立具有公用 IP 位址的節點,因此若要連線到新建立的 Cassandra 叢集,您必須在 VNet 內建立另一個資源。 這可能是已安裝 Apache 開放原始碼查詢工具 CQLSH 的應用程式或虛擬機器。 您可以使用 範本 來部署 Ubuntu 虛擬機器。

從 CQLSH 連線

部署虛擬機器之後,請使用 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

從應用程式連線

如同 CQLSH,使用其中一個支援的 Apache Cassandra 用戶端驅動程式 從應用程式連線,需要啟用 SSL。 請參閱使用JAVA.NET連線至適用于 Apache Cassandra 的 Azure 受控執行個體範例。 針對 JAVA,強烈建議您啟用 假設式執行原則。 您可以在這裡找到說明運作方式以及如何啟用原則的示範。

建議您停用憑證驗證,因為除非您將叢集節點的 I.P 位址對應至適當的網域,否則憑證驗證將無法運作。 如果您有內部原則,其會強制您對任何應用程式執行 SSL 憑證驗證,您可以藉由為每個節點在主機檔案中新增之類的 10.0.1.5 host1.managedcassandra.cosmos.azure.com 專案來加速此作業。 如果採用此方法,則每當相應增加節點時,您也需要新增專案。

清除資源

如果您不打算繼續使用此受控實例叢集,請使用下列步驟將其刪除:

  1. 從Azure 入口網站的左側功能表中,選取[資源群組]。
  2. 在該清單中,選取您在本快速入門中建立的資源群組。
  3. 在 [資源群組 概觀 ] 窗格中,選取 [ 刪除資源群組]。
  4. 在下個視窗中輸入要刪除的資源群組名稱,然後選取 [刪除]

後續步驟

在本快速入門中,您已瞭解如何使用 Azure 入口網站 建立適用于 Apache Cassandra 叢集的 Azure 受控執行個體。 您現在可以開始使用叢集: