Udostępnij za pośrednictwem

Informacje o obsłudze odłączonych aktualizacji urządzeń (wersja zapoznawcza)

  • Artykuł

Moduł Microsoft Connected Cache (MCC) dla urządzeń IoT Edge umożliwia korzystanie z funkcji aktualizacji urządzeń na urządzeniach odłączonych za bramami. W scenariuszu przezroczystej bramy co najmniej jedno urządzenie może przekazywać komunikaty za pośrednictwem jednego urządzenia bramy, które utrzymuje połączenie z Azure IoT Hub. W takich przypadkach urządzenia podrzędne mogą nie mieć łączności z Internetem lub mogą nie mieć możliwości pobierania zawartości z Internetu. Moduł MCC zapewnia aktualizację urządzenia dla IoT Hub klientów z możliwością inteligentnej pamięci podręcznej w sieci. Pamięć podręczna umożliwia oparte na obrazach i pakietach aktualizacje urządzeń z systemem operacyjnym Linux, które znajdują się za bramą IoT Edge (nazywaną również podrzędnymi urządzeniami IoT). Pamięć podręczna pomaga również zmniejszyć przepustowość używaną do aktualizacji.

Uwaga

Te informacje dotyczą funkcji w wersji zapoznawczej, która jest dostępna do wczesnego testowania i używania w środowisku produkcyjnym. Ta funkcja jest w pełni obsługiwana, ale nadal jest aktywna i może otrzymywać istotne zmiany, dopóki nie stanie się ogólnie dostępna.

Jeśli nie znasz bram IoT Edge, dowiedz się więcej o sposobie użycia urządzenia IoT Edge jako bramy.

Co to jest usługa Microsoft Connected Cache

Microsoft Connected Cache to inteligentna, przezroczysta pamięć podręczna zawartości opublikowanej w usłudze Device Update dla IoT Hub i może być dostosowywana do buforowania zawartości z innych źródeł, takich jak repozytoria pakietów. Microsoft Connected Cache to zimna pamięć podręczna, która jest ogrzewana przez żądania klientów dotyczące dokładnych zakresów plików żądanych przez klienta optymalizacji dostarczania i nie inicjuje zawartości wstępnej. Na poniższym diagramie i opis krok po kroku wyjaśniono, jak działa usługa Microsoft Connected Cache w infrastrukturze aktualizacji urządzeń.

Uwaga

W tym przepływie przyjęto założenie, że brama IoT Edge ma łączność z Internetem. W scenariuszu bramy IoT Edge podrzędnej (zagnieżdżonej krawędzi) sieć dostarczania zawartości (CDN) może być uznawana za mcC hostowaną w nadrzędnej bramie IoT Edge.

Diagram pokazujący, w jaki sposób moduł microsoft Connected Cache umożliwia odłączoną aktualizację urządzenia.

  1. Usługa Microsoft Connected Cache jest wdrażana jako moduł IoT Edge na serwerze bramy lokalnej.

  2. Aktualizacja urządzenia dla klientów IoT Hub jest skonfigurowana do pobierania zawartości z usługi Microsoft Connected Cache przy użyciu atrybutu GatewayHostName parametrów połączenia urządzenia dla urządzeń liści IoT lub parent_hostname ustawionych w pliku config.toml dla urządzeń podrzędnych IoT Edge.

  3. Usługa Device Update dla klientów IoT Hub odbiera polecenia pobierania z usługi Device Update i żąda zawartości aktualizacji z usługi Microsoft Connected Cache zamiast sieci CDN. Usługa Microsoft Connected Cache domyślnie nasłuchuje na porcie HTTP 80, a klient optymalizacji dostarczania wysyła żądanie zawartości na porcie 80, więc element nadrzędny musi być skonfigurowany do nasłuchiwania na tym porcie. Obecnie obsługiwany jest tylko protokół HTTP.

  4. Serwer microsoft Connected Cache pobiera zawartość z usługi CDN, rozmieszcza lokalną pamięć podręczną przechowywaną na dysku i dostarcza zawartość do klienta usługi Device Update.

    Uwaga

    W przypadku korzystania z aktualizacji opartych na pakietach serwer usługi Microsoft Connected Cache zostanie skonfigurowany przez administratora przy użyciu wymaganej nazwy hosta pakietu.

  5. Kolejne żądania od innych klientów usługi Device Update dla tej samej zawartości aktualizacji pochodzą teraz z pamięci podręcznej, a usługa Microsoft Connected Cache nie wysyła żądań do sieci CDN dla tej samej zawartości.

