IoT İşlemleri örneğini kopyalama (önizleme)

Mevcut bir Azure IoT İşlemleri örneğini kopyalayarak aynı yapılandırma ve ayarlara sahip yeni bir örnek oluşturabilirsiniz. Kopyalama, örneğinizin yedeğini oluşturmak veya test veya geliştirme amacıyla aynı yapılandırmaya sahip yeni bir örnek ayarlamak için kullanışlıdır.

Kopyalama için kullanım örneği senaryoları şunlardır:

• Olağanüstü durum kurtarma: Olağanüstü durum söz konusu olduğunda örneği geri yüklemek için kullanılabilecek Azure IoT İşlemleri örneğinizin yedeğini oluşturun.
• Test ve geliştirme: Test veya geliştirme amacıyla mevcut bir örnekle aynı yapılandırmaya sahip yeni bir Azure IoT İşlemleri örneği ayarlayın.
• Geçiş: Örneği yeni konuma kopyalayarak Azure IoT İşlemleri örneğinizi yeni bir kümeye veya kaynak grubuna taşıyın.
• Ölçeklendirme: Artan iş yükünü işlemek veya yükü birden çok örneğe dağıtmak için Azure IoT İşlemleri örneğinizin birden çok örneğini oluşturun.

Uyarı

Kopyalama özelliği önizleme aşamasında ve geliştirme aşamasındadır.

Önkoşullar

• Bir kümeye dağıtılan bir Azure IoT İşlemleri örneği. Daha fazla bilgi için bkz. Azure IoT İşlemlerini Dağıtma.

• Geliştirme makinenizde Yüklü Azure CLI. Bu senaryo için Azure CLI sürüm 2.53.0 veya üzeri gerekir. Sürümünüzü denetlemek ve az --version gerekirse güncelleştirmek için kullanınaz upgrade. Daha fazla bilgi için bkz. Azure CLI'yi yükleme.

• Azure CLI için Azure IoT İşlemleri uzantısı. Clone şu anda aşağıdaki IoT İşlemleri örneği sürüm aralığıyla uyumludur: 1.0.34>=,<1.2.0. Uzantıyı güncelleştirmek veya yüklemek için aşağıdaki komutu kullanın. <VERSION_NUMBER> öğesini örneğinizle uyumlu olan bir sürümle değiştirin.

  az extension add --upgrade --name azure-iot-ops --version <VERSION_NUMBER>
  

Clone komutuna genel bakış

az iot ops clone Mevcut bir örneği temel alan yeni bir Azure IoT İşlemleri örneği oluşturmak için komutunu kullanın.

clone komutu bir Azure IoT Operations örneğini analiz eder ve ARM şablonları aracılığıyla altyapı-kodu şeklinde yeniden oluşturur. Kopyanın çıkışını çoğaltma olarak adlandırılan başka bir bağlı kümeye uygulayabilirsiniz. Ayrıca kopyayı daha sonra kullanmak üzere yerel bir dizine kaydedebilir ve kümeye uygulamadan önce bazı yapılandırma değişiklikleri gerçekleştirebilirsiniz.

Kopyalama işlemi üç ana bileşenden oluşur: kaynak örnek olan model, hedef örnek ve şablon. Aşağıdaki diyagramda kopyalama akışı gösterilmektedir. komutu clone kaynak örneği analiz eder ve IaC/ARM şablonu aracılığıyla çoğaltır. Çoğaltılan tanım bir veya daha fazla hedef kümeye uygulanır.

Klon model

Model, kopyaladığınız örnektir. Klonlama işleminin hakikat kaynağıdır. Modeli tanımlamak için aşağıdaki parametreleri girin:

• --name/-n: Model örneği adı.
• --resource-group/-g: Model örneğini içeren kaynak grubu.

Hedefi kopyalama

Hedef, kopya tanımını çoğaltmak veya kaydetmek istediğiniz yerdir. Bir hedefe, tüm hedeflere veya hiç hedefe klon uygulayabilirsiniz. Herhangi bir hedef seçenek sağlamazsanız, kapsam içi kaynakların özeti çıktısını aldıktan sonra işlem sonlandırılır. Hedefi tanımlamak için aşağıdaki parametrelerden birini girin:

• --to-cluster-id: Kopyalanan örneği çoğaltmak istediğiniz hedef kümenin tam Azure kaynak kimliğini belirtin. Bu seçeneği kullandığınızda, clone komutu kopya tanımında belirtilen Azure IoT İşlemlerinin sürümünü hedef kümeye dağıtır ve ardından dağıtımı tamamlamak için tüm ilgili kaynakları uygular. Kullanıcı tarafından atanan yönetilen kimlik (UAMI) kimlik bilgilerinin otomatik federasyonu şu anda yalnızca küme hedefine kopyalama sırasında desteklenmektedir.

• --to-dir: Kopya tanımını diske çoğaltmak için yerel bir dizin yolu sağlayın; burada mevcut ARM dağıtım araçlarıyla birlikte veya değişiklik yapmadan dağıtılabilir. Kopya tanımını incelerseniz, bazı özelleştirmeleri kolaylaştırmak için çeşitli parametreleştirmeleri görürsünüz.

Önemli

Hedef kaynak grubunu seçerken, mevcut bir IoT İşlemleri yüklemesini içermeyen ve modelin kaynak grubundan ayrı bir kaynak grubu kullanmayı göz önünde bulundurun. Varsayılan olarak, kopya tanımı model örneğindeki kaynak adlarını korur. Hedef ve model aynı kaynak grubunu paylaşırsa ve özel konumu değiştirirseniz kaynak adı çakışmaları oluşabilir.

