Öğretici: Gelişmiş dağıtım akışı için Azure Stack Edge Pro FPGA ile verileri dönüştürme

Makale
02/27/2024

Önemli

Azure Stack Edge Pro FPGA cihazları Şubat 2024'te kullanım ömrü sonuna ulaşacaktır. Yeni dağıtımları düşünüyorsanız iş yükleriniz için Azure Stack Edge Pro 2 veya Azure Stack Edge Pro GPU cihazlarını incelemenizi öneririz.

Bu öğreticide, Azure Stack Edge Pro FPGA cihazınızda gelişmiş dağıtım akışı için işlem rolünün nasıl yapılandırıldığı açıklanmaktadır. İşlem rolünü yapılandırdıktan sonra Azure Stack Edge Pro FPGA verileri Azure'a göndermeden önce dönüştürebilir.

İşlem, cihazınızdaki basit veya gelişmiş dağıtım akışı için yapılandırılabilir.

Ölçütler	Basit dağıtım	Gelişmiş dağıtım
Hedeflenen	BT yöneticileri	Geliştiriciler
Tür	Modülleri dağıtmak için Azure Stack Edge hizmetini kullanma	Modülleri dağıtmak için IoT Hub hizmetini kullanma
Dağıtılan modüller	Tekli	Zincirlenmiş veya birden çok modül

Bu yordamın tamamlanması yaklaşık 20-30 dakika sürebilir.

Bu öğreticide aşağıdakilerin nasıl yapılacağını öğreneceksiniz:

İşlemi yapılandırma
Paylaşım ekleme
Tetikleyici ekleme
İşlem modülü ekleme
Veri dönüştürme işlemini doğrulama ve verileri aktarma

Önkoşullar

Azure Stack Edge Pro FPGA cihazınızda işlem rolü ayarlamadan önce şunları yaptığınızdan emin olun:

Azure Stack Edge Pro FPGA cihazınızı Bağlan, ayarlama ve etkinleştirme bölümünde açıklandığı gibi etkinleştirdiniz.

İşlemi yapılandırma

Azure Stack Edge Pro FPGA'nızda işlem yapılandırmak için bir IoT Hub kaynağı oluşturacaksınız.

Azure Stack Edge kaynağınızın Azure portalında Genel Bakış'a gidin. Sağ bölmede IoT Edge kutucuğunu seçin.
IoT Edge hizmetini etkinleştir kutucuğunda Ekle'yi seçin. Bu eylem, IoT Edge modüllerini cihazınızda yerel olarak dağıtmanıza olanak tanıyan IoT Edge hizmetini etkinleştirir.

IoT Edge Oluştur hizmetinde aşağıdakileri girin:

Alan	Değer
Abonelik	IoT Hub kaynağınız için bir abonelik seçin. Azure Stack Edge kaynağı tarafından kullanılan abonelikle aynı aboneliği seçebilirsiniz.
Kaynak grubu	IoT Hub kaynağınız için kaynak grubu için bir ad girin. Azure Stack Edge kaynağı tarafından kullanılan kaynak grubunu seçebilirsiniz.
IoT Hub	Yeni veya Mevcut arasından seçim yapın. Varsayılan olarak IoT kaynağı oluşturulurken Standart katmanı (S1) kullanılır. Bir ücretsiz katman IoT kaynağı kullanmak için kaynağı oluşturun ve sonra da mevcut kaynağı seçin.
Veri Akışı Adı	Varsayılan değeri kabul edin veya IoT Hub kaynağınız için bir ad girin.

Get started with compute 3

Gözden geçir + Oluştur’u seçin. IoT Hub kaynağı oluşturma işlemi birkaç dakika sürer. IoT Hub kaynağı oluşturulduktan sonra Genel Bakış, IoT Edge hizmetinin çalıştığını gösterecek şekilde güncelleştirilir.

IoT Edge hizmeti Edge cihazında yapılandırıldığında iki cihaz oluşturur: IoT cihazı ve IoT Edge cihazı. Her iki cihaz da IoT Hub kaynağında görüntülenebilir. Bu IoT Edge cihazında bir IoT Edge Çalışma Zamanı da çalışıyor. Bu noktada IoT Edge cihazınız için yalnızca Linux platformu kullanılabilir.

Edge işlem rolünün yapılandırıldığını onaylamak için IoT Edge hizmeti > Özellikleri'ni seçin ve IoT cihazını ve IoT Edge cihazını görüntüleyin.

Paylaşım ekleme

Bu öğreticideki gelişmiş dağıtım için iki paylaşıma ihtiyacınız vardır: bir Edge paylaşımı ve başka bir Edge yerel paylaşımı.

