OPC Vault sertifika yönetim hizmetini derleme ve dağıtma

Makale
08/16/2019

Önemli

Bu makaleyi güncelleştirirken en güncel içerik için bkz. Azure Endüstriyel IoT .

Bu makalede, OPC Vault sertifika yönetim hizmetinin Azure'da nasıl dağıtılacağı açıklanmaktadır.

Not

Daha fazla bilgi için bkz. GitHub OPC Vault deposu.

Önkoşullar

Gerekli yazılımları yükleme

Şu anda derleme ve dağıtma işlemi Windows ile sınırlıdır. Örneklerin tümü C# .NET Standard için yazılmıştır. Bu, hizmeti ve dağıtım için örnekleri oluşturmanız gerekir. .NET Standard için ihtiyacınız olan tüm araçlar .NET Core araçlarıyla birlikte gelir. Bkz. .NET Core ile Kullanmaya başlayın.

.NET Core 2.1+ yükleyin.
Docker'ı yükleyin (isteğe bağlı, yalnızca yerel Docker derlemesi gerekiyorsa).
PowerShell için Azure komut satırı araçlarını yükleyin.
Azure aboneliğine kaydolun.

Depoyu kopyalama

Henüz yapmadıysanız bu GitHub depoyu kopyalayın. Bir komut istemi veya terminal açın ve aşağıdakileri çalıştırın:

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

Alternatif olarak, depoyu doğrudan Visual Studio 2017'de kopyalayabilirsiniz.

Windows üzerinde Azure hizmetini derleme ve dağıtma

PowerShell betiği, OPC Vault mikro hizmetini ve uygulamayı dağıtmak için kolay bir yol sağlar.

Depo kökünde bir PowerShell penceresi açın.
Deploy klasörüne cd deploygidin.
Dağıtılan diğer web sayfalarıyla çakışmaya neden olma olasılığı düşük bir ad myResourceGroup seçin. Bu makalenin devamında yer alan "Web sitesi adı zaten kullanılıyor" bölümüne bakın.
Etkileşimli yükleme için dağıtımı ile .\deploy.ps1 başlatın veya tam bir komut satırı girin:
.\deploy.ps1 -subscriptionName "MySubscriptionName" -resourceGroupLocation "East US" -tenantId "myTenantId" -resourceGroupName "myResourceGroup"
Bu dağıtımla geliştirmeyi planlıyorsanız Swagger kullanıcı arabirimini etkinleştirmek ve hata ayıklama derlemelerini dağıtmak için öğesini ekleyin -development 1 .
Aboneliğinizde oturum açmak ve ek bilgi sağlamak için betikteki yönergeleri izleyin.

Başarılı bir derleme ve dağıtma işleminden sonra aşağıdaki iletiyi görmeniz gerekir:

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

Not

Sorun olması durumunda makalenin devamında yer alan "Dağıtım hatalarını giderme" bölümüne bakın.

Sık kullandığınız tarayıcıyı açın ve uygulama sayfasını açın: https://myResourceGroup.azurewebsites.net
Web uygulamasına ve OPC Vault mikro hizmetine dağıtımdan sonra ısınması için birkaç dakika verin. Web giriş sayfası ilk kullanımda yanıt vermeyi durdurabilir ve siz ilk yanıtları alıncaya kadar bir dakika kadar sürebilir.
Swagger API'sine göz atmak için şunu açın: https://myResourceGroup-service.azurewebsites.net
Dotnet ile yerel bir GDS sunucusu başlatmak için öğesini başlatın .\myResourceGroup-gds.cmd. Docker ile başlatın .\myResourceGroup-dockergds.cmd.

Bir derlemeyi tamamen aynı ayarlarla yeniden dağıtmak mümkündür. Böyle bir işlemin tüm uygulama gizli dizilerini yenilediğini ve Azure Active Directory (Azure AD) uygulama kayıtlarındaki bazı ayarları sıfırlayabileceğini unutmayın.