Şablonu klonla

Clone komutu, hedefte oluşturulacak kaynakları açıklayan bir ARM şablonu oluşturur. Şablon, model örneğindeki kaynaklara ve bunların yapılandırmasına göre oluşturulur. Şablonu özelleştirmek için aşağıdaki isteğe bağlı parametreleri girin:

Şablon özelleştirme parametrelerini kopyalama

Oluşturulan ARM şablonunu özelleştirmek için aşağıdaki isteğe bağlı parametreleri kullanabilirsiniz:

• --mode: Alt dağıtımların şablonda nasıl düzenleniyor olduğunu belirtir.

  • nested Mod kullanıldığında (varsayılan), tüm alt dağıtımlar kök dağıtım dosyasında kendi kendine yer alır.
  • linked Mod kullanıldığında, varlıkla ilgili alt dağıtımlar ayrılır ve daha sonra kök dağıtımla bağlantılı olan ayrı dosyalar olarak depolanır. Ölçeklenebilirliği ve yönetilebilirliği geliştirmek için örneğinizde çok sayıda cihaz ve varlık varsa modu kullanın linked . Büyük dağıtımlar için bu ayrımı gerektirmediğiniz sürece bu parametreyi belirtmeniz gerekmez.

• --param: biçimini locationkullanarak , instanceNameveya adrNamespaceIdgibi key=valueyerleşik varsayılan parametreleri geçersiz kılmanızı sağlar. Anahtarların tam listesini görüntülemek için kullanın --help .

Örneği kopyalama

Bir örneği kopyalamak için komutunu uygun parametrelerle kullanarak az iot ops clone kaynak örneği ve hedef konumu belirtin.

1. Başlamadan önce varsayılan aboneliğinizi model örneğinin içinde olduğu aboneliğe ayarlayın. Aksi takdirde, bir --subscription komutu her çalıştırdığınızda az iot ops clone eklemeniz gerekir.

   az account set -s $MODEL_SUBSCRIPTION_ID
   

2. Küme kaynak kimliğinizi almak için şunu çalıştırın:

   az resource show --name <CLUSTER_NAME> --resource-group <RESOURCE_GROUP> --resource-type "Microsoft.Kubernetes/connectedClusters" --query id --output tsv
   

3. Varsayılan seçenekleri kullanarak bir örneği kopyalamak ve hedef arc-connected kümesine çoğaltmak için şunu çalıştırın:

   az iot ops clone --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --to-cluster-id <CLUSTER_ID> 
   

4. Başka bir kümeye çoğaltmayı özelleştirmek için --param kullanın ve key=value biçiminde değiştirmek istediğiniz parametreleri belirtin. Örneğin, kopyalanan örneğin konumunu değiştirmek için şunu çalıştırın:

   az iot ops clone --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --to-cluster-id <CLUSTER_ID> --param location=eastus
   

5. Bir örneği yerel diske kopyalamak için, kopyalama tanımını kaydetmek istediğiniz dizini belirtmek için parametresini kullanın --to-dir . Bu seçenek, sizin takdirinize bağlı olarak işlenecek veya dağıtılacak standart bir ARM şablonu oluşturur.

   az iot ops clone --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --to-dir <DIRECTORY>
   

   Tavsiye

   Bir örneği geçerli dizine kopyalamak için komutunu çalıştırın --to-dir .

6. Bir örneği bir hedef kümeye kopyalayıp çoğaltmak ve aynı işlemde dosyaya kaydetmek için şunu çalıştırın:

   az iot ops clone --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --to-cluster-id <CLUSTER_ID> --to-dir <DIRECTORY>
   

7. Bir örneği kümeye kopyalamak, ancak varlıkla ilgili alt dağıtımları bölmek ve seri olarak uygulamak için, model örneğinde varlıkla ilgili çok sayıda kaynak bulunduğunda parametresi en yüksek ölçek derecesini sunar seçeneğini kullanın --mode linked. .

   az iot ops clone --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --to-cluster-id <CLUSTER_ID> --mode linked
   

8. Bir örneği bağlantılı modda diske kopyalamak için, her bağlı varlık ve/veya varlık uç noktası profili şablonu kök şablondan ayrı olarak dağıtılabilir.

   az iot ops clone --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --to-dir . --mode linked
   

Dikkat edilmesi gerekenler ve sınırlamalar

• Otomatik kimlik federasyonu şu anda --to-cluster-id seçeneğiyle yalnızca desteklenmektedir.
• Kaynak eşitleme kuralları kayıt altına alınmaz.
• IoT İşlemleri sisteminin yönetilen kimliği ile hedef şema kayıt defteri arasındaki gerekli rol ataması klon ile gerçekleştirilirken, diğer sistem tarafından yönetilen kimlik rol atamaları kapsanmaz.
• Kopyalama, bulut tarafı bir işlemdir. Kümeyle doğrudan etkileşim kurulmuyor. Küme sırları, sır sağlayıcı sınıflarını ve sır eşitleme bulut kaynaklarını kapsayan güvenli ayarlar aracılığıyla buluttan senkronize edilir. Model kümesinde model IoT İşlemleri çözümünde başvuruda bulunılan yapılandırma haritaları gibi kullanıcı tarafından oluşturulan öğeler varsa, bu öğelerin hedef kümeye yeniden uygulanması gerekir.