Azure Stack Hub'da Node.js yazılım geliştirme seti (SDK) ile API sürümü profillerini kullanma

  • Makale

Node.js ve API sürümü profilleri

Node.js SDK'sını kullanarak uygulamalarınıza yönelik altyapıyı derleyebilir ve yönetebilirsiniz. Node.js SDK'sı içindeki API profilleri, genel Azure kaynaklarıyla Azure Stack Hub kaynakları arasında geçiş yapmanıza izin vererek hibrit bulut çözümlerinize yardımcı olur. Bir kez kodlayabilir ve ardından hem genel Azure'ı hem de Azure Stack Hub'ı hedefleyebilirsiniz.

Bu makalede geliştirme aracı olarak Visual Studio Code kullanabilirsiniz. Visual Studio Code Node.js SDK'sının hatalarını ayıklayabilir ve uygulamayı çalıştırıp Azure Stack Hub örneğine göndermenizi sağlar. Visual Studio Code veya komutunu node <nodefile.js>çalıştıran bir terminal penceresinden hata ayıklayabilirsiniz.

The Node.js SDK

Node.js SDK'sı, Azure Stack Hub Resource Manager araçları sağlar. SDK'daki kaynak sağlayıcıları arasında işlem, ağ, depolama, uygulama hizmetleri ve KeyVault bulunur. node.js uygulamanıza yükleyebileceğiniz 10 kaynak sağlayıcısı istemci kitaplığı vardır. Ayrıca, uygulamanızın belleğini iyileştirmek için 2020-09-01-profili için hangi kaynak sağlayıcısını kullanacağınızı da indirebilirsiniz. Her modül bir kaynak sağlayıcısından, ilgili API sürümünden ve API profilinden oluşur.

API profili, kaynak sağlayıcıları ve API sürümlerinin birleşimidir. Bir kaynak sağlayıcısı paketindeki her kaynak türünün en son ve en kararlı sürümünü almak için bir API profili kullanabilirsiniz.

  • Tüm hizmetlerin en son sürümlerini kullanmak için paketlerin en son profilini kullanın.

  • Azure Stack Hub ile uyumlu hizmetleri kullanmak için @azure/arm-resources-profile-hybrid-2020-09-01 veya @azure/arm-storage-profile-2020-09-01-hybrid kullanın

NPM Paketleri

Her kaynak sağlayıcısının kendi paketi vardır. Paketi npm kayıt defterinden alabilirsiniz.

Aşağıdaki paketleri bulabilirsiniz:

Kaynak sağlayıcısı Paket
App Service @azure/arm-resources-profile-2020-09-01-hybrid
Azure Resource Manager Abonelikleri @azure/arm-subscriptions-profile-hybrid-2020-09-01
Azure Resource Manager İlkesi @azure/arm-policy-profile-hybrid-2020-09-01
Azure Resource Manager DNS @azure/arm-dns-profile-2020-09-01-hybrid
Yetkilendirme @azure/arm-authorization-profile-2020-09-01-hybrid
İşlem @azure/arm-compute-profile-2020-09-01-hybrid
Depolama @azure/arm-storage-profile-2020-09-01-hybrid
Ağ @azure/arm-network-profile-2020-09-01-hybrid
Kaynaklar @azure/arm-resources-profile-hybrid-2020-09-01
Keyvault @azure/arm-keyvault-profile-2020-09-01-hybrid

Bir hizmetin en son API sürümünü kullanmak için, belirli bir istemci kitaplığının En son profilini kullanın. Örneğin, yalnızca kaynak hizmetinin en son API sürümünü kullanmak istiyorsanız, Kaynak Yönetimi İstemci Kitaplığı paketinin profilini kullanınazure-arm-resource.

Bir kaynak sağlayıcısının belirli API sürümleri için paketin içinde tanımlanan belirli API sürümlerini kullanın.

  • @azure/arm-resourceprovider-profile-2020-09-01-hybrid

    Azure Stack Hub için oluşturulan en son Profil. 1808 damga pulu veya daha ilerisinde olduğunuz sürece hizmetlerin Azure Stack Hub ile en iyi şekilde uyumlu olması için bu profili kullanın.

  • @azure-arm-resource

    Profil, tüm hizmetlerin en son sürümlerinden oluşur. Azure'daki tüm hizmetlerin en son sürümlerini kullanın.

Profiller

Tarih içeren profiller için farklı bir SDK profili veya sürümü kullanmak için içindeki @azure/arm-keyvault-profile-<date>-hybridtarihin yerine kullanabilirsiniz. Örneğin, 2008 sürümü için profil olur 2019-03-01ve dize olur @azure/arm-keyvault-profile-2019-03-01-hybrid. Bazen SDK ekibinin paketlerin adını değiştirdiğini unutmayın; bu nedenle bir dizenin tarihini farklı bir tarihle değiştirmek işe yaramayabilir. Profillerin ve Azure Stack sürümlerinin ilişkilendirmesi için aşağıdaki tabloya bakın.

