Menggunakan profil versi API dengan Python di Azure Stack Hub

Penting

Python SDK telah diperbarui dari trek 1 ke trek 2. Sebaiknya migrasikan ke SDK trek 2 sesegera mungkin. Untuk petunjuknya, lihat panduan migrasi ini.

Python SDK mendukung profil versi API untuk menargetkan platform cloud yang berbeda, seperti Azure Stack Hub dan Azure global. Gunakan profil API dalam membuat solusi untuk cloud hibrid.

Instruksi dalam artikel ini memerlukan langganan Microsoft Azure. Jika Anda tidak memilikinya, Anda bisa mendapatkan akun uji coba gratis.

Profil versi Python dan API

Python SDK mendukung profil API berikut:

  • Terbaru
    Profil ini menargetkan versi API terbaru untuk semua penyedia layanan di platform Azure.

  • 2020_09_01_hybrid
    Profil ini menargetkan versi API terbaru untuk semua penyedia sumber daya di platform Azure Stack Hub untuk versi 2102 atau yang lebih baru.

  • 2019_03_01_hybrid
    Profil ini menargetkan versi API terbaru untuk semua penyedia sumber daya di platform Azure Stack Hub untuk versi 1904 atau yang lebih baru.

    Untuk informasi selengkapnya tentang profil API dan Azure Stack Hub, lihat Mengelola profil versi API di Azure Stack Hub.

Menginstal Azure Python SDK

  1. Pasang Git.
  2. Instal Python SDK.

Profil

Untuk profil yang berisi tanggal, untuk menggunakan profil atau versi SDK yang berbeda, ganti tanggal di v<date>_hybrid. Misalnya, untuk versi 2008, profilnya adalah 2019_03_01, dan string menjadi v2019_03_01_hybrid. Perhatikan bahwa terkadang tim SDK mengubah nama paket, jadi cukup ganti tanggal string dengan tanggal yang berbeda mungkin tidak berfungsi. Lihat tabel berikut untuk asosiasi profil dan versi Azure Stack.

Versi Azure Stack Profil
2311 01/09/2020
2301 01/09/2020
2206 01/09/2020
2108 01/09/2020
2102 01/09/2020
2008 01/03/2019

Untuk informasi selengkapnya tentang profil Azure Stack Hub dan API, lihat Ringkasan profil API.

Lihat profil Python SDK.

Langganan

Jika Anda belum memiliki langganan, buat langganan dan simpan ID langganan yang akan digunakan nanti. Untuk informasi tentang cara membuat langganan, lihat dokumen ini.

Principal layanan

Prinsipal layanan dan informasi lingkungan terkait harus dibuat dan disimpan di lokasi tertentu. Perwakilan layanan dengan owner peran disarankan, tetapi tergantung pada sampel, contributor peran mungkin sudah cukup. Lihat README di repositori sampel untuk nilai yang diperlukan. Anda dapat membaca nilai-nilai ini dalam format apa pun yang didukung oleh bahasa SDK seperti dari file JSON (yang digunakan sampel kami). Bergantung pada sampel yang dijalankan, tidak semua nilai ini dapat digunakan. Lihat repositori sampel untuk kode sampel yang diperbarui atau informasi lebih lanjut.

ID Penyewa

Untuk menemukan direktori atau ID penyewa untuk Azure Stack Hub Anda, ikuti instruksi dalam artikel ini.

Mendaftarkan penyedia sumber daya

Daftarkan penyedia sumber daya yang diperlukan dengan mengikuti dokumen ini. Penyedia sumber daya ini akan diperlukan tergantung pada sampel yang ingin Anda jalankan. Misalnya, jika Anda ingin menjalankan sampel VM, pendaftaran penyedia sumber daya Microsoft.Compute diperlukan.

Titik akhir manajer sumber daya Azure Stack

Azure Resource Manager (ARM) adalah kerangka kerja manajemen yang memungkinkan administrator untuk menyebarkan, mengelola, dan memantau sumber daya Azure. Azure Resource Manager dapat menangani tugas-tugas ini sebagai grup, bukan secara individual, dalam satu operasi. Anda bisa mendapatkan informasi metadata dari endpoint Resource Manager. Titik akhir mengembalikan file JSON dengan info yang diperlukan untuk menjalankan kode Anda.

  • ResourceManagerEndpointUrl di Azure Stack Development Kit (ASDK) adalah: https://management.local.azurestack.external/.
  • ResourceManagerEndpointUrl dalam sistem terintegrasi adalah: https://management.region.<fqdn>/, di mana <fqdn> adalah nama domain Anda yang sepenuhnya memenuhi syarat.
  • Untuk mengambil metadata yang diperlukan: <ResourceManagerUrl>/metadata/endpoints?api-version=1.0. Untuk versi API yang tersedia, lihat Spesifikasi Azure rest API. Misalnya, dalam versi profil 2020-09-01, Anda dapat mengubah api-version menjadi 2019-10-01 untuk penyedia sumber daya microsoft.resources.

