Začínáme: Instalace Terraformu na Windows s Azure PowerShell

1. Pokud chcete vytvořit instanční objekt, přihlaste se k Azure. Po ověření v Azure prostřednictvím účet Microsoftse vraťte sem.

2. Pokud vytváříte objekt služby z Git Bashe, nastavte MSYS_NO_PATHCONV proměnnou prostředí. (Tento krok není nutný, pokud používáte Cloud Shell.)

   export MSYS_NO_PATHCONV=1    
   

   Klíčové body:

   • Proměnnou prostředí MSYS_NO_PATHCONV můžete nastavit globálně (pro všechny terminálové relace) nebo místně (pouze pro aktuální relaci). Vzhledem k tomu, že vytvoření objektu služby není něco, co často dělají, nastaví ukázka hodnotu pro aktuální relaci. Pokud chcete tuto proměnnou prostředí nastavit globálně, přidejte do ~/.bashrc souboru nastavení .

3. Pokud chcete vytvořit objekt služby, spusťte příkaz az ad sp create-for-rbac.

   az ad sp create-for-rbac --name <service_principal_name> --role Contributor
   

   Klíčové body:

   • Můžete nahradit vlastním názvem pro vaše prostředí <service-principal-name> nebo parametr úplně vynechat. Pokud parametr vyhodíte, vygeneruje se hlavní název služby na základě aktuálního data a času.
   • Po úspěšném dokončení az ad sp create-for-rbac zobrazí několik hodnot. Hodnoty appIdpassword , tenant a se používají v dalším kroku.
   • Heslo není možné načíst, pokud dojde ke ztrátě. Proto byste měli heslo uložit na bezpečném místě. Pokud heslo zapomenete, můžete resetovat přihlašovací údaje objektu služby.
   • Pro tento článek se používá objekt služby s rolí Přispěvatel. Další informace o rolích Role-Based Access Control (RBAC) a rolích najdete v tématu RBAC: Předdefinované role.
   • Výstup vytvoření objektu služby zahrnuje citlivé přihlašovací údaje. Ujistěte se, že tyto přihlašovací údaje do kódu nezadáte, nebo přihlašovací údaje zaškrtejte do správy zdrojového kódu.
   • Další informace o možnostech při vytváření objektu služby pomocí Azure CLI najdete v článku Vytvoření objektu služby Azure pomocí Azure CLI.

1. Otevřete příkazový řádek PowerShellu.

2. Spusťte Připojení-AzAccount.

   Connect-AzAccount
   

   Klíčové body:

   • Po úspěšném přihlášení Connect-AzAccount se zobrazí informace o výchozím předplatném.
   • Poznamenejte si TenantId , protože je potřeba použít tento objekt služby.

3. Aktuální předplatné Azure potvrdíte spuštěním příkazu Get-AzContext.

   Get-AzContext
   

4. Pokud chcete zobrazit všechna povolená předplatná Azure pro přihlášené účet Microsoft, spusťte příkaz Get-AzSubscription.

   Get-AzSubscription
   

5. Pokud chcete použít konkrétní předplatné Azure, spusťte Set-AzContext.

   Set-AzContext -Subscription "<subscription_id_or_subscription_name>"
   

   Klíčové body:

   • Zástupný <subscription_id_or_subscription_name> text nahraďte ID nebo názvem předplatného, které chcete použít.

6. Spuštěním příkazu New-AzADServicePrincipal vytvořte nový objekt služby.

   $sp = New-AzADServicePrincipal -DisplayName <service_principal_name>    
   

   Klíčové body:

   • Můžete nahradit vlastním názvem pro vaše prostředí <service-principal-name> nebo parametr úplně vynechat. Pokud parametr vyhodíte, vygeneruje se hlavní název služby na základě aktuálního data a času.
   • Role Přispěvatel je výchozí rolí a má úplná oprávnění ke čtení a zápisu do účtu Azure. Pro tento článek se používá objekt služby s rolí Přispěvatel. Další informace o řízení Role-Based Access Control (RBAC) a rolích najdete v tématu RBAC: Předdefinované role.

7. Zobrazte ID objektu služby.

   $sp.ApplicationId
   

   Klíčové body:

   • Poznamenejte si ID aplikace objektu služby, protože je potřeba k použití tohoto objektu služby.

