Začínáme: instalace terraformu na Windows s Bash

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

2. Pokud vytváříte instanční objekt z bash Git, 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í můžete nastavit MSYS_NO_PATHCONV globálně (pro všechny relace Terminálové služby) nebo místně (jenom pro aktuální relaci). Vzhledem k tomu, že vytváření instančního objektu není něco často, je v ukázce nastavena hodnota pro aktuální relaci. Chcete-li nastavit tuto proměnnou prostředí globálně, přidejte do ~/.bashrc souboru nastavení.

3. Pokud chcete vytvořit instanční objekt, 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 <service-principal-name> vlastním názvem pro vaše prostředí nebo parametr úplně vynechat. Pokud parametr vynecháte, hlavní název služby se vygeneruje 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. appIdHodnoty, password a tenant se používají v dalším kroku.
   • Pokud dojde ke ztrátě, heslo nelze načíst. V takovém případě byste měli heslo uložit na bezpečném místě. Pokud zapomenete heslo, můžete resetovat přihlašovací údaje instančního objektu.
   • V tomto článku se používá instanční objekt s rolí přispěvatele . Další informace o Role-Based Access Control (RBAC) a rolích najdete v článku role RBAC: předdefinované role.
   • Výstup z vytváření instančního objektu zahrnuje citlivé přihlašovací údaje. Ujistěte se, že tyto přihlašovací údaje nezahrnete do kódu, nebo zkontrolujte pověření do správy zdrojového kódu.
   • Další informace o možnostech Vytvoření instančního objektu pomocí Azure CLI najdete v článku Vytvoření instančního objektu 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 zobrazí informace o výchozím předplatném.
   • Poznamenejte si, TenantId jak je potřeba k používání instančního objektu.

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

   Get-AzContext
   

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

   Get-AzSubscription
   

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

   Set-AzContext -Subscription "<subscription_id_or_subscription_name>"
   

   Klíčové body:

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

6. Spusťte rutinu New-AzADServicePrincipal a vytvořte nový instanční objekt.

   $sp = New-AzADServicePrincipal -DisplayName <service_principal_name>    
   

   Klíčové body:

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

7. Zobrazit ID objektu služby.

   $sp.ApplicationId
   

   Klíčové body:

   • Poznamenejte si ID aplikace instančního objektu, aby bylo nutné použít instanční objekt.

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, aby bylo nutné použít instanční objekt.
   • Pokud dojde ke ztrátě, heslo nelze načíst. V takovém případě byste měli heslo uložit na bezpečném místě. Pokud zapomenete heslo, můžete resetovat přihlašovací údaje instančního objektu.

1. Upravte ~/.bashrc soubor 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. Chcete-li spustit ~/.bashrc skript, spusťte source ~/.bashrc (nebo jeho zkrácený ekvivalent . ~/.bashrc ). Můžete také ukončit a znovu otevřít 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 libovolné proměnné prostředí můžete pro přístup k hodnotě předplatného Azure z Terraformu skriptu použít následující syntaxi: ${env.<environment_variable>} . Chcete-li například 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 provede změny v předplatném Azure přidruženém k instančnímu objektu. Tato skutečnost může být někdy matoucí, pokud jste se přihlásili k jednomu předplatnému Azure a proměnné prostředí odkazují na druhé předplatné Azure. Pojďme se podívat na následující příklad, který vám vysvětlí. Řekněme, že máte dvě předplatná Azure: SubA a SubB. Pokud je aktuální předplatné Azure SubA (určeno prostřednictvím az account show ), zatímco proměnné prostředí odkazují na SubB, všechny změny provedené v terraformu jsou v SubB. proto byste se museli přihlašovat ke svému předplatnému SubB, abyste mohli spustit příkazy rozhraní příkazového řádku Azure nebo příkazy Azure PowerShell pro zobrazení změn.

1. Chcete-li nastavit proměnné prostředí v určité relaci prostředí PowerShell, použijte následující kód. Zástupné symboly nahraďte odpovídající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í v rámci vašeho profilu.

Klíčové body:

• Stejně jako u libovolné proměnné prostředí můžete pro přístup k hodnotě předplatného Azure z Terraformu skriptu použít následující syntaxi: ${env.<environment_variable>} . Chcete-li například 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 provede změny v předplatném Azure přidruženém k instančnímu objektu. Tato skutečnost může být někdy matoucí, pokud jste se přihlásili k jednomu předplatnému Azure a proměnné prostředí odkazují na druhé předplatné Azure. Pojďme se podívat na následující příklad, který vám vysvětlí. Řekněme, že máte dvě předplatná Azure: SubA a SubB. Pokud je aktuální předplatné Azure SubA (určeno prostřednictvím az account show ), zatímco proměnné prostředí odkazují na SubB, všechny změny provedené v terraformu jsou v SubB. proto byste se museli přihlašovat ke svému předplatnému SubB, abyste mohli spustit příkazy rozhraní příkazového řádku Azure nebo příkazy Azure PowerShell pro zobrazení změn.