Contoh 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"]
      }
}

Percayalah sertifikat utama CA Azure Stack Hub

Jika Anda menggunakan ASDK, Anda harus secara eksplisit mempercayai sertifikat akar CA pada komputer jarak jauh Anda. Anda tidak perlu mempercayai sertifikat akar CA dengan sistem terintegrasi Azure Stack Hub.

Windows

  1. Temukan lokasi penyimpanan sertifikat Python di komputer Anda. Lokasi dapat bervariasi, tergantung di mana Anda menginstal Python. Buka prompt perintah atau prompt PowerShell yang ditingkatkan, dan ketik perintah berikut:

      python -c "import certifi; print(certifi.where())"

    Catat lokasi penyimpanan sertifikat; misalnya, ~/lib/python3.5/site-packages/certifi/cacert.pem. Jalur khusus Anda tergantung pada sistem operasi Anda dan versi Python yang telah Anda instal.

  2. Percayai sertifikat akar CA Azure Stack Hub dengan menambahkannya ke sertifikat Python yang ada:

    $pemFile = "<Fully qualified path to the PEM certificate; for ex: C:\Users\user1\Downloads\root.pem>"

$root = New-Object System.Security.Cryptography.X509Certificates.X509Certificate2
$root.Import($pemFile)

Write-Host "Extracting required information from the cert file"
$md5Hash    = (Get-FileHash -Path $pemFile -Algorithm MD5).Hash.ToLower()
$sha1Hash   = (Get-FileHash -Path $pemFile -Algorithm SHA1).Hash.ToLower()
$sha256Hash = (Get-FileHash -Path $pemFile -Algorithm SHA256).Hash.ToLower()

$issuerEntry  = [string]::Format("# Issuer: {0}", $root.Issuer)
$subjectEntry = [string]::Format("# Subject: {0}", $root.Subject)
$labelEntry   = [string]::Format("# Label: {0}", $root.Subject.Split('=')[-1])
$serialEntry  = [string]::Format("# Serial: {0}", $root.GetSerialNumberString().ToLower())
$md5Entry     = [string]::Format("# MD5 Fingerprint: {0}", $md5Hash)
$sha1Entry    = [string]::Format("# SHA1 Fingerprint: {0}", $sha1Hash)
$sha256Entry  = [string]::Format("# SHA256 Fingerprint: {0}", $sha256Hash)
$certText = (Get-Content -Path $pemFile -Raw).ToString().Replace("`r`n","`n")

$rootCertEntry = "`n" + $issuerEntry + "`n" + $subjectEntry + "`n" + $labelEntry + "`n" + `
$serialEntry + "`n" + $md5Entry + "`n" + $sha1Entry + "`n" + $sha256Entry + "`n" + $certText

Write-Host "Adding the certificate content to Python Cert store"
Add-Content "${env:ProgramFiles(x86)}\Python35\Lib\site-packages\certifi\cacert.pem" $rootCertEntry

Write-Host "Python Cert store was updated to allow the Azure Stack Hub CA root certificate"

Nota

Jika Anda menggunakan virtualenv untuk mengembangkan dengan Python SDK, Anda harus menambahkan sertifikat sebelumnya ke penyimpanan sertifikat lingkungan virtual Anda. Jalur mungkin terlihat mirip dengan: ..\mytestenv\Lib\site-packages\certifi\cacert.pem.

Contoh-contoh

Lihat repositori sampel ini untuk kode sampel terbaru (track 2). Lihat repositori sampel ini untuk kode sampel trek 1. Akar README.md menjelaskan persyaratan umum, dan setiap sub-direktori berisi sampel tertentu dengan sampelnya sendiri README.md yang menjelaskan cara menjalankan sampel tersebut.

Lihat di sini untuk sampel yang berlaku untuk versi 2008 atau profil 2019-03-01 Azure Stack dan di bawah ini.

Langkah selanjutnya

  • Last updated on