Obsługa przemysłowych IoT (IIoT) w scenariuszach hostingu nadrzędnego/podrzędnego

Scenariusze przemysłowych IoT (IIoT) często obejmują wiele poziomów bram IoT Edge, a tylko najwyższy poziom ma dostęp do Internetu. W tym scenariuszu każda brama hostuje usługę Microsoft Connected Cache skonfigurowaną do żądania aktualizacji zawartości z bramy nadrzędnej.

Gdy podrzędna (lub podrzędna) brama IoT Edge wysyła żądanie aktualizacji zawartości z bramy nadrzędnej, to żądanie jest powtarzane przez tyle poziomów, ile jest to konieczne, przed dotarciem do najbardziej IoT Edge bramy hostujące serwer usługi Microsoft Connected Cache, który ma dostęp do Internetu. Z serwera połączonego z Internetem zawartość jest żądana z sieci CDN, w której zawartość jest dostarczana z powrotem do podrzędnej bramy IoT Edge, która pierwotnie zażądała zawartości. Zawartość jest przechowywana na dysku na każdym poziomie.

Żądanie dostępu do wersji zapoznawczej

Moduł microsoft Connected Cache IoT Edge jest udostępniany jako wersja zapoznawcza dla klientów wdrażających rozwiązania korzystające z usługi Device Update dla IoT Hub. Dostęp do wersji zapoznawczej odbywa się za zaproszeniem. Zażądaj dostępu do wersji zapoznawczej usługi Microsoft Connected Cache dla usługi Device Update dla IoT Hub i podaj wymagane informacje, jeśli chcesz uzyskać dostęp do modułu.

Konfiguracja modułu Microsoft Connected Cache

Usługa Microsoft Connected Cache jest wdrażana w bramach usługi Azure IoT Edge jako moduł IoT Edge. Podobnie jak inne moduły IoT Edge, zmienne środowiskowe i opcje tworzenia kontenera są używane do konfigurowania modułów MCC. W tej sekcji zdefiniowano zmienne środowiskowe i opcje tworzenia kontenera, które są wymagane do pomyślnego wdrożenia modułu MCC do użycia przez usługę Device Update dla IoT Hub.

Nie ma wymagania dotyczącego nazewnictwa modułu Microsoft Connected Cache, ponieważ żadne inne interakcje z modułem ani usługą nie opierają się na nazwie modułu MCC na potrzeby komunikacji. Ponadto relacja nadrzędny-podrzędna serwerów usługi Microsoft Connected Cache nie zależy od nazwy tego modułu, ale raczej nazwy FQDN lub adresu IP bramy IoT Edge.

Zmienne środowiskowe modułu

Zmienne środowiskowe modułu Microsoft Connected Cache są używane do przekazywania podstawowych informacji o tożsamości modułu i ustawień modułu funkcjonalnego do kontenera.

Nazwa zmiennej Format wartości Opis
CUSTOMER_ID Identyfikator GUID identyfikatora subskrypcji platformy Azure Wymagane

Ta wartość jest identyfikatorem klienta, który zapewnia bezpieczne uwierzytelnianie węzła pamięci podręcznej w usługach optymalizacji dostarczania.
CACHE_NODE_ID Identyfikator GUID węzła pamięci podręcznej Wymagane

