Azure CLI kullanarak küme uzantılarını dağıtma ve yönetme

Aks kümesinde uzantı örnekleri oluşturabilir, güncelleştirmeler ve yapılandırmalarla ilgili seçenekler de dahil olmak üzere gerekli ve isteğe bağlı parametreleri ayarlayabilirsiniz. Ayrıca uzantı örneklerini görüntüleyebilir, listeleyebilir, güncelleştirebilir ve silebilirsiniz.

Başlamadan önce küme uzantıları hakkında bilgi alın.

Not

Bu makalede sağlanan örnekler tam değildir ve yalnızca işlevselliği göstermek içindir. Komutların ve parametrelerinin kapsamlı bir listesi için az k8s-extension CLI başvurusuna bakın.

Önkoşullar

  • Azure aboneliği. Azure aboneliğiniz yoksa ücretsiz hesap oluşturabilirsiniz.

  • Microsoft.ContainerService ve Microsoft.KubernetesConfiguration kaynak sağlayıcılarının aboneliğinizde kayıtlı olması gerekir. Bu sağlayıcıları kaydetmek için aşağıdaki komutu çalıştırın:

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

  • AKS kümesi. Küme uzantıları hizmet sorumlusu tabanlı kümelerle çalışmayacağından, bu küme yönetilen kimlikle oluşturulmuş olmalıdır. ile az aks createoluşturulan yeni kümeler için yönetilen kimlik varsayılan olarak yapılandırılır. Mevcut hizmet sorumlusu tabanlı kümeler için, --enable-managed-identity bayrağıyla az aks update komutunu çalıştırarak yönetilen kimliğe geçin. Daha fazla bilgi için bkz. Yönetilen kimliği kullanma.

  • Azure CLI sürümü >= 2.16.0 yüklü. En son sürümü kullanmanızı öneririz.

  • Azure CLI uzantılarının k8s-extension en son sürümü. Aşağıdaki komutu çalıştırarak uzantıyı yükleyin:

    az extension add --name k8s-extension

    Uzantı zaten yüklüyse, aşağıdaki komutu kullanarak en son sürümü çalıştırdığınızdan emin olun:

    az extension update --name k8s-extension

Uzantı örneği oluşturma

ile k8s-extension create, zorunlu parametreler için değerleri geçirerek yeni bir uzantı örneği oluşturun. Bu örnek komut AKS kümenizde bir Azure Machine Learning uzantısı örneği oluşturur:

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

