Udostępnij za pośrednictwem

Kompilowanie i wdrażanie usługi zarządzania certyfikatami magazynu OPC

  • Artykuł

Ważne

Chociaż aktualizujemy ten artykuł, zobacz Azure Industrial IoT ,aby uzyskać najbardziej aktualną zawartość.

W tym artykule wyjaśniono, jak wdrożyć usługę zarządzania certyfikatami magazynu OPC na platformie Azure.

Uwaga

Aby uzyskać więcej informacji, zobacz GitHub repozytorium magazynu OPC.

Wymagania wstępne

Instalowanie wymaganego oprogramowania

Obecnie operacja kompilacji i wdrażania jest ograniczona do Windows. Wszystkie przykłady są napisane dla języka C# .NET Standard, które należy skompilować usługę i przykłady na potrzeby wdrożenia. Wszystkie potrzebne narzędzia dla platformy .NET Standard są dostarczane z narzędziami platformy .NET Core. Zobacz Wprowadzenie za pomocą platformy .NET Core.

  1. Zainstaluj program .NET Core 2.1 lub nowszy.
  2. Zainstaluj platformę Docker (opcjonalnie, tylko wtedy, gdy wymagana jest lokalna kompilacja platformy Docker).
  3. Zainstaluj narzędzia wiersza polecenia platformy Azure dla programu PowerShell.
  4. Zarejestruj się w celu uzyskania subskrypcji platformy Azure.

Klonowanie repozytorium

Jeśli jeszcze tego nie zrobiono, sklonuj to repozytorium GitHub. Otwórz wiersz polecenia lub terminal i uruchom następujące polecenie:

git clone https://github.com/Azure/azure-iiot-opc-vault-service
cd azure-iiot-opc-vault-service

Możesz też sklonować repozytorium bezpośrednio w Visual Studio 2017.

Tworzenie i wdrażanie usługi platformy Azure w Windows

Skrypt programu PowerShell umożliwia łatwe wdrażanie mikrousługi magazynu OPC i aplikacji.

  1. Otwórz okno programu PowerShell w katalogu głównym repozytorium.

  2. Przejdź do folderu cd deploydeploy .

  3. Wybierz nazwę, która myResourceGroup jest mało prawdopodobna, aby spowodować konflikt z innymi wdrożonymi stronami internetowymi. Zobacz sekcję "Nazwa witryny internetowej już w użyciu" w dalszej części tego artykułu.

  4. Uruchom wdrożenie za pomocą .\deploy.ps1 polecenia na potrzeby instalacji interakcyjnej lub wprowadź pełny wiersz polecenia:
    .\deploy.ps1 -subscriptionName "MySubscriptionName" -resourceGroupLocation "East US" -tenantId "myTenantId" -resourceGroupName "myResourceGroup"

  5. Jeśli planujesz programowanie przy użyciu tego wdrożenia, dodaj -development 1 , aby włączyć interfejs użytkownika programu Swagger i wdrożyć kompilacje debugowania.

  6. Postępuj zgodnie z instrukcjami w skrypcie, aby zalogować się do subskrypcji i podać dodatkowe informacje.

  7. Po pomyślnej operacji kompilacji i wdrażania powinien zostać wyświetlony następujący komunikat:

    To access the web client go to:
https://myResourceGroup.azurewebsites.net

To access the web service go to:
https://myResourceGroup-service.azurewebsites.net

To start the local docker GDS server:
.\myResourceGroup-dockergds.cmd

To start the local dotnet GDS server:
.\myResourceGroup-gds.cmd

    Uwaga

    W przypadku problemów zobacz sekcję "Rozwiązywanie problemów z błędami wdrażania" w dalszej części artykułu.

  8. Otwórz ulubioną przeglądarkę i otwórz stronę aplikacji: https://myResourceGroup.azurewebsites.net

  9. Nadaj aplikacji internetowej i mikrousłudze OPC Vault kilka minut, aby rozgrzewać się po wdrożeniu. Strona główna sieci Web może przestać odpowiadać na pierwsze użycie przez maksymalnie minutę, dopóki nie otrzymasz pierwszych odpowiedzi.

  10. Aby zapoznać się z interfejsem API struktury Swagger, otwórz: https://myResourceGroup-service.azurewebsites.net

  11. Aby uruchomić lokalny serwer GDS za pomocą polecenia dotnet, uruchom polecenie .\myResourceGroup-gds.cmd. Za pomocą platformy Docker uruchom polecenie .\myResourceGroup-dockergds.cmd.

