إدارة مثيل Azure المدار لموارد Apache Cassandra باستخدام Azure CLI

مقالة
03/13/2024

توضح هذه المقالة الأوامر الشائعة لأتمتة إدارة مثيل Azure المدار لمجموعات Apache Cassandra ومراكز البيانات باستخدام Azure CLI.

المتطلبات الأساسية

استخدم بيئة Bash في Azure Cloud Shell. لمزيد من المعلومات، راجع التشغيل السريع ل Bash في Azure Cloud Shell.
إذا كنت تفضل تشغيل أوامر مرجع CLI محلياً قم بتثبيت CLI Azure. إذا كنت تعمل على نظام تشغيل Windows أو macOS، ففكر في تشغيل Azure CLI في حاوية Docker. لمزيد من المعلومات، راجع كيفية تشغيل Azure CLI في حاوية Docker.
- إذا كنت تستخدم تثبيت محلي، يُرجى تسجيل الدخول إلى Azure CLI مستخدمًا أمر az login. لإنهاء عملية المصادقة، اتبع الخطوات المعروضة في جهازك. للحصول على خيارات أخرى لتسجيل دخول، راجع تسجيل الدخول باستخدام Azure CLI.
- عندما يُطلب منك، قم بتثبيت ملحق Azure CLI عند الاستخدام لأول مرة. لمزيد من المعلومات بشأن الامتدادات، راجع استخدام امتدادات مع Azure CLI.
- يُرجى تشغيل إصدار az للوصول إلى الإصدار والمكتبات التابعة التي تم تثبيتها. للتحديث لآخر إصدار، يُرجى تشغيل تحديث az.

تتطلب هذه المقالة الإصدار 2.30.0 من Azure CLI أو أحدث. إذا كنت تستخدم Azure Cloud Shell، فإن أحدث إصدار مثبت بالفعل.

هام

لا يمكنك إعادة تسمية Manage Azure Managed Instance لموارد Apache Cassandra. إعادة تسمية هذه الموارد تنتهك كيفية عمل Azure Resource Manager مع معرفات الموارد URI.

إدارة المجموعات

توضح الأقسام التالية كيفية إدارة Azure Managed Instance لمجموعات Apache Cassandra:

إنشاء نظام مجموعة
حذف كتلة
الحصول على تفاصيل نظام المجموعة
الحصول على حالة عقدة نظام المجموعة
سرد المجموعات حسب مجموعة الموارد
سرد المجموعات حسب معرف الاشتراك

إنشاء نظام مجموعة

إنشاء مثيل مدار من Azure لمجموعة Apache Cassandra باستخدام الأمر az managed-cassandra cluster create :

resourceGroupName='MyResourceGroup'
clusterName='cassandra-hybrid-cluster'
location='West US'
delegatedManagementSubnetId='/subscriptions/<subscription id>/resourceGroups/customer-vnet-rg/providers/Microsoft.Network/virtualNetworks/customer-vnet/subnets/management'
initialCassandraAdminPassword='myPassword'

# You can override the cluster name if the original name is not legal for an Azure resource:
# overrideClusterName='ClusterNameIllegalForAzureResource'
# The default Cassandra version is v3.11

az managed-cassandra cluster create \
    --cluster-name $clusterName \
    --resource-group $resourceGroupName \
    --location $location \
    --delegated-management-subnet-id $delegatedManagementSubnetId \
    --initial-cassandra-admin-password $initialCassandraAdminPassword \

حذف كتلة

حذف نظام مجموعة باستخدام الأمر az managed-cassandra cluster delete :

resourceGroupName='MyResourceGroup'
clusterName='cassandra-hybrid-cluster'

az managed-cassandra cluster delete \
    --cluster-name $clusterName \
    --resource-group $resourceGroupName

الحصول على تفاصيل نظام المجموعة

احصل على تفاصيل نظام المجموعة باستخدام الأمر az managed-cassandra cluster show :

resourceGroupName='MyResourceGroup'
clusterName='cassandra-hybrid-cluster'

az managed-cassandra cluster show \
    --cluster-name $clusterName \
    --resource-group $resourceGroupName

الحصول على حالة عقدة نظام المجموعة

احصل على حالة عقد نظام المجموعة باستخدام الأمر az managed-cassandra cluster node-status :

clusterName='cassandra-hybrid-cluster'
resourceGroupName='MyResourceGroup'

az managed-cassandra cluster status \
    --cluster-name $clusterName \
    --resource-group $resourceGroupName