Aşağıdaki adımları uygulayarak cihaza bir Edge paylaşımı ekleyin:
1. Azure Stack Edge kaynağınızda IoT Edge > Paylaşımları'na gidin.
2. Paylaşımlar sayfasında, komut çubuğunda + Paylaşım ekle'yi seçin.
3. Paylaşım ekle dikey penceresinde paylaşım adını belirtin ve paylaşım türünü seçin.
4. Edge paylaşımını bağlamak için Paylaşımı Edge işlemiyle kullan onay kutusunu seçin.
5. Depolama hesabını, Depolama hizmeti, var olan bir kullanıcıyı seçin ve ardından Oluştur'u seçin.
Edge paylaşımı oluşturulduktan sonra başarılı bir oluşturma bildirimi alırsınız. Paylaşım listesi yeni paylaşımı yansıtacak şekilde güncelleştirilir.
Önceki adımda tüm adımları yineleyerek ve Edge yerel paylaşımı olarak yapılandır onay kutusunu seçerek Edge cihazına bir Edge yerel paylaşımı ekleyin. Yerel paylaşımdaki veriler cihazda kalır.
Paylaşımlar dikey penceresinde, güncelleştirilmiş paylaşım listesini görürsünüz.
Yeni oluşturulan yerel paylaşımın özelliklerini görüntülemek için listeden paylaşımı seçin. Edge işlem modülleri için yerel bağlama noktası kutusunda, bu paylaşıma karşılık gelen değeri kopyalayın.

Modülü dağıtırken bu yerel bağlama noktasını kullanacaksınız.
Oluşturduğunuz Edge paylaşımının özelliklerini görüntülemek için listeden paylaşımı seçin. Edge işlem modülleri için yerel bağlama noktası kutusunda, bu paylaşıma karşılık gelen değeri kopyalayın.

Modülü dağıtırken bu yerel bağlama noktasını kullanacaksınız.

Tetikleyici ekleme

Azure Stack Edge kaynağınıza ve ardından IoT Edge > Tetikleyicileri'ne gidin. + Tetikleyici ekle'yi seçin.

Tetikleyici ekle dikey penceresinde aşağıdaki değerleri girin.

Alan	Değer
Tetikleyici adı	Tetikleyiciniz için benzersiz bir ad.
Tetikleyici türü	Dosya tetikleyicisi'ne tıklayın. Dosya tetikleyicisi, giriş paylaşımına dosya yazılması gibi bir dosya olayı gerçekleştiğinde tetiklenir. Öte yandan zamanlanmış tetikleyici, sizin tanımladığınız bir zamanlamaya göre tetikler. Bu örnekte bir dosya tetikleyicisi gerekir.
Giriş paylaşımı	Bir giriş paylaşımı seçin. Edge yerel paylaşımı, bu durumda giriş paylaşımıdır. Burada kullanılan modül, dosyaları Edge yerel paylaşımından buluta yüklendikleri bir Edge paylaşımına taşır.

Add trigger 2

Tetikleyici oluşturulduktan sonra size bildirilir. Tetikleyici listesi, yeni oluşturulan tetikleyiciyi görüntüleyecek şekilde güncelleştirilir. Yeni oluşturduğunuz tetikleyiciyi seçin.
Örnek yolu kopyalayın ve kaydedin. Bu örnek yolu değiştirecek ve daha sonra IoT Hub'da kullanacaksınız.

"sampleroute": "FROM /* WHERE topic = 'mydbesmbedgelocalshare1' INTO BrokeredEndpoint(\"/modules/modulename/inputs/input1\")"

Modül ekle

Bu Edge cihazında özel modül yok. Özel veya önceden oluşturulmuş bir modül ekleyebilirsiniz. Özel modül oluşturmayı öğrenmek için Azure Stack Edge Pro FPGA cihazınız için C# modülü geliştirme bölümüne gidin.

Bu bölümde, Azure Stack Edge Pro FPGA'nız için C# modülü geliştirme bölümünde oluşturduğunuz IoT Edge cihazına özel bir modül ekleyeceksiniz. Bu özel modül, Dosyaları Edge cihazındaki bir Edge yerel paylaşımından alır ve cihazdaki bir Edge (bulut) paylaşımına taşır. Ardından bulut paylaşımı, dosyaları bulut paylaşımıyla ilişkili Azure depolama hesabına iletir.

Azure Stack Edge kaynağınıza ve ardından IoT Edge'e > Genel Bakış'a gidin. Modüller kutucuğunda Azure IoT Hub'a git'i seçin.