Można ponownie wdrożyć kompilację z dokładnie tymi samymi ustawieniami. Należy pamiętać, że taka operacja odnawia wszystkie wpisy tajne aplikacji i może zresetować niektóre ustawienia w rejestracjach aplikacji Azure Active Directory (Azure AD).

Możliwe jest również ponowne wdrożenie tylko plików binarnych aplikacji internetowej. Przy użyciu parametru -onlyBuild 1nowe pakiety zip usługi i aplikacji są wdrażane w aplikacjach internetowych.

Po pomyślnym wdrożeniu można rozpocząć korzystanie z usług. Zobacz Zarządzanie usługą zarządzania certyfikatami magazynu OPC.

Usuwanie usług z subskrypcji

Oto kroki tej procedury:

  1. Zaloguj się w witrynie Azure Portal.
  2. Przejdź do grupy zasobów, w której wdrożono usługę.
  3. Wybierz pozycję Usuń grupę zasobów i potwierdź.
  4. Po krótkim czasie wszystkie wdrożone składniki usługi zostaną usunięte.
  5. Przejdź do Azure Active Directory>Rejestracje aplikacji.
  6. Dla każdej wdrożonej grupy zasobów powinny istnieć trzy rejestracje. Rejestracje mają następujące nazwy: resourcegroup-client, resourcegroup-module, resourcegroup-service. Usuń każdą rejestrację oddzielnie.

Teraz wszystkie wdrożone składniki zostaną usunięte.

Rozwiązywanie problemów z błędami wdrażania

Nazwa grupy zasobów

Użyj krótkiej i prostej nazwy grupy zasobów. Nazwa jest również używana do nazywania zasobów i prefiksu adresu URL usługi. W związku z tym musi on być zgodny z wymaganiami dotyczącymi nazewnictwa zasobów.

Nazwa witryny internetowej jest już używana

Możliwe, że nazwa witryny internetowej jest już używana. Należy użyć innej nazwy grupy zasobów. Nazwy hostów używane przez skrypt wdrażania to: https://resourcegroupname.azurewebsites.net i https://resourgroupname-service.azurewebsites.net. Inne nazwy usług są tworzone przez kombinację skrótów nazw krótkich i są mało prawdopodobne, aby powodować konflikt z innymi usługami.

Rejestracja w usłudze Azure AD

Skrypt wdrażania próbuje zarejestrować trzy aplikacje usługi Azure AD w usłudze Azure AD. W zależności od uprawnień w wybranej dzierżawie usługi Azure AD ta operacja może zakończyć się niepowodzeniem. Dostępne są dwie opcje:

  • Jeśli wybrano dzierżawę usługi Azure AD z listy dzierżaw, uruchom ponownie skrypt i wybierz inną z listy.
  • Alternatywnie wdróż prywatną dzierżawę usługi Azure AD w innej subskrypcji. Uruchom ponownie skrypt i wybierz go, aby go użyć.

Opcje skryptu wdrażania

Skrypt przyjmuje następujące parametry:

-resourceGroupName

Może to być nazwa istniejącej lub nowej grupy zasobów.

-subscriptionId

Jest to identyfikator subskrypcji, w której zostaną wdrożone zasoby. Jest to opcjonalne.

-subscriptionName

Alternatywnie możesz użyć nazwy subskrypcji.

-resourceGroupLocation

Jest to lokalizacja grupy zasobów. Jeśli zostanie określony, ten parametr próbuje utworzyć nową grupę zasobów w tej lokalizacji. Ten parametr jest również opcjonalny.

-tenantId

Jest to dzierżawa usługi Azure AD do użycia.

-development 0|1

Jest to wdrożenie na potrzeby programowania. Użyj kompilacji debugowania i ustaw środowisko ASP.NET na Programowanie. Utwórz .publishsettings do importowania w Visual Studio 2017 r., aby umożliwić jej bezpośrednie wdrożenie aplikacji i usługi. Ten parametr jest również opcjonalny.

-onlyBuild 0|1

Jest to ponowne kompilowanie i ponowne wdrażanie tylko aplikacji internetowych oraz ponowne kompilowanie kontenerów platformy Docker. Ten parametr jest również opcjonalny.

Następne kroki

Teraz, gdy wiesz już, jak wdrożyć magazyn OPC od podstaw, możesz wykonać następujące czynności:

Zarządzanie magazynem OPC