Azure Kubernetes hizmeti (AKS) için küme uzantılarını dağıtma ve yönetme (Önizleme)

Makale
11/04/2021
Okumak için 7 dakika

küme uzantıları bir aks kümesinde Azure Machine Learning (ML) gibi hizmetlerin yükleme ve yaşam döngüsü yönetimi için Azure Resource Manager temelli bir deneyim sağlar. Bu özellik şunları sunar:

AKS kümelerinde ölçekli dağıtımlar dahil olmak üzere uzantıların Azure Resource Manager tabanlı dağıtımı.
Uzantının yaşam döngüsü yönetimi (güncelleştirme, silme) Azure Resource Manager.

Bu makalede şunları öğreneceksiniz:

Uzantı örneği oluşturma.

AKS üzerinde kullanılabilir küme uzantıları.

Uzantı örneklerini görüntüleme, listeleme, güncelleştirme ve silme.

Bu özelliğe kavramsal genel bakış, küme uzantıları-Azure Arc-etkinleştirilmiş Kubernetes makalesinde bulunabilir.

Önemli

AKS önizleme özellikleri self servis, kabul etme temelinde kullanılabilir. Önizlemeler "olduğu gibi" ve "kullanılabilir" olarak sağlanır ve hizmet düzeyi sözleşmelerinden ve sınırlı garantiden dışlanmıştır. AKS önizlemeleri en iyi çaba temelinde müşteri desteği kapsamındadır. Bu nedenle bu özellikler üretimde kullanım için uygun değil. Daha fazla bilgi için aşağıdaki destek makalelerini okuyun:

Önkoşullar

Azure aboneliği. Azure aboneliğiniz yoksa ücretsiz hesap oluşturabilirsiniz.
Azure CLI sürüm >= 2.16.0 yüklendi.

Aşağıdaki komutları girin:

az provider register --namespace Microsoft.KubernetesConfiguration
az provider register --namespace Microsoft.ContainerService

Kayıt işlemini izleyin. Kayıt, en fazla 10 dakika sürebilir.
```
az provider show -n Microsoft.KubernetesConfiguration -o table
az provider show -n Microsoft.ContainerService -o table
```
Kaydolduktan sonra, RegistrationState Bu ad alanlarının durumunu olarak değiştirme durumunu görmeniz gerekir Registered .

Aşağıdaki komutları girin:

Register-AzResourceProvider -ProviderNamespace Microsoft.KubernetesConfiguration
Register-AzResourceProvider -ProviderNamespace Microsoft.ContainerService

Kayıt işlemini izleyin. Kayıt, en fazla 10 dakika sürebilir.
```
Get-AzResourceProvider -ProviderNamespace Microsoft.KubernetesConfiguration
Get-AzResourceProvider -ProviderNamespace Microsoft.ContainerService
```
Kaydolduktan sonra, RegistrationState Bu ad alanlarının durumunu olarak değiştirme durumunu görmeniz gerekir Registered .

`AKS-ExtensionManager`Önizleme özelliklerini kaydetme

Küme uzantılarını kullanan bir AKS kümesi oluşturmak için, AKS-ExtensionManager aboneliğinizde Özellik bayrağını etkinleştirmeniz gerekir.

AKS-ExtensionManagerAşağıdaki örnekte gösterildiği gibi, az Feature Register komutunu kullanarak özellik bayrağını kaydedin:

az feature register --namespace "Microsoft.ContainerService" --name "AKS-ExtensionManager"

Durumun kayıtlı gösterilmesi birkaç dakika sürer. Az Feature List komutunu kullanarak kayıt durumunu doğrulayın:

az feature list -o table --query "[?contains(name, 'Microsoft.ContainerService/AKS-ExtensionManager')].{Name:name,State:properties.state}"

Hazır olduğunda, az Provider Register komutunu kullanarak Microsoft. KubernetesConfiguration ve Microsoft. Containerservice kaynak sağlayıcılarının kaydını yenileyin:

az provider register --namespace Microsoft.KubernetesConfiguration
az provider register --namespace Microsoft.ContainerService

Küme uzantıları için Azure CLı uzantısını ayarlama