Yalnızca web uygulaması ikili dosyalarını yeniden dağıtmak da mümkündür. parametresiyle -onlyBuild 1, hizmetin ve uygulamanın yeni zip paketleri web uygulamalarına dağıtılır.

Başarılı bir dağıtımdan sonra hizmetleri kullanmaya başlayabilirsiniz. Bkz. OPC Vault sertifika yönetim hizmetini yönetme.

Abonelikten hizmetleri silme

Bunu yapmak için:

Azure portalda oturum açın.
Hizmetin dağıtıldığı kaynak grubuna gidin.
Kaynak grubunu sil'i seçip onaylayın.
Kısa bir süre sonra dağıtılan tüm hizmet bileşenleri silinir.
Azure Active Directory>Uygulama kayıtları gidin.
Dağıtılan her kaynak grubu için üç kayıt listelenmelidir. Kayıtlar şu adlara sahiptir: resourcegroup-client, resourcegroup-module, resourcegroup-service. Her kaydı ayrı ayrı silin.

Artık dağıtılan tüm bileşenler kaldırılmıştır.

Dağıtım hatalarını giderme

Kaynak grubu adı

Kısa ve basit bir kaynak grubu adı kullanın. Ad, kaynakları ve hizmet URL'si ön ekini adlandırmak için de kullanılır. Bu nedenle, kaynak adlandırma gereksinimlerine uyması gerekir.

Web sitesi adı zaten kullanılıyor

Web sitesinin adı zaten kullanılıyor olabilir. Farklı bir kaynak grubu adı kullanmanız gerekir. Dağıtım betiği tarafından kullanılan konak adları şunlardır: https://resourcegroupname.azurewebsites.net ve https://resourgroupname-service.azurewebsites.net. Diğer hizmet adları, kısa ad karmalarının birleşimiyle oluşturulur ve diğer hizmetlerle çakışma olasılığı düşüktür.

Azure AD kaydı

Dağıtım betiği, Azure AD'ye üç Azure AD uygulaması kaydetmeye çalışır. Seçili Azure AD kiracısında izinlerinize bağlı olarak bu işlem başarısız olabilir. İki seçenek vardır:

Kiracı listesinden bir Azure AD kiracısı seçtiyseniz betiği yeniden başlatın ve listeden farklı bir kiracı seçin.
Alternatif olarak, başka bir abonelikte özel bir Azure AD kiracısı dağıtabilirsiniz. Betiği yeniden başlatın ve kullanmak için seçin.

Dağıtım betiği seçenekleri

Betik aşağıdaki parametreleri alır:

-resourceGroupName

Bu, var olan veya yeni bir kaynak grubunun adı olabilir.

-subscriptionId

Bu, kaynakların dağıtılacağı abonelik kimliğidir. İsteğe bağlıdır.

-subscriptionName

Alternatif olarak abonelik adını da kullanabilirsiniz.

-resourceGroupLocation

Bu bir kaynak grubu konumudur. Belirtilirse, bu parametre bu konumda yeni bir kaynak grubu oluşturmaya çalışır. Bu parametre de isteğe bağlıdır.

-tenantId

Bu, kullanılacak Azure AD kiracısıdır.

-development 0|1

Bu, geliştirme için dağıtılacaktır. Hata ayıklama derlemesini kullanın ve ASP.NET ortamını Geliştirme olarak ayarlayın. Uygulamayı ve hizmeti doğrudan dağıtabilmesi için Visual Studio 2017'de içeri aktarma için oluşturun.publishsettings. Bu parametre de isteğe bağlıdır.

-onlyBuild 0|1

Bu, yalnızca web uygulamalarını yeniden derlemek ve yeniden dağıtmak ve Docker kapsayıcılarını yeniden derlemektir. Bu parametre de isteğe bağlıdır.

Sonraki adımlar

OPC Vault'un sıfırdan nasıl dağıtıldığını öğrendiğinize göre şunları yapabilirsiniz:

OPC Vault'un yönetimi

Aracılığıyla paylaş