Unikatowo identyfikuje węzeł MCC do usług optymalizacji dostarczania.
CUSTOMER_KEY Identyfikator GUID klucza klienta Wymagane

Ta wartość jest kluczem klienta, który zapewnia bezpieczne uwierzytelnianie węzła pamięci podręcznej w usługach optymalizacji dostarczania.
STORAGE_N_SIZE_GB (gdzie N to dysk pamięci podręcznej) Liczba całkowita Wymagane

Określ maksymalnie dziewięć dysków do buforowania zawartości i określ maksymalną ilość miejsca w gigabajtach do przydzielenia zawartości na każdym dysku pamięci podręcznej. Liczba dysków musi być zgodna z wartościami powiązania dysku pamięci podręcznej określonymi w opcji tworzenia kontenera MicrosoftConnectedCacheN .

Przykłady:
STORAGE_1_SIZE_GB = 150
STORAGE_2_SIZE_GB = 50

Minimalny rozmiar pamięci podręcznej wynosi 10 GB.
UPSTREAM_HOST Nazwa FQDN/adres IP Opcjonalne

Ta wartość może określać nadrzędny węzeł MCC, który działa jako serwer proxy, jeśli węzeł połączonej pamięci podręcznej jest odłączony od Internetu. To ustawienie służy do obsługi zagnieżdżonego scenariusza IoT.

Uwaga: Program MCC nasłuchuje na domyślnym porcie HTTP 80.
UPSTREAM_PROXY Nazwa FQDN/ADRES IP:PORT Opcjonalne

Wychodzący internetowy serwer proxy. Ta wartość może być również serwerem proxy OT DMZ sieci ISA 95.
CACHEABLE_CUSTOM_N_HOST HOST/ADRES IP
Nazwa FQDN		 Opcjonalne

Wymagane do obsługi niestandardowych repozytoriów pakietów. Repozytoria mogą być hostowane lokalnie lub w Internecie. Nie ma limitu liczby hostów niestandardowych, które można skonfigurować.

Przykłady:
Name = wartość CACHEABLE_CUSTOM_1_HOST = packages.foo.com
Name = wartość CACHEABLE_CUSTOM_2_HOST = packages.bar.com
CACHEABLE_CUSTOM_N_CANONICAL Alias Opcjonalne

Wymagane do obsługi niestandardowych repozytoriów pakietów. Ta wartość może być używana jako alias i będzie używana przez serwer pamięci podręcznej do odwoływanie się do różnych nazw DNS. Na przykład nazwa hosta zawartości repozytorium może być packages.foo.com, ale w różnych regionach może istnieć dodatkowy prefiks dodany do nazwy hosta, taki jak westuscdn.packages.foo.com i eastuscdn.packages.foo.com. Ustawiając alias kanoniczny, upewnij się, że zawartość nie jest duplikowana dla zawartości pochodzącej z tego samego hosta, ale z różnych źródeł CDN. Format wartości kanonicznej nie jest ważny, ale musi być unikatowy dla hosta. Najłatwiej ustawić wartość tak, aby była zgodna z wartością hosta.

Przykłady oparte na poprzednich przykładach hostów niestandardowych:
Nazwa = wartość CACHEABLE_CUSTOM_1_CANONICAL = foopackages
Name = wartość CACHEABLE_CUSTOM_2_CANONICAL = packages.bar.com
IS_SUMMARY_PUBLIC Prawda czy fałsz Opcjonalne

Umożliwia wyświetlanie raportu podsumowania w sieci lokalnej lub Internecie. Użycie klucza interfejsu API (omówionego w dalszej części) jest wymagane do wyświetlenia raportu podsumowania, jeśli ma wartość true.
IS_SUMMARY_ACCESS_UNRESTRICTED Prawda czy fałsz Opcjonalne