Not

Azure CLı uzantısı için desteklenen en düşük sürüm k8s-extension 1.0.0 . Hangi sürümü yükleeceğinizden emin değilseniz, ' i çalıştırın az extension show --name k8s-extension ve version alanını bulun.

Ayrıca k8s-extension Azure CLI uzantısına de ihtiyacınız olacaktır. Aşağıdaki komutları çalıştırarak bunu yüklemelisiniz:

az extension add --name k8s-extension

k8s-extensionUzantı zaten yüklüyse, aşağıdaki komutu kullanarak en son sürüme güncelleştirebilirsiniz:

az extension update --name k8s-extension

Şu anda kullanılabilir uzantılar

Not

Küme uzantıları, bir AKS kümesine yüklenecek ve yönetilecek farklı uzantıların bir platformunu sağlar. Bu uzantıların herhangi birini kullanırken sorunlarla karşılaşırsanız, lütfen ilgili hizmetle bir destek bileti açın.

Dahili numara	Description
Dapr	Davpr, tüm geliştiricilerin bulut ve kenar üzerinde çalışan dayanıklı, durumsuz ve durum bilgisi olan uygulamalar oluşturmasını kolaylaştıran taşınabilir ve olay odaklı bir çalışma zamanı.
Azure ML	Azure Machine Learning ' de makine öğrenimi modellerini eğitmek, çıkarımını ve yönetmek için Azure Kubernetes hizmet kümelerini kullanın.

Desteklenen bölgeler ve Kubernetes sürümleri

Küme uzantıları, Azure Arc etkinleştirilmiş Kubernetes bölge desteği' nde listelenen bölgelerde aks kümelerinde kullanılabilir.

Desteklenen Kubernetes sürümleri için, her uzantı için ilgili belgelere başvurun.

Küme uzantılarının kullanımı

Not

Bu makalede sağlanan örnekler tamamlanmaz ve yalnızca işlevselliği göstermek için tasarlanmıştır. Komutların ve parametrelerinin kapsamlı bir listesi için lütfen az k8s-EXTENSION CLI başvurusunabakın.

Uzantı örneği oluştur

k8s-extension createZorunlu parametreler için değerler geçirerek, ile yeni bir uzantı örneği oluşturun. aşağıdaki komut aks kümenizde bir Azure Machine Learning uzantısı örneği oluşturur:

az k8s-extension create --name aml-compute --extension-type Microsoft.AzureML.Kubernetes --scope cluster --cluster-name <clusterName> --resource-group <resourceGroupName> --cluster-type managedClusters --configuration-settings enableInference=True allowInsecureConnections=True

Not

Küme uzantıları hizmeti, 48 saatten uzun bir süreyle hassas bilgileri alamıyor. Küme uzantısı aracılarında 48 saatten uzun bir ağ bağlantısı yoksa ve kümede bir uzantı oluşturulup oluşturulmayacağını belirleyemezseniz, uzantı Failed durumuna geçer. Durum ' dan bir kez Failed , k8s-extension create Yeni bir uzantı örneği oluşturmak için yeniden çalıştırmanız gerekir.

Gerekli parametreler

Parametre adı	Açıklama
`--name`	Uzantı örneğinin adı
`--extension-type`	Kümeye yüklemek istediğiniz uzantının türü. Örneğin: Microsoft. AzureML. Kubernetes
`--cluster-name`	Uzantı örneğinin oluşturulması gereken AKS kümesinin adı
`--resource-group`	AKS kümesini içeren kaynak grubu
`--cluster-type`	Uzantı örneğinin oluşturulması gereken küme türü. `managedClusters`AKS kümelerine eşlendiği şekilde belirtin

İsteğe bağlı parametreler

