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

Makale
05/15/2023

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

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

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ışmayeceğinden, 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 bayrağıyla çalıştırarak az aks update kimliği yönetmeye --enable-managed-identity 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ısı aracılarının 48 saatten uzun bir süre ağ bağlantısı yoksa ve kümede uzantı oluşturulup oluşturulmayacağını belirleyemiyorsa, uzantı duruma geçirilmektedir Failed . Duruma geçtikten Failed sonra yeni bir uzantı örneği oluşturmak için yeniden çalıştırmanız k8s-extension create gerekir.

Gerekli parametreler

Parametre adı	Açıklama
`--name`	Uzantı örneğinin adı
`--extension-type`	Kümeye yüklemek istediğiniz uzantı türü. Örnek: `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ümeleriyle eşlerken belirtin `managedClusters`

İ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ükseltilmeyeceğini belirten Boole özelliği. Varsayılan: `true`. Bu parametre true olarak ayarlanırsa, sürüm dinamik olarak güncelleştirileceğinden 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 olarak ayarlandıysa `true`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 API çağrıları veya `az k8s-extension show` komutları kullanılarak `GET` alınamaz ve bu nedenle hassas ayarları geçirmek 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 parametresi olarak `cluster`ayarlandığında geçerlidir`scope`.
`--release-train`	Uzantı yazarları, sürümleri , `Preview`, vb. gibi `Stable`farklı sürüm trenlerinde yayımlayabilir. Bu parametre açıkça ayarlı değilse, `Stable` varsayılan olarak kullanılır. Parametresi olarak ayarlandığında `false`bu parametre kullanılamaz`--auto-upgrade-minor-version`.
`--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 parametresi olarak `namespace`ayarlandığında geçerlidir`scope`.
`--plan-name`	Uzantının Plan Kimliği, Market sayfasında bulunan Azure portal Kullanım Bilgileri + Destek altındadır.
`--plan-product`	Uzantının ürün kimliği, Market sayfasındaki Azure portal Kullanım Bilgileri + Destek altında bulunur. Buna örnek olarak kullanılan ISV teklifinin adı verilmiştir.
`--plan-publisher`	Uzantının Yayımcı Kimliği, Market sayfasındaki Azure portal 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

içindeki ve --configuration-protected-settings güncelleştirilebilen belirli ayarları --configuration-settings 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 olarak kabul edilir ve silinir.

Mevcut bir uzantı örneğini güncelleştirmek için komutunu kullanın k8s-extension updateve zorunlu 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ümeleriyle eşlerken belirtin `managedClusters`

Market aracılığıyla temin edilen bir Kubernetes uygulamasını güncelleştiriyorsanız aşağıdaki parametreler de gereklidir:

Parametre adı	Açıklama
`--plan-name`	Uzantının Plan Kimliği, Market sayfasında bulunan Azure portal Kullanım Bilgileri + Destek altındadır.
`--plan-product`	Uzantının ürün kimliği, Market sayfasındaki Azure portal Kullanım Bilgileri + Destek altında bulunur. Buna örnek olarak kullanılan ISV teklifinin adı verilmiştir.
`--plan-publisher`	Uzantının Yayımcı Kimliği, Market sayfasındaki Azure portal 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ükseltilmeyeceğini belirten Boole özelliği. Varsayılan: `true`. Bu parametre true olarak ayarlanırsa, sürüm dinamik olarak güncelleştirileceğinden 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 olarak ayarlandıysa `true`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 API çağrıları veya `az k8s-extension show` komutları kullanılarak `GET` alınamaz ve bu nedenle hassas ayarları geçirmek için kullanılır. Bir ayarı güncelleştirdiğinizde, tüm ayarların belirtilmesi beklenir. Bazı ayarlar atlanırsa, bu ayarlar eski olarak kabul edilir ve silinir. 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ı, sürümleri , `Preview`, vb. gibi `Stable`farklı sürüm trenlerinde yayımlayabilir. Bu parametre açıkça ayarlı değilse, `Stable` varsayılan olarak kullanılır. Parametresi olarak ayarlandığında `false`bu parametre kullanılamaz`autoUpgradeMinorVersion`.

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şkilendirilmiş kümedeki 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 hizmetlerine yeniden ulaşabilir.

Sonraki adımlar

Kullanılabilir durumdaki küme uzantılarının listesini görüntüleyin.
Market aracılığıyla kullanılabilen Kubernetes uygulamaları hakkında bilgi edinin.

Aracılığıyla paylaş