سرد أنظمة المجموعات حسب مجموعة الموارد

سرد المجموعات حسب مجموعة الموارد باستخدام الأمر az managed-cassandra cluster list :

subscriptionId='MySubscriptionId'
resourceGroupName='MyResourceGroup'

az managed-cassandra cluster list\
    --resource-group $resourceGroupName

سرد المجموعات حسب معرف الاشتراك

سرد المجموعات حسب معرف الاشتراك باستخدام الأمر az managed-cassandra cluster list :

# Set your subscription ID
az account set -s <subscriptionID>

az managed-cassandra cluster list

إدارة مراكز البيانات

توضح الأقسام التالية كيفية إدارة Azure Managed Instance لمراكز بيانات Apache Cassandra:

إنشاء مركز بيانات
حذف مركز بيانات
الحصول على تفاصيل مركز البيانات
الحصول على مراكز البيانات في نظام مجموعة
تحديث مركز بيانات أو تغيير حجمه
الحصول على تكوين Cassandra
تحديث تكوين Cassandra

إنشاء مركز بيانات

إنشاء مركز بيانات باستخدام الأمر az managed-cassandra datacenter create :

resourceGroupName='MyResourceGroup'
clusterName='cassandra-hybrid-cluster'
dataCenterName='dc1'
dataCenterLocation='eastus2'
delegatedSubnetId='/subscriptions/<SubscriptionID>/resourceGroups/customer-vnet-rg/providers/Microsoft.Network/virtualNetworks/customer-vnet/subnets/dc1-subnet'
virtualMachineSKU='Standard_D8s_v4'
noOfDisksPerNode=4

az managed-cassandra datacenter create \
    --resource-group $resourceGroupName \
    --cluster-name $clusterName \
    --data-center-name $dataCenterName \
    --data-center-location $dataCenterLocation \
    --delegated-subnet-id $delegatedSubnetId \
    --node-count 3 
    --sku $virtualMachineSKU \
    --disk-capacity $noOfDisksPerNode \
    --availability-zone false

اختر قيمة --sku من خيارات الجهاز الظاهري (VM) المتوفرة التالية:

Standard_E8s_v4
Standard_E16s_v4
Standard_E20s_v4
Standard_E32s_v4
Standard_DS13_v2
Standard_DS14_v2
Standard_D8s_v4
Standard_D16s_v4
Standard_D32s_v4
Standard_L8s_v3
Standard_L16s_v3
Standard_L32s_v3
Standard_L8as_v3
Standard_L16as_v3
Standard_L32as_v3

حاليا، لا يدعم مثيل Azure المدار ل Apache Cassandra الانتقال عبر عائلات الأجهزة الظاهرية. على سبيل المثال، إذا كان لديك حاليا جهاز ظاهري Standard_DS13_v2 وكنت مهتما بالترقية إلى جهاز ظاهري أكبر مثل Standard_DS14_v2، فلن يتوفر هذا الخيار. ومع ذلك، يمكنك فتح تذكرة دعم لطلب الترقية.

في الأمر السابق، --availability-zone يتم تعيين إلى false. لتمكين مناطق التوفر، قم بتعيين هذه القيمة إلى true. تزيد مناطق التوفر من اتفاقية مستوى الخدمة (SLA) لتوفر الخدمة. لمزيد من المعلومات، راجع تفاصيل اتفاقية مستوى الخدمة الكاملة.

تحذير

لا يدعم مثيل Azure المدار ل Apache Cassandra مناطق التوفر في جميع المناطق. إذا حددت منطقة لا يتم فيها دعم مناطق التوفر، فستفشل عمليات النشر. راجع قائمة المناطق المدعومة.

يخضع النشر الناجح لمناطق التوفر أيضا لتوفر موارد الحوسبة في جميع المناطق في المنطقة. قد تفشل عمليات التوزيع إذا لم يتوفر الجهاز الظاهري أو السعة التي حددتها عبر جميع المناطق.

حذف مركز بيانات

حذف مركز بيانات باستخدام الأمر az managed-cassandra datacenter delete :

resourceGroupName='MyResourceGroup'
clusterName='cassandra-hybrid-cluster'
dataCenterName='dc1'

az managed-cassandra datacenter delete \
    --resource-group $resourceGroupName \
    --cluster-name $clusterName \
    --data-center-name $dataCenterName

تحذير

