Rövid útmutató: Az első Azure-erőforrás üzembe helyezése az AzAPI Terraform-szolgáltatóval
A cikk a következő Terraform- és Terraform-szolgáltatói verziókkal lett tesztelve:
A Terraform lehetővé teszi a felhőinfrastruktúra definícióját, előzetes verzióját és üzembe helyezését. A Terraform használatával konfigurációs fájlokat hozhat létre HCL-szintaxissal. A HCL szintaxissal megadhatja a felhőszolgáltatót – például az Azure-t – és a felhőinfrastruktúra elemeit. A konfigurációs fájlok létrehozása után létrehoz egy végrehajtási tervet , amely lehetővé teszi az infrastruktúra változásainak előzetes megtekintését az üzembe helyezés előtt. A módosítások ellenőrzése után alkalmazza a végrehajtási tervet az infrastruktúra üzembe helyezésére.
Ebben a cikkben megtudhatja, hogyan kezelheti az AzureRM-szolgáltató által jelenleg nem támogatott Azure-szolgáltatásokat az AzAPI Terraform-szolgáltatóval. A azapi_resource
rendszer egy Azure Lab Services-fiók és egy tesztkörnyezet kezelésére szolgál.
- Definiálja és konfigurálja az AzureRM- és az AzAPI-szolgáltatókat.
- Azure-erőforráscsoport létrehozása az AzureRM-szolgáltatóval
- Az AzureRM-szolgáltató használatával regisztrálja a "Microsoft.LabServices" szolgáltatót az előfizetésében
- Az Azure Lab Services-erőforrások létrehozása az AzAPI-szolgáltatóval
Feljegyzés
A cikkben szereplő példakód az Azure Terraform GitHub-adattárban található.
Előfeltételek
- Azure-előfizetés: Ha nem rendelkezik Azure-előfizetéssel, első lépésként mindössze néhány perc alatt létrehozhat egy ingyenes fiókot.
A Terraform konfigurálása: Ha még nem tette meg, konfigurálja a Terraformot az alábbi lehetőségek egyikével:
A Terraform-kód implementálása
Hozzon létre egy könyvtárat, amelyben tesztelheti a Terraform-mintakódot, és az aktuális könyvtárá teheti.
Hozzon létre egy elnevezett
providers.tf
fájlt, és szúrja be a következő kódot:terraform { required_providers { azapi = { source = "azure/azapi" version = "=0.1.0" } azurerm = { source = "hashicorp/azurerm" version = "=3.0.2" } } } provider "azapi" { default_location = "eastus" default_tags = { team = "Azure deployments" } } provider "azurerm" { features {} }
Hozzon létre egy elnevezett
main.tf
fájlt, és szúrja be a következő kódot:resource "azurerm_resource_group" "qs101" { name = "rg-qs101" location = "westus2" }
Hozzon létre egy elnevezett
main-generic.tf
fájlt, és szúrja be a következő kódot:# Provision a Lab Service Account and a Lab that are in public preview resource "azapi_resource" "qs101-account" { type = "Microsoft.LabServices/labaccounts@2018-10-15" name = "qs101LabAccount" parent_id = azurerm_resource_group.qs101.id body = jsonencode({ properties = { enabledRegionSelection = false } }) } resource "azapi_resource" "qs101-lab" { type = "Microsoft.LabServices/labaccounts/labs@2018-10-15" name = "qs101Lab" parent_id = azapi_resource.qs101-account.id body = jsonencode({ properties = { maxUsersInLab = 10 userAccessMode = "Restricted" } }) }
A Terraform inicializálása
Futtassa a Terraform init parancsot a Terraform üzembe helyezésének inicializálásához. Ez a parancs letölti az Azure-erőforrások kezeléséhez szükséges Azure-szolgáltatót.
terraform init -upgrade
Főbb pontok:
- A
-upgrade
paraméter frissíti a szükséges szolgáltatói beépülő modulokat a legújabb verzióra, amely megfelel a konfiguráció verziókorlátozásainak.
Terraform végrehajtási terv létrehozása
Végrehajtási terv létrehozásához futtassa a Terraform-tervet .
terraform plan -out main.tfplan
Főbb pontok:
- A
terraform plan
parancs létrehoz egy végrehajtási tervet, de nem hajtja végre. Ehelyett meghatározza, hogy milyen műveletek szükségesek a konfigurációs fájlokban megadott konfiguráció létrehozásához. Ez a minta lehetővé teszi annak ellenőrzését, hogy a végrehajtási terv megfelel-e az elvárásainak, mielőtt módosítanák a tényleges erőforrásokat. - Az opcionális
-out
paraméter lehetővé teszi a terv kimeneti fájljának megadását.-out
A paraméter használatával biztosítható, hogy a vizsgált terv pontosan az alkalmazott legyen.
Terraform végrehajtási terv alkalmazása
A terraform futtatásával alkalmazza a végrehajtási tervet a felhőinfrastruktúrára.
terraform apply main.tfplan
Főbb pontok:
- A példaparancs
terraform apply
feltételezi, hogy korábban futtatottterraform plan -out main.tfplan
. - Ha másik fájlnevet adott meg a
-out
paraméterhez, használja ugyanazt a fájlnevet a hívásbanterraform apply
. - Ha nem használta a paramétert
-out
, hívjonterraform apply
paraméterek nélkül.
Az eredmények ellenőrzése
- Az Azure-előfizetésben keresse meg az
rg-qs101
erőforráscsoportot. - Az erőforráscsoport tagjaként megjelenik egy új Lab Services-fiók neve
qs101LabAccount
.
Az erőforrások eltávolítása
Ha már nincs szüksége a Terraformon keresztül létrehozott erőforrásokra, hajtsa végre az alábbi lépéseket:
Futtassa a Terraform-tervet , és adja meg a jelölőt
destroy
.terraform plan -destroy -out main.destroy.tfplan
Főbb pontok:
- A
terraform plan
parancs létrehoz egy végrehajtási tervet, de nem hajtja végre. Ehelyett meghatározza, hogy milyen műveletek szükségesek a konfigurációs fájlokban megadott konfiguráció létrehozásához. Ez a minta lehetővé teszi annak ellenőrzését, hogy a végrehajtási terv megfelel-e az elvárásainak, mielőtt módosítanák a tényleges erőforrásokat. - Az opcionális
-out
paraméter lehetővé teszi a terv kimeneti fájljának megadását.-out
A paraméter használatával biztosítható, hogy a vizsgált terv pontosan az alkalmazott legyen.
- A
A végrehajtási terv alkalmazásához futtassa a terraformát .
terraform apply main.destroy.tfplan
A Terraform hibaelhárítása az Azure-ban
A Terraform Azure-beli használatakor felmerülő gyakori problémák elhárítása