Parametre adı	Açıklama
`--auto-upgrade-minor-version`	Uzantının ikincil sürümünün otomatik olarak yükseltildiğini belirten Boolean özelliği. Varsayılan: `true`. Bu parametre true olarak ayarlanırsa, `version` Sürüm dinamik olarak güncelleştirildiğinden parametre ayarlayamazsınız. Olarak ayarlanırsa `false` , uzantı, yama sürümleri için bile otomatik olarak yükseltilmeyecektir.
`--version`	Yüklenecek uzantının sürümü (uzantı örneğini sabitlemek için belirli bir sürüm). Otomatik yükseltme-alt-sürümü olarak ayarlandıysa, sağlanmamalıdır `true` .
`--configuration-settings`	işlevselliğini denetlemek için uzantıya geçirilebilecek Ayarlar. Parametre adından sonra alana ayrılmış çiftler olarak geçirilirler `key=value` . Komutta Bu parametre kullanılırsa, `--configuration-settings-file` aynı komutta kullanılamaz.
`--configuration-settings-file`	Yapılandırma ayarlarını uzantıya geçirmek için kullanılacak anahtar değer çiftlerine sahip JSON dosyasının yolu. Komutta Bu parametre kullanılırsa, `--configuration-settings` aynı komutta kullanılamaz.
`--configuration-protected-settings`	Bu ayarlar `GET` , API çağrıları veya komutları kullanılarak alınabilir değildir `az k8s-extension show` ve bu nedenle hassas ayarları geçirmek için kullanılır. Parametre adından sonra alana ayrılmış çiftler olarak geçirilirler `key=value` . Komutta Bu parametre kullanılırsa, `--configuration-protected-settings-file` aynı komutta kullanılamaz.
`--configuration-protected-settings-file`	Anahtara duyarlı ayarları geçirmek için kullanılacak anahtar değer çiftlerine sahip JSON dosyasının yolu. Komutta Bu parametre kullanılırsa, `--configuration-protected-settings` aynı komutta kullanılamaz.
`--scope`	Uzantı için yükleme kapsamı- `cluster` veya `namespace`
`--release-namespace`	Bu parametre, sürümün oluşturulacağı ad alanını belirtir. Bu parametre yalnızca `scope` parametresi olarak ayarlandıysa geçerlidir `cluster` .
`--release-train`	Uzantı yazarları,, vb. gibi farklı sürüm sunumlarında sürümler `Stable` yayımlayabilir `Preview` . Bu parametre açıkça ayarlanmamışsa, `Stable` Varsayılan olarak kullanılır. Bu parametre `autoUpgradeMinorVersion` , parametresi olarak ayarlandığında kullanılamaz `false` .
`--target-namespace`	Bu parametre, sürümünün oluşturulacağı ad alanını gösterir. Bu uzantı örneği için oluşturulan sistem hesabının izni, bu ad alanı ile kısıtlanıyor. Bu parametre yalnızca `scope` parametresi olarak ayarlandıysa geçerlidir `namespace` .

Uzantı örneğinin ayrıntılarını göster

Şu anda yüklü olan bir uzantı örneğinin ayrıntılarını k8s-extension show , zorunlu parametreler için değerler geçirerek görüntüleyin:

az k8s-extension show --name azureml --cluster-name <clusterName> --resource-group <resourceGroupName> --cluster-type managedClusters

Kümede yüklü olan tüm uzantıları listeleme

Bir kümede yüklü olan tüm uzantıları ile k8s-extension list listele, zorunlu parametreler için değerleri iletir.

az k8s-extension list --cluster-name <clusterName> --resource-group <resourceGroupName> --cluster-type managedClusters

Uzantı örneğini güncelleştirme

Not

ConfigurationSetting ve ConfigurationProtectedSettings altında güncelleştirilmelerine izin verilen belirli ayarlar hakkında bilgi edinmek için uzantı türü belgelerine (Örneğin: Azure ML) bakın. ConfigurationProtectedSettings için tüm ayarların tek bir ayarın güncelleştirmesi sırasında sağlanması beklenir. Bazı ayarlar atlanırsa, bu ayarlar eski ve silinmiş olarak kabul edilir.

Mevcut bir uzantı örneğini ile k8s-extension update güncelleştirin ve zorunlu parametreler için değerleri geçirme. Aşağıdaki komut, bir uzantı örneği için otomatik yükseltme Azure Machine Learning ler:

az k8s-extension update --name azureml --extension-type Microsoft.AzureML.Kubernetes --scope cluster --cluster-name <clusterName> --resource-group <resourceGroupName> --cluster-type managedClusters

Gerekli parametreler

Parametre adı	Açıklama
`--name`	Uzantı örneğinin adı
`--extension-type`	Kümeye yüklemek istediğiniz uzantı türü. Örneğin: Microsoft.AzureML.Kubernetes
`--cluster-name`	Uzantı örneğinin üzerinde oluşturulacak AKS kümesi adı
`--resource-group`	AKS kümesi içeren kaynak grubu
`--cluster-type`	Uzantı örneğinin oluşturulacak küme türü. `managedClusters`AKS kümelerini eşlerken belirtme

İsteğe bağlı parametreler

Parametre adı	Açıklama
`--auto-upgrade-minor-version`	Uzantı ikincil sürümünün otomatik olarak yükseltilecek olup olmadığını belirten Boole özelliği. Varsayılan: `true`. Bu parametre true olarak ayarlanırsa, sürüm dinamik olarak güncelleştirilecek şekilde `version` parametresini ayaramaz. olarak `false` ayarlanırsa, düzeltme eki sürümleri için bile uzantı otomatik olarak yükseltilmez.
`--version`	Yüklenmek için uzantının sürümü (uzantı örneğini sabitlemek için belirli bir sürüm). Otomatik yükseltme-ikincil sürüm olarak ayarlanırsa, `true` sağlanmaz.
`--configuration-settings`	Ayarlar işlevselliğini kontrol etmek için uzantıya geçirilen bir uygulamadır. Yalnızca güncelleştirme gerektiren ayarların sağlanmalıdır. Sağlanan ayarlar, sağlanan değerlerle değiştirilir. Parametre adının ardından boşlukla ayrılmış çiftler `key=value` olarak geçiriler. Bu parametre komutta kullanılıyorsa `--configuration-settings-file` aynı komutta kullanılamaz.
`--configuration-settings-file`	Uzantıya yapılandırma ayarlarının geçirmesi için kullanılacak anahtar değer çiftleri olan JSON dosyasının yolu. Bu parametre komutta kullanılıyorsa `--configuration-settings` aynı komutta kullanılamaz.
`--configuration-protected-settings`	Bu ayarlar API çağrıları veya komutları kullanılarak alınabilir değildir `GET` ve bu nedenle hassas `az k8s-extension show` ayarlarda geçiş yapmak için kullanılır. Bir ayarı güncelleştiriyorsanız tüm ayarların sağlanmalıdır. Bazı ayarlar atlanırsa, bu ayarlar eski ve silinmiş olarak kabul edilir. Parametre adının ardından boşlukla ayrılmış çiftler `key=value` olarak geçiriler. Bu parametre komutta kullanılıyorsa `--configuration-protected-settings-file` aynı komutta kullanılamaz.
`--configuration-protected-settings-file`	Uzantıya hassas ayarların geçirmesi için kullanılacak anahtar değer çiftleri olan JSON dosyasının yolu. Bu parametre komutta kullanılıyorsa `--configuration-protected-settings` aynı komutta kullanılamaz.
`--scope`	Uzantı için yükleme kapsamı - `cluster` veya `namespace`
`--release-train`	Uzantı yazarları , vb. gibi farklı sürüm eğitimlerinde `Stable` `Preview` sürüm yayımlar. Bu parametre açıkça ayarlanmazsa `Stable` varsayılan olarak kullanılır. Parametresi olarak ayarlanırken `autoUpgradeMinorVersion` bu parametre `false` kullanılamaz.

Uzantı örneğini silme

Not

Bu uzantıyı temsil eden Azure kaynağı hemen silinir. Bu uzantıyla ilişkili kümenin Helm sürümü yalnızca Kubernetes kümesinde çalışan aracıların ağ bağlantısı olduğunda silinir ve istenen durumu getirmek için Azure hizmetleriyle tekrar iletişimde olabilir.

ile bir kümede uzantı örneğini silmek k8s-extension delete için zorunlu parametrelerin değerlerini geçirmeniz gerekir.

az k8s-extension delete --name azureml --cluster-name <clusterName> --resource-group <resourceGroupName> --cluster-type managedClusters