CLI kullanarak Azure Arc veri denetleyicisi oluşturma
Önkoşullar
Genel bakış bilgileri için Azure Arc özellikli veri hizmetleri dağıtımı planlama konusunu gözden geçirin.
Araçları yükleme
Başlamadan önce Azure (az) CLI uzantısını arcdata yükleyin.
Azure (arcdata) CLI için (az) uzantısını yükleme
Hangi hedef platformu seçerseniz seçin, veri denetleyicisi oluşturmadan önce aşağıdaki ortam değişkenlerini ayarlamanız gerekir. Bu ortam değişkenleri, veri denetleyicisi oluşturulduktan sonra ölçümlere erişmek ve panoları günlüğe kaydederken kullanılan kimlik bilgileri haline gelir.
Ortam değişkenlerini belirleme
Ölçümlere ve günlük panolarına erişmek için gereken iki ortam değişkeni kümesi aşağıdadır.
Ortam değişkenleri günlük ve ölçüm hizmetlerinin parolalarını içerir. Parolalar en az sekiz karakter uzunluğunda olmalı ve şu dört kategoriden üçünün karakterlerini içermelidir: Latin büyük harfler, Latin küçük harfler, sayılar ve alfasayısal olmayan karakterler.
## variables for Metrics and Monitoring dashboard credentials
export AZDATA_LOGSUI_USERNAME=<username for Kibana dashboard>
export AZDATA_LOGSUI_PASSWORD=<password for Kibana dashboard>
export AZDATA_METRICSUI_USERNAME=<username for Grafana dashboard>
export AZDATA_METRICSUI_PASSWORD=<password for Grafana dashboard>
Kubernetes kümesine bağlanma
Bir Kubernetes kümesine bağlanın ve kimlik doğrulaması yapın ve Azure Arc veri denetleyicisini oluşturmaya başlamadan önce mevcut bir Kubernetes bağlamını seçin. Kubernetes kümesine veya hizmetine bağlanma yönteminiz farklılık gösterir. Kubernetes API sunucusuna bağlanma konusunda kullandığınız Kubernetes dağıtımı veya hizmeti belgelerine bakın.
Geçerli bir Kubernetes bağlantınız olup olmadığını kontrol edebilir ve aşağıdaki komutlarla geçerli bağlamınızı onaylayabilirsiniz.
kubectl cluster-info
kubectl config current-context
Azure Arc veri denetleyicisini oluşturma
Aşağıdaki bölümlerde belirli Kubernetes platform türleri için yönergeler sağlanmaktadır. Platformunuzun yönergelerini izleyin.
- Azure Kubernetes Service (AKS)
- Azure Stack HCI üzerinde AKS
- Azure Red Hat OpenShift (ARO)
- Red Hat OpenShift Kapsayıcı Platformu (OCP)
- Açık kaynak, yukarı akış Kubernetes (kubeadm)
- AWS Elastic Kubernetes Service (EKS)
- Google Cloud Kubernetes Engine Service (GKE)
İpucu
Kubernetes kümeniz yoksa Azure'da bir küme oluşturabilirsiniz. Hızlı Başlangıç: Azure Arc özellikli veri hizmetlerini dağıtma - doğrudan bağlı mod - Azure portalındaki yönergeleri izleyerek sürecin tamamında ilerleyin.
Ardından Azure Kubernetes Service'te (AKS) oluşturma altındaki yönergeleri izleyin.
Azure Kubernetes Service'te (AKS) oluşturma
Varsayılan olarak AKS dağıtım profili depolama sınıfını managed-premium kullanır. managed-premium Depolama sınıfı yalnızca premium disklere sahip VM görüntüleri kullanılarak dağıtılan VM'leriniz varsa çalışır.
Depolama sınıfı olarak kullanacaksanız managed-premium aşağıdaki komutu çalıştırarak veri denetleyicisini oluşturabilirsiniz. Komuttaki yer tutucuları kaynak grubu adınız, abonelik kimliğiniz ve Azure konumunuzla değiştirin.
az arcdata dc create --profile-name azure-arc-aks-premium-storage --k8s-namespace <namespace> --name arc --subscription <subscription id> --resource-group <resource group name> --location <location> --connectivity-mode indirect --use-k8s
#Example:
#az arcdata dc create --profile-name azure-arc-aks-premium-storage --k8s-namespace arc --name arc --subscription xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --resource-group my-resource-group --location eastus --connectivity-mode indirect --use-k8s
Hangi depolama sınıfını kullanacağınızdan emin değilseniz, hangi VM türünü kullandığınızdan default bağımsız olarak desteklenen depolama sınıfını kullanmanız gerekir. Yalnızca en hızlı performansı sağlamaz.
Depolama sınıfını default kullanmak istiyorsanız şu komutu çalıştırabilirsiniz:
az arcdata dc create --profile-name azure-arc-aks-default-storage --k8s-namespace <namespace> --use-k8s --name arc --subscription <subscription id> --resource-group <resource group name> --location <location> --connectivity-mode indirect
#Example:
#az arcdata dc create --profile-name azure-arc-aks-default-storage --k8s-namespace arc --use-k8s --name arc --subscription xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --resource-group my-resource-group --location eastus --connectivity-mode indirect
Komutunu çalıştırdıktan sonra Oluşturma durumunu izleme bölümüne geçin.
Azure Stack HCI üzerinde AKS üzerinde oluşturma
Depolamayı yapılandırma (AKS-HCI ile Azure Stack HCI)
AKS-HCI ile Azure Stack HCI kullanıyorsanız ile fsTypeözel bir depolama sınıfı oluşturun.
fsType: ext4
Veri denetleyicisini dağıtmak için bu türü kullanın. Azure Stack HCI diskinde AKS için özel depolama sınıfı oluşturma sayfasındaki yönergelerin tamamına bakın.
Varsayılan olarak, dağıtım profili adlı default bir depolama sınıfı ve hizmet türünü LoadBalancerkullanır.
Depolama sınıfını ve hizmet türünü LoadBalancerkullanarak default veri denetleyicisini oluşturmak için aşağıdaki komutu çalıştırabilirsiniz.
az arcdata dc create --profile-name azure-arc-aks-hci --k8s-namespace <namespace> --use-k8s --name arc --subscription <subscription id> --resource-group <resource group name> --location <location> --connectivity-mode indirect
#Example:
#az arcdata dc create --profile-name azure-arc-aks-hci --k8s-namespace arc --use-k8s --name arc --subscription xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --resource-group my-resource-group --location eastus --connectivity-mode indirect
Komutunu çalıştırdıktan sonra Oluşturma durumunu izleme bölümüne geçin.
Azure Red Hat OpenShift(ARO) üzerinde oluşturma
Özel dağıtım profili oluşturma
Azure RedHat Open Shift profilini azure-arc-azure-openshift kullanın.
az arcdata dc config init --source azure-arc-azure-openshift --path ./custom
Veri denetleyicisi oluşturma
Veri denetleyicisini oluşturmak için aşağıdaki komutu çalıştırabilirsiniz:
az arcdata dc create --profile-name azure-arc-azure-openshift --k8s-namespace <namespace> --use-k8s --name arc --subscription <subscription id> --resource-group <resource group name> --location <location> --connectivity-mode indirect
#Example
#az arcdata dc create --profile-name azure-arc-azure-openshift --k8s-namespace arc --use-k8s --name arc --subscription xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --resource-group my-resource-group --location eastus --connectivity-mode indirect
Komutunu çalıştırdıktan sonra Oluşturma durumunu izleme bölümüne geçin.
Red Hat OpenShift Container Platform'da (OCP) oluşturma
Depolama sınıfını belirleme
Hangi depolama sınıfının kullanılacağını belirlemek için aşağıdaki komutu çalıştırın.
kubectl get storageclass
Özel dağıtım profili oluşturma
Aşağıdaki komutu çalıştırarak dağıtım profilini temel alan azure-arc-openshift yeni bir özel dağıtım profili dosyası oluşturun. Bu komut geçerli çalışma dizininizde bir dizin custom ve bu dizinde özel bir dağıtım profili dosyası control.json oluşturur.
OpenShift Kapsayıcı Platformu profilini azure-arc-openshift kullanın.
az arcdata dc config init --source azure-arc-openshift --path ./custom
Depolama sınıfını ayarlama
Şimdi aşağıdaki komutta değerini, yukarıdaki komutu çalıştırarak belirlenen kullanmak istediğiniz depolama sınıfının adıyla değiştirerek <storageclassname> istediğiniz depolama sınıfını kubectl get storageclass ayarlayın.
az arcdata dc config replace --path ./custom/control.json --json-values "spec.storage.data.className=<storageclassname>"
az arcdata dc config replace --path ./custom/control.json --json-values "spec.storage.logs.className=<storageclassname>"
#Example:
#az arcdata dc config replace --path ./custom/control.json --json-values "spec.storage.data.className=mystorageclass"
#az arcdata dc config replace --path ./custom/control.json --json-values "spec.storage.logs.className=mystorageclass"
LoadBalancer'ı ayarlama (isteğe bağlı)
Varsayılan olarak, azure-arc-openshift dağıtım profili hizmet türü olarak kullanır NodePort . Yük dengeleyiciyle tümleştirilmiş bir OpenShift kümesi kullanıyorsanız, aşağıdaki komutu kullanarak yapılandırmayı LoadBalancer hizmet türünü kullanacak şekilde değiştirebilirsiniz:
az arcdata dc config replace --path ./custom/control.json --json-values "$.spec.services[*].serviceType=LoadBalancer"
Veri denetleyicisi oluşturma
Artık aşağıdaki komutu kullanarak veri denetleyicisini oluşturmaya hazırsınız.
Not
parametresi, --path control.json dosyasının kendisine değil, control.json dosyasını içeren dizine işaret etmelidir.
Not
OpenShift Container Platform'a dağıtırken parametre değerini belirtin --infrastructure . Seçenekler şunlardır: aws, azure, alibaba, gcp, . onpremises
az arcdata dc create --path ./custom --k8s-namespace <namespace> --use-k8s --name arc --subscription <subscription id> --resource-group <resource group name> --location <location> --connectivity-mode indirect --infrastructure <infrastructure>
#Example:
#az arcdata dc create --path ./custom --k8s-namespace arc --use-k8s --name arc --subscription xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --resource-group my-resource-group --location eastus --connectivity-mode indirect --infrastructure onpremises
Komutunu çalıştırdıktan sonra Oluşturma durumunu izleme bölümüne geçin.
açık kaynak, yukarı akış Kubernetes(kubeadm) üzerinde oluşturma
Varsayılan olarak, kubeadm dağıtım profili adlı local-storage bir depolama sınıfı ve hizmet türü NodePortkullanır. Bu kabul edilebilirse, istenen depolama sınıfını ve hizmet türünü ayarlayan aşağıdaki yönergeleri atlayabilir ve aşağıdaki komutu hemen çalıştırabilirsiniz az arcdata dc create .
Dağıtım profilinizi belirli bir depolama sınıfını ve/veya hizmet türünü belirtecek şekilde özelleştirmek istiyorsanız, aşağıdaki komutu çalıştırarak kubeadm dağıtım profilini temel alan yeni bir özel dağıtım profili dosyası oluşturarak başlayın. Bu komut geçerli çalışma dizininizde bir dizin custom ve bu dizinde özel bir dağıtım profili dosyası control.json oluşturur.
az arcdata dc config init --source azure-arc-kubeadm --path ./custom
Aşağıdaki komutu çalıştırarak kullanılabilir depolama sınıflarını arayabilirsiniz.
kubectl get storageclass
Şimdi aşağıdaki komutta değerini, yukarıdaki komutu çalıştırarak belirlenen kullanmak istediğiniz depolama sınıfının adıyla değiştirerek <storageclassname> istediğiniz depolama sınıfını kubectl get storageclass ayarlayın.
az arcdata dc config replace --path ./custom/control.json --json-values "spec.storage.data.className=<storageclassname>"
az arcdata dc config replace --path ./custom/control.json --json-values "spec.storage.logs.className=<storageclassname>"
#Example:
#az arcdata dc config replace --path ./custom/control.json --json-values "spec.storage.data.className=mystorageclass"
#az arcdata dc config replace --path ./custom/control.json --json-values "spec.storage.logs.className=mystorageclass"
Varsayılan olarak, kubeadm dağıtım profili hizmet türü olarak kullanır NodePort . Yük dengeleyiciyle tümleştirilmiş bir Kubernetes kümesi kullanıyorsanız, aşağıdaki komutu kullanarak yapılandırmayı değiştirebilirsiniz.
az arcdata dc config replace --path ./custom/control.json --json-values "$.spec.services[*].serviceType=LoadBalancer"
Artık aşağıdaki komutu kullanarak veri denetleyicisini oluşturmaya hazırsınız.
Not
OpenShift Container Platform'a dağıtırken parametre değerini belirtin --infrastructure . Seçenekler şunlardır: aws, azure, alibaba, gcp, . onpremises
az arcdata dc create --path ./custom --k8s-namespace <namespace> --use-k8s --name arc --subscription <subscription id> --resource-group <resource group name> --location <location> --connectivity-mode indirect --infrastructure <infrastructure>
#Example:
#az arcdata dc create --path ./custom - --k8s-namespace <namespace> --use-k8s --name arc --subscription xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --resource-group my-resource-group --location eastus --connectivity-mode indirect --infrastructure onpremises
Komutunu çalıştırdıktan sonra Oluşturma durumunu izleme bölümüne geçin.
AWS Elastic Kubernetes Service (EKS) üzerinde oluşturma
Varsayılan olarak, EKS depolama sınıfı ve gp2 hizmet türü şeklindedir LoadBalancer.
Sağlanan EKS dağıtım profilini kullanarak veri denetleyicisini oluşturmak için aşağıdaki komutu çalıştırın.
az arcdata dc create --profile-name azure-arc-eks --k8s-namespace <namespace> --use-k8s --name arc --subscription <subscription id> --resource-group <resource group name> --location <location> --connectivity-mode indirect
#Example:
#az arcdata dc create --profile-name azure-arc-eks --k8s-namespace <namespace> --use-k8s --name arc --subscription xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --resource-group my-resource-group --location eastus --connectivity-mode indirect
Komutunu çalıştırdıktan sonra Oluşturma durumunu izleme bölümüne geçin.
Google Cloud Kubernetes Engine Service'te (GKE) oluşturma
Varsayılan olarak, GKE depolama sınıfı ve standard hizmet türü şeklindedir LoadBalancer.
Sağlanan GKE dağıtım profilini kullanarak veri denetleyicisini oluşturmak için aşağıdaki komutu çalıştırın.
az arcdata dc create --profile-name azure-arc-gke --k8s-namespace <namespace> --use-k8s --name arc --subscription <subscription id> --resource-group <resource group name> --location <location> --connectivity-mode indirect
#Example:
#az arcdata dc create --profile-name azure-arc-gke --k8s-namespace <namespace> --use-k8s --name arc --subscription xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --resource-group my-resource-group --location eastus --connectivity-mode indirect
Komutunu çalıştırdıktan sonra Oluşturma durumunu izleme bölümüne geçin.
Oluşturma durumunu izleme
Denetleyicinin tamamen oluşturulması birkaç dakika sürer. Aşağıdaki komutlarla başka bir terminal penceresinde ilerleme durumunu izleyebilirsiniz:
Not
Aşağıdaki örnek komutlarda adlı bir veri denetleyicisi ve adlı arc-dc Kubernetes ad alanı arcoluşturduğunuz varsayılır. Farklı değerler kullandıysanız betiği uygun şekilde güncelleştirin.
kubectl get datacontroller/arc-dc --namespace arc
kubectl get pods --namespace arc
Ayrıca, aşağıdaki gibi bir komut çalıştırarak belirli bir podun oluşturma durumunu de kontrol edebilirsiniz. Bu, özellikle sorunları gidermek için kullanışlıdır.
kubectl describe po/<pod name> --namespace arc
#Example:
#kubectl describe po/control-2g7bl --namespace arc
Oluşturma sorunlarını giderme
Oluşturmayla ilgili sorunlarla karşılaşırsanız sorun giderme kılavuzuna bakın.