8. Převeďte automaticky vygenerované heslo na text.

   $BSTR = [System.Runtime.InteropServices.Marshal]::SecureStringToBSTR($sp.Secret)
   $UnsecureSecret = [System.Runtime.InteropServices.Marshal]::PtrToStringAuto($BSTR)
   $UnsecureSecret
   

   Klíčové body:

   • Poznamenejte si heslo, protože je potřeba k použití objektu služby.
   • Heslo není možné načíst, pokud dojde ke ztrátě. Proto byste měli heslo uložit na bezpečném místě. Pokud heslo zapomenete, můžete resetovat přihlašovací údaje objektu služby.

1. Upravte soubor ~/.bashrc přidáním následujících proměnných prostředí.

   export ARM_SUBSCRIPTION_ID="<azure_subscription_id>"
   export ARM_TENANT_ID="<azure_subscription_tenant_id>"
   export ARM_CLIENT_ID="<service_principal_appid>"
   export ARM_CLIENT_SECRET="<service_principal_password>"
   

2. Pokud chcete skript ~/.bashrc spustit, spusťte source ~/.bashrc příkaz (nebo jeho zkrácený . ~/.bashrc ekvivalent). Můžete také ukončit a znovu Cloud Shell, aby se skript spouštěl automaticky.

   . ~/.bashrc
   

3. Po nastavení proměnných prostředí můžete ověřit jejich hodnoty následujícím způsobem:

   printenv | grep ^ARM*
   

Klíčové body:

• Stejně jako u jakékoli proměnné prostředí použijte pro přístup k hodnotě předplatného Azure ze skriptu Terraformu následující syntaxi: ${env.<environment_variable>} . Pokud například chcete získat přístup k ARM_SUBSCRIPTION_ID hodnotě, zadejte ${env.ARM_SUBSCRIPTION_ID} .
• Vytvoření a použití plánů provádění Terraformu provádí změny v předplatném Azure přidruženém k tomuto objektu služby. Tato skutečnost může být někdy matoucí, pokud jste přihlášení k jednomu předplatnému Azure a proměnné prostředí odkazovat na druhé předplatné Azure. Podívejme se na následující příklad, který vám vysvětlíme. Řekněme, že máte dvě předplatná Azure: SubA a SubB. Pokud aktuální předplatné Azure je SubA (určené prostřednictvím ), zatímco proměnné prostředí odkazovat na SubB, všechny změny provedené az account show Terraformem jsou v SubB. Proto se musíte přihlásit ke svému předplatnému SubB a spustit příkazy Azure CLI nebo Azure PowerShell zobrazit změny.

1. Pokud chcete nastavit proměnné prostředí v rámci konkrétní relace PowerShellu, použijte následující kód. Zástupné symboly nahraďte příslušnými hodnotami pro vaše prostředí.

   $env:ARM_CLIENT_ID="<service_principal_app_id>"
   $env:ARM_SUBSCRIPTION_ID="<azure_subscription_id>"
   $env:ARM_TENANT_ID="<azure_subscription_tenant_id>"
   $env:ARM_CLIENT_SECRET="<service_principal_password>"
   

2. Spuštěním následujícího příkazu PowerShellu ověřte proměnné prostředí Azure:

   gci env:ARM_*
   

3. Pokud chcete nastavit proměnné prostředí pro každou relaci PowerShellu, vytvořte profil PowerShellu a nastavte proměnné prostředí ve vašem profilu.

Klíčové body:

• Stejně jako u jakékoli proměnné prostředí použijte pro přístup k hodnotě předplatného Azure ze skriptu Terraformu následující syntaxi: ${env.<environment_variable>} . Pokud například chcete získat přístup k ARM_SUBSCRIPTION_ID hodnotě, zadejte ${env.ARM_SUBSCRIPTION_ID} .
• Vytvoření a použití plánů provádění Terraformu provádí změny v předplatném Azure přidruženém k tomuto objektu služby. Tato skutečnost může být někdy matoucí, pokud jste přihlášení k jednomu předplatnému Azure a proměnné prostředí odkazovat na druhé předplatné Azure. Podívejme se na následující příklad, který vám vysvětlíme. Řekněme, že máte dvě předplatná Azure: SubA a SubB. Pokud aktuální předplatné Azure je SubA (určené prostřednictvím ), zatímco proměnné prostředí odkazovat na SubB, všechny změny provedené az account show Terraformem jsou v SubB. Proto se musíte přihlásit ke svému předplatnému SubB a spustit příkazy Azure CLI nebo Azure PowerShell zobrazit změny.