IoT Hub kaynağınızda IoT Edge cihazına gidin ve IoT Edge cihazınızı seçin.
Cihaz ayrıntıları bölümünde Modülleri Ayarla'yı seçin.

Modül Ekle'nin altında aşağıdakileri yapın:

Özel modülün kapsayıcı kayıt defteri ayarlarının adını, adresini, kullanıcı adını ve parolasını girin. Ad, adres ve listelenen kimlik bilgileri, eşleşen BIR URL'ye sahip modülleri almak için kullanılır. Bu modülü dağıtmak için Dağıtım modülleri sayfasında IoT Edge modülü'nü seçin. Bu IoT Edge modülü, Azure Stack Edge Pro FPGA cihazınızla ilişkili IoT Edge cihazına dağıtabileceğiniz bir docker kapsayıcısıdır.

IoT Edge özel modül ayarlarını belirtin. Aşağıdaki değerleri girin.

Alan	Değer
Veri Akışı Adı	Modül için benzersiz bir ad. Bu modül, Azure Stack Edge Pro FPGA'nızla ilişkili IoT Edge cihazına dağıtabileceğiniz bir docker kapsayıcısıdır.
Görüntü URI'si	Modüle karşılık gelen kapsayıcı görüntüsü için görüntü URI'si.
Gerekli kimlik bilgileri	İşaretlenirse, eşleşen BIR URL'ye sahip modülleri almak için kullanıcı adı ve parola kullanılır.

Kapsayıcı Oluşturma Seçenekleri kutusunda, Edge paylaşımı ve Edge yerel paylaşımı için önceki adımlarda kopyaladığınız Edge modülleri için yerel bağlama noktalarını girin.

Önemli

Burada kullanılan yollar kapsayıcınıza bağlanır, bu nedenle kapsayıcınızdaki işlevselliğin beklediğiyle eşleşmeleri gerekir. Özel modül oluştur'u izliyorsanız, bu modülde belirtilen kod kopyalanan yolları bekler. Bu yolları değiştirmeyin.

Kapsayıcı Oluşturma Seçenekleri kutusunda aşağıdaki örneği yapıştırabilirsiniz:

{
  "HostConfig": 
  {
   "Binds": 
    [
     "/home/hcsshares/mydbesmbedgelocalshare1:/home/input",
     "/home/hcsshares/mydbesmbedgeshare1:/home/output"
    ]
   }
}

Modülünüz için kullanılan ortam değişkenlerini sağlayın. Ortam değişkenleri, modülünüzün çalıştığı ortamı tanımlamaya yardımcı olan isteğe bağlı bilgiler sağlar.

The Container Create Options box

Gerekirse gelişmiş Edge çalışma zamanı ayarlarını yapılandırın ve İleri'ye tıklayın.

Yolları Belirt'in altında modüller arasındaki yolları ayarlayın.

Yolu, daha önce kopyaladığınız aşağıdaki yol dizesiyle değiştirebilirsiniz. Bu örnekte, verileri bulut paylaşımına gönderecek yerel paylaşımın adını girin. öğesini modulename modülün adıyla değiştirin. İleri'yi seçin.
```
"route": "FROM /* WHERE topic = 'mydbesmbedgelocalshare1' INTO BrokeredEndpoint(\"/modules/filemove/inputs/input1\")"
```
Dağıtımı gözden geçir'in altında tüm ayarları gözden geçirin ve ardından gönder'i seçerek modülü dağıtıma gönderin.

Bu eylem modül dağıtımını başlatır. Dağıtım tamamlandıktan sonra modülün Çalışma Zamanı durumu çalışır.

Veri dönüşümünü doğrulama, aktarma

Son adım, modülün beklendiği gibi bağlandığından ve çalıştığından emin olmaktır. IoT Hub kaynağında IoT Edge cihazınız için modülün çalışma zamanı durumu çalışıyor olmalıdır.

Veri dönüşümünü ve Azure'a aktarımını doğrulamak için aşağıdaki adımları uygulayın.

Dosya Gezgini'da hem Edge yerel paylaşımlarına hem de daha önce oluşturduğunuz Edge paylaşımlarına bağlanın.
Yerel paylaşıma veri ekleyin.

Veriler bulut paylaşımına taşınır.

Ardından veriler bulut paylaşımından depolama hesabına iletilir. Verileri görüntülemek için depolama hesabınıza gidin ve Depolama Gezgini'ni seçin. Karşıya yüklenen verileri depolama hesabınızda görüntüleyebilirsiniz.