إذا كان لديك أكثر من مركز بيانات واحد في نظام المجموعة الخاص بك، يجب إزالة أي مراجع إلى مركز البيانات الذي تحاول حذفه في أي إعدادات استراتيجية النسخ المتماثل لمساحة المفاتيح أولا. سيفشل هذا الأمر إذا كانت أي مساحات مفاتيح داخل مجموعتك لا تزال تحتوي على مراجع إلى مركز البيانات.

الحصول على تفاصيل مركز البيانات

احصل على تفاصيل مركز البيانات باستخدام الأمر az managed-cassandra datacenter show :

resourceGroupName='MyResourceGroup'
clusterName='cassandra-hybrid-cluster'
dataCenterName='dc1'

az managed-cassandra datacenter show \
    --resource-group $resourceGroupName \
    --cluster-name $clusterName \
    --data-center-name $dataCenterName

تحديث مركز بيانات أو تغيير حجمه

تحديث مركز بيانات أو تغيير حجمه باستخدام الأمر az managed-cassandra datacenter update :

resourceGroupName='MyResourceGroup'
clusterName='cassandra-hybrid-cluster'
dataCenterName='dc1'

az managed-cassandra datacenter update \
    --resource-group $resourceGroupName \
    --cluster-name $clusterName \
    --data-center-name $dataCenterName \
    --node-count 13

لتغيير حجم مركز بيانات، قم --node-count بتغيير القيمة.

الحصول على تكوين Cassandra

احصل على تكوين YAML الحالي لعقدة باستخدام الأمر az managed-cassandra cluster invoke-command :

resourceGroupName='MyResourceGroup'
clusterName='cassandra-hybrid-cluster'
commandName='get-cassandra-yaml'
 
az managed-cassandra cluster invoke-command \
    --resource-group $resourceGroupName \
    --cluster-name $clusterName \
    --host <ip address> \
    --command-name 'get-cassandra-yaml'

يمكنك جعل الإخراج أكثر قابلية للقراءة باستخدام الأوامر التالية:

$output = az managed-cassandra cluster invoke-command \
    --resource-group $resourceGroupName \
    --cluster-name $clusterName \
    --host <ip address> \
    --command-name 'get-cassandra-yaml' \
    | ConvertFrom-Json
$output.commandOutput

تحديث تكوين Cassandra

قم بتغيير تكوين Cassandra على مركز بيانات باستخدام الأمر az managed-cassandra datacenter update . تحتاج إلى ترميز جزء YAML Base64 باستخدام أداة عبر الإنترنت.

على سبيل المثال، ضع في اعتبارك جزء YAML التالي:

column_index_size_in_kb: 16
read_request_timeout_in_ms: 10000

عند ترميزه، يتم تحويل YAML إلى: Y29sdW1uX2luZGV4X3NpemVfaW5fa2I6IDE2CnJlYWRfcmVxdWVzdF90aW1lb3V0X2luX21zOiAxMDAwMA==.

إليك الأمر مع az managed-cassandra datacenter update جزء YAML المشفرة:

resourceGroupName='MyResourceGroup'
clusterName='cassandra-hybrid-cluster'
dataCenterName='dc1'
dataCenterLocation='eastus'
yamlFragment='Y29sdW1uX2luZGV4X3NpemVfaW5fa2I6IDE2CnJlYWRfcmVxdWVzdF90aW1lb3V0X2luX21zOiAxMDAwMA=='

az managed-cassandra datacenter update \
    --resource-group $resourceGroupName \
    --cluster-name $clusterName \
    --data-center-name $dataCenterName \
    --base64-encoded-cassandra-yaml-fragment $yamlFragment

هام

تأكد من أن إعدادات Cassandra YAML التي تقدمها مناسبة لإصدار Cassandra الخاص بك. راجع إعدادات Cassandra v3.11 وإعدادات Cassandra v4.0. لا يسمح لك بتحديث إعدادات YAML التالية:

cluster_name
seed_provider
initial_token
autobootstrap
client_encryption_options
server_encryption_options
transparent_data_encryption_options
audit_logging_options
authenticator
authorizer
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
endpoint_snitch
partitioner
rpc_address
rpc_interface

الحصول على مراكز البيانات في نظام مجموعة

الحصول على مراكز البيانات في نظام مجموعة باستخدام الأمر az managed-cassandra datacenter list :

resourceGroupName='MyResourceGroup'
clusterName='cassandra-hybrid-cluster'

az managed-cassandra datacenter list \
    --resource-group $resourceGroupName \
    --cluster-name $clusterName

Share via