Umożliwia wyświetlanie raportu podsumowania w sieci lokalnej lub Internecie bez użycia klucza interfejsu API z dowolnego urządzenia w sieci. Użyj polecenia , jeśli nie chcesz blokować dostępu do wyświetlania danych podsumowania serwera pamięci podręcznej za pośrednictwem przeglądarki.

Opcje tworzenia kontenera modułu

Opcje tworzenia kontenera zapewniają kontrolę ustawień związanych z magazynem i portami używanymi przez moduł Microsoft Connected Cache.

Przykładowe opcje tworzenia kontenera:

{
    "HostConfig": {
        "Binds": [
            "/microsoftConnectedCache1/:/nginx/cache1/"
        ],
        "PortBindings": {
            "8081/tcp": [
                {
                    "HostPort": "80"
                }
            ],
            "5000/tcp": [
                {
                    "HostPort": "5100"
                }
            ]
        }
    }
}

W poniższych sekcjach wymieniono wymagane zmienne tworzenia kontenera używane do wdrażania modułu MCC.

Konfiguracja hosta

Parametry HostConfig są wymagane do mapowania lokalizacji magazynu kontenera na lokalizację magazynu na dysku. Można określić maksymalnie dziewięć lokalizacji.

Uwaga

Liczba dysków musi być zgodna z wartościami powiązania dysku pamięci podręcznej określonymi w zmiennej środowiskowej STORAGE_N_SIZE_GB wartość . /MicrosoftConnectedCache*N*/:/nginx/cache*N*/

Powiązania portów

PortBindings Parametry mapować porty kontenera na porty na urządzeniu hosta.

Pierwsze powiązanie portu określa port HTTP maszyny zewnętrznej, na który nasłuchuje MCC żądań zawartości. Domyślny hostPort to port 80, a inne porty nie są obecnie obsługiwane, ponieważ klient usługi ADU wysyła żądania na porcie 80 dzisiaj. Port TCP 8081 jest wewnętrznym portem kontenera, na który nasłuchuje mcC i nie można go zmienić.

Drugie powiązanie portu gwarantuje, że kontener nie nasłuchuje na porcie hosta 5000. Moduł Microsoft Connected Cache ma usługę .NET Core, która jest używana przez aparat buforowania dla różnych funkcji. Aby obsługiwać zagnieżdżonych krawędzi, port hosta nie może być ustawiony na wartość 5000, ponieważ moduł serwera proxy rejestru nasłuchuje już na porcie hosta 5000.

Raport podsumowania usługi Microsoft Connected Cache

Raport podsumowania jest obecnie jedynym sposobem wyświetlania danych buforowania dla wystąpień usługi Microsoft Connected Cache wdrożonych w bramach IoT Edge. Raport jest generowany w 15-sekundowych odstępach czasu i zawiera średnie statystyki dla okresu i zagregowane statystyki dla okresu istnienia modułu. Kluczowe statystyki, które udostępnia raport, to:

  • hitBytes — suma bajtów dostarczonych bezpośrednio z pamięci podręcznej.
  • missBytes — suma bajtów dostarczonych przez usługę Microsoft Connected Cache musiała pobrać z sieci CDN, aby wyświetlić pamięć podręczną.
  • eggressBytes — suma trafień i missBytes i jest łączną ilością bajtów dostarczonych do klientów.
  • hitRatioBytes — stosunek hitBytes do ruchu wychodzącegoBytes. Jeśli na przykład 100% eggressBytes dostarczonych w okresie jest równe hitBytes, ta wartość będzie równa 1.

Raport podsumowania jest dostępny na stronie http://<IoT Edge gateway>:5001/summary Zastąp <bramę IoT Edge> adresem IP lub nazwą hosta bramy IoT Edge hostując moduł MCC.

Następne kroki

Dowiedz się, jak zaimplementować usługę Microsoft Connected Cache w pojedynczych bramach lub zagnieżdżonych i przemysłowych bram IoT.