Bu örnek komut, AKS kümenizde örnek bir Kubernetes uygulaması (Market'te yayımlandı) oluşturur:

az k8s-extension create --name voteapp --extension-type Contoso.AzureVoteKubernetesAppTest --scope cluster --cluster-name <clusterName> --resource-group <resourceGroupName> --cluster-type managedClusters --plan-name testPlanID --plan-product testOfferID --plan-publisher testPublisherID --configuration-settings title=VoteAnimal value1=Cats value2=Dogs

Not

Küme Uzantıları hizmeti hassas bilgileri 48 saatten uzun süre tutamıyor. Küme uzantı aracıları 48 saatten uzun süre ağ bağlantısı kuramaz ve kümede bir uzantı oluşturulup oluşturulmayacağını belirleyemezse, uzantı Failed durumuna geçer. Failed durumuna girdikten sonra, yeni bir uzantı örneği oluşturmak için k8s-extension create komutunu 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ı 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ü. AKS kümelerine eşlendiği şekilde managedClusters belirtin

İsteğe bağlı parametreler

Parametre adı Açıklama
--auto-upgrade-minor-version Uzantı ikincil sürümünün otomatik olarak yükseltilip yükseltilmediğini belirten Boole özelliği. Varsayılan: true. Bu parametre true olarak ayarlanırsa, sürüm dinamik olarak güncelleştirileceği için parametreyi ayarlayamazsınız version . olarak ayarlanırsa false, düzeltme eki sürümleri için bile uzantı otomatik olarak yükseltilmeyecek.
--version Yüklenecek uzantının sürümü (uzantı örneğinin sabitleneceği belirli bir sürüm). auto-upgrade-minor-version, true olarak ayarlanmışsa sağlanmamalıdır.
--configuration-settings İşlevselliğini denetlemek için uzantıya geçirilebilen ayarlar. Değerleri parametre adından sonra boşlukla ayrılmış key=value çiftler olarak geçirin. Bu parametre komutunda kullanılıyorsa, --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. Bu parametre komutunda kullanılıyorsa, --configuration-settings aynı komutta kullanılamaz.
--configuration-protected-settings Bu ayarlar, GET API çağrıları veya az k8s-extension show komutları kullanılarak geri alınamaz; bu nedenle hassas ayarları iletmek için kullanılır. Değerleri parametre adından sonra boşlukla ayrılmış key=value çiftler olarak geçirin. Bu parametre komutunda kullanılıyorsa, --configuration-protected-settings-file aynı komutta kullanılamaz.
--configuration-protected-settings-file Gizli ayarları uzantıya geçirmek için kullanılacak anahtar değer çiftlerine sahip JSON dosyasının yolu. Bu parametre komutunda kullanılıyorsa, --configuration-protected-settings aynı komutta kullanılamaz.
--scope Uzantı için yükleme kapsamı - cluster veya namespace
--release-namespace Bu parametre, yayının oluşturulacağı ad alanını gösterir. Bu parametre yalnızca scope parametresi cluster olarak ayarlanmışsa geçerlidir.
--release-train Uzantı yazarları, , Stablevb. gibi Previewfarklı sürüm trenlerinde sürüm yayımlayabilir. Bu parametre açıkça ayarlanmazsa, Stable varsayılan olarak kullanılır. --auto-upgrade-minor-version parametresi false olarak ayarlandığında bu parametre kullanılamaz.
--target-namespace Bu parametre, yayı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ıyla kısıtlanacak. Bu parametre yalnızca scope parametresi namespace olarak ayarlanmışsa geçerlidir.
--plan-name Azure portalındaki Market sayfasında Kullanım Bilgileri + Destek altında bulunan uzantının plan kimliği.
--plan-product Uzantının Ürün Kimliği, Azure portalındaki Market sayfasında Kullanım Bilgileri + Destek altında bulunur. Bunun bir örneği, kullanılan ISV teklifinin adıdır.
--plan-publisher Uzantının Yayımcı Kimliği, Azure portalındaki Market sayfasında Kullanım Bilgileri + Destek altında bulunur.

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

Şu anda yüklü olan bir uzantı örneğinin ayrıntılarını görüntülemek için komutunu kullanarak k8s-extension showzorunlu parametrelerin değerlerini geçirin.

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ı listelemek için komutunu kullanarak k8s-extension listzorunlu parametrelerin değerlerini geçirin.

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

Uzantı örneğini güncelleştirme

Not

--configuration-settings ve --configuration-protected-settings içinde güncellenebilen belirli ayarları anlamak için, belirli uzantı türüne ilişkin belgelere bakın. için --configuration-protected-settings, yalnızca bir ayar güncelleştirilse bile tüm ayarların sağlanması beklenir. Bu ayarlardan herhangi biri atlanırsa, bu ayarlar eski ve silinmiş olarak kabul edilir.

Mevcut bir uzantı örneğini güncelleştirmek için komutunu kullanarak k8s-extension updatezorunlu parametrelerin değerlerini geçirin. Aşağıdaki komut, Azure Machine Learning uzantısı örneğinin otomatik yükseltme ayarını güncelleştirir:

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

Güncelleştirme için 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 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ü. AKS kümelerine eşlenirken managedClusters belirtin

Kubernetes uygulamasının güncelleştirilmesi Market aracılığıyla sağlanırsa aşağıdaki parametreler de gereklidir:

Parametre adı Açıklama
--plan-name Azure portalındaki Market sayfasında Kullanım Bilgileri + Destek altında bulunan uzantının plan kimliği.
--plan-product Uzantının Ürün Kimliği, Azure portalındaki Market sayfasında Kullanım Bilgileri + Destek altında bulunur. Bunun bir örneği, kullanılan ISV teklifinin adıdır.
--plan-publisher Uzantının Yayımcı Kimliği, Azure portalındaki Market sayfasında Kullanım Bilgileri + Destek altında bulunur.

Güncelleştirme için isteğe bağlı parametreler

Parametre adı Açıklama
--auto-upgrade-minor-version Uzantı ikincil sürümünün otomatik olarak yükseltilip yükseltilmediğini belirten Boole özelliği. Varsayılan: true. Bu parametre true olarak ayarlanırsa, sürüm dinamik olarak güncelleştirileceği için parametreyi ayarlayamazsınız version . olarak ayarlanırsa false, düzeltme eki sürümleri için bile uzantı otomatik olarak yükseltilmeyecek.
--version Yüklenecek uzantının sürümü (uzantı örneğinin sabitleneceği belirli bir sürüm). auto-upgrade-minor-version, true olarak ayarlanmışsa sağlanmamalıdır.
--configuration-settings İşlevselliğini denetlemek için uzantıya geçirilebilen ayarlar. Yalnızca güncelleştirme gerektiren ayarların sağlanması gerekir. Sağlanan ayarlar, sağlanan değerlerle değiştirilir. Değerleri parametre adından sonra boşlukla ayrılmış key=value çiftler olarak geçirin. Bu parametre komutunda kullanılıyorsa, --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. Bu parametre komutunda kullanılıyorsa, --configuration-settings aynı komutta kullanılamaz.
--configuration-protected-settings Bu ayarlar, GET API çağrıları veya az k8s-extension show komutları kullanılarak geri alınamaz; bu nedenle hassas ayarları iletmek için kullanılır. Bir ayarı güncelleştirdiğinizde, tüm ayarların belirtilmesi beklenir. Bazı ayarlar atlanırsa, bu ayarlar eski ve silinmiş olarak kabul edilir. Değerleri parametre adından sonra boşlukla ayrılmış key=value çiftler olarak geçirin. Bu parametre komutunda kullanılıyorsa, --configuration-protected-settings-file aynı komutta kullanılamaz.
--configuration-protected-settings-file Gizli ayarları uzantıya geçirmek için kullanılacak anahtar değer çiftlerine sahip JSON dosyasının yolu. Bu parametre komutunda kullanılıyorsa, --configuration-protected-settings aynı komutta kullanılamaz.
--scope Uzantı için yükleme kapsamı - cluster veya namespace
--release-train Uzantı yazarları, , Stablevb. gibi Previewfarklı sürüm trenlerinde sürüm yayımlayabilir. Bu parametre açıkça ayarlanmazsa, Stable varsayılan olarak kullanılır. autoUpgradeMinorVersion parametresi false olarak ayarlandığında bu parametre kullanılamaz.

Uzantı örneğini silme

Kümedeki bir uzantı örneğini silmek için komutunu kullanarak k8s-extension-deletezorunlu parametrelerin değerlerini geçirin.

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

Not

Bu uzantıyı temsil eden Azure kaynağı hemen silinir. Bu uzantıyla ilişkili kümedeki Helm yayını, yalnızca Kubernetes kümesinde çalışan aracıların ağ bağlantısı olduğunda ve istenen durumu almak üzere Azure hizmetlerine yeniden erişebildiğinde silinir.

Sonraki adımlar

  • Last updated on