Azure Stack sürümü Profil
2311 2020_09_01
2301 2020_09_01
2206 2020_09_01
2108 2020-09-01
2102 2020-09-01
2008 2019-03-01

Azure Stack Hub ve API profilleri hakkında daha fazla bilgi için bkz. API profillerinin özeti.

Node.js SDK'sını yükleme

  1. Git'i yükleyin. Yönergeler için bkz . Başlarken - Git'i Yükleme.

  2. Node.js'in geçerli sürümünü yükleyin veya sürümüne yükseltin. Node.js ayrıca npm JavaScript paket yöneticisini de içerir.

  3. Visual Studio Code yükleyin veya yükseltin ve Visual Studio Code içinNode.js uzantısını yükleyin.

  4. Azure Stack Hub Kaynak Yöneticisi için istemci paketlerini yükleyin. Daha fazla bilgi için bkz. İstemci kitaplıklarını yükleme.

  5. Yüklenmesi gereken paketler, kullanmak istediğiniz profil sürümüne bağlıdır. Npm'deki paketler bölümünde kaynak sağlayıcılarının listesini bulabilirsiniz.

Abonelik

Henüz aboneliğiniz yoksa bir abonelik oluşturun ve daha sonra kullanmak üzere abonelik kimliğini kaydedin. Abonelik oluşturma hakkında bilgi için bu belgeye bakın.

Hizmet sorumlusu

Bir hizmet sorumlusu ve ilişkili ortam bilgileri oluşturulup bir yere kaydedilmelidir. Rolü olan owner hizmet sorumlusu önerilir, ancak örne bağlı olarak bir contributor rol yeterli olabilir. Gerekli değerler için örnek depodaki BENİOKU'ya bakın. Bu değerleri SDK dili tarafından desteklenen JSON dosyasından (örneklerimizin kullandığı) gibi herhangi bir biçimde okuyabilirsiniz. Çalıştırılan örne bağlı olarak, bu değerlerin tümü kullanılamaz. Güncelleştirilmiş örnek kod veya daha fazla bilgi için örnek depoya bakın.

Kiracı Kimliği

Azure Stack Hub'ınızın dizin veya kiracı kimliğini bulmak için bu makaledeki yönergeleri izleyin.

Kaynak sağlayıcılarını kaydetme

Bu belgeyi izleyerek gerekli kaynak sağlayıcılarını kaydedin. Çalıştırmak istediğiniz örneklere bağlı olarak bu kaynak sağlayıcıları gereklidir. Örneğin, bir VM örneği çalıştırmak istiyorsanız kaynak Microsoft.Compute sağlayıcısı kaydı gereklidir.

Azure Stack kaynak yöneticisi uç noktası

Azure Resource Manager (ARM), yöneticilerin Azure kaynaklarını dağıtmasını, yönetmesini ve izlemesini sağlayan bir yönetim çerçevesidir. Azure Resource Manager bu görevleri tek bir işlemde tek tek değil grup olarak işleyebilir. Meta veri bilgilerini Resource Manager uç noktasından alabilirsiniz. Uç nokta, kodunuzu çalıştırmak için gereken bilgileri içeren bir JSON dosyası döndürür.

Aşağıdaki topluluklara bir göz atın:

  • Azure Stack Geliştirme Seti'ndeki (ASDK) ResourceManagerEndpointUrl : https://management.local.azurestack.external/.

  • Tümleşik sistemlerdeki ResourceManagerEndpointUrl şu şekildedir: https://management.region.<fqdn>/burada <fqdn> tam etki alanı adınızdır.

  • Gerekli meta verileri almak için: <ResourceManagerUrl>/metadata/endpoints?api-version=1.0

Örnek JSON:

{
   "galleryEndpoint": "https://portal.local.azurestack.external:30015/",
   "graphEndpoint": "https://graph.windows.net/",
   "portal Endpoint": "https://portal.local.azurestack.external/",
   "authentication": 
      {
         "loginEndpoint": "https://login.windows.net/",
         "audiences": ["https://management.yourtenant.onmicrosoft.com/3cc5febd-e4b7-4a85-a2ed-1d730e2f5928"]
      }
}

Örnekler

Güncel örnek kod için örnek depoya bakın. Kök README.md , genel gereksinimleri açıklar ve her alt dizin, bu örneğin nasıl çalıştırıldığına ilişkin kendi README.md örneği içeren belirli bir örneği içerir.

Azure Stack sürümü 2008 veya profili 2019-03-01 için geçerli olan örnek için buraya ve aşağıya bakın.

Sonraki adımlar

API profilleri hakkında daha fazla bilgi edinin: