Rychlý start: Vytvoření instance flexibilního serveru Azure Database for MySQL pomocí Terraformu

PLATÍ PRO: Flexibilní server Azure Database for MySQL

Tento rychlý start byl testován pomocí následujících verzí zprostředkovatele Terraformu a Terraformu:

• Terraform v1.2.7
• Poskytovatel AzureRM v.3.20.0

Flexibilní server Azure Database for MySQL je spravovaná služba, kterou používáte ke spouštění, správě a škálování vysoce dostupných databází MySQL v cloudu. Šablonu Azure Resource Manageru (šablona ARM) můžete použít ke zřízení flexibilního serveru Azure Database for MySQL pro nasazení více serverů nebo nasazení více databází na server.

V tomto článku se dozvíte, jak pomocí Terraformu nasadit instanci flexibilního serveru Azure Database for MySQL a databáze ve virtuální síti.

V tomto článku získáte informace o těchto tématech:

• Vytvořte skupinu prostředků Azure pomocí azurerm_resource_group.
• Vytvořte virtuální síť Azure pomocí azurerm_virtual_network.
• Vytvořte podsíť Azure pomocí azurerm_subnet.
• Definujte privátní zónu DNS v instanci Azure DNS pomocí azurerm_private_dns_zone.
• Definujte propojení virtuální sítě privátní zóny DNS pomocí azurerm_private_dns_zone_virtual_network_link.
• Nasazení flexibilního serveru Azure Database for MySQL pomocí azurerm_mysql_flexible_server
• Nasaďte databázi pomocí azurerm_mysql_flexible_database.

Poznámka:

Ukázkový kód, který se zobrazí v tomto článku, se nachází v úložišti GitHubu Azure Terraformu.

Požadavky

• Pokud ještě nemáte předplatné Azure, vytvořte si bezplatný účet Azure, než začnete. V současné době můžete s bezplatným účtem Azure vyzkoušet flexibilní server Azure Database for MySQL zdarma po dobu 12 měsíců. Další informace najdete v tématu Bezplatné vyzkoušení flexibilního serveru Azure Database for MySQL.

• Instalace a konfigurace Terraformu

Implementace kódu Terraformu

1. Vytvořte adresář, který můžete použít k otestování ukázkového kódu Terraformu. Nastavte adresář Terraformu jako aktuální adresář.

2. Vytvořte soubor s názvem providers.tf a vložte následující kód:

   terraform {
     required_version = ">=1.0"
   
     required_providers {
       azurerm = {
         source  = "hashicorp/azurerm"
         version = "~>3.0"
       }
   
       random = {
         source  = "hashicorp/random"
         version = "~>3.0"
       }
     }
   }
   
   provider "azurerm" {
     features {}
   }
   

3. Vytvořte soubor s názvem main.tf a vložte následující kód:

   # Generate random resource group name
   resource "random_pet" "rg_name" {
     prefix = var.resource_group_name_prefix
   }
   
   resource "azurerm_resource_group" "rg" {
     location = var.resource_group_location
     name     = random_pet.rg_name.id
   }
   
   # Generate random value for the name
   resource "random_string" "name" {
     length  = 8
     lower   = true
     numeric = false
     special = false
     upper   = false
   }
   
   # Generate random value for the login password
   resource "random_password" "password" {
     length           = 8
     lower            = true
     min_lower        = 1
     min_numeric      = 1
     min_special      = 1
     min_upper        = 1
     numeric          = true
     override_special = "_"
     special          = true
     upper            = true
   }
   
   # Manages the Virtual Network
   resource "azurerm_virtual_network" "default" {
     address_space       = ["10.0.0.0/16"]
     location            = azurerm_resource_group.rg.location
     name                = "vnet-${random_string.name.result}"
     resource_group_name = azurerm_resource_group.rg.name
   }
   
   # Manages the Subnet
   resource "azurerm_subnet" "default" {
     address_prefixes     = ["10.0.2.0/24"]
     name                 = "subnet-${random_string.name.result}"
     resource_group_name  = azurerm_resource_group.rg.name
     virtual_network_name = azurerm_virtual_network.default.name
     service_endpoints    = ["Microsoft.Storage"]
   
     delegation {
       name = "fs"
   
       service_delegation {
         name = "Microsoft.DBforMySQL/flexibleServers"
         actions = [
           "Microsoft.Network/virtualNetworks/subnets/join/action",
         ]
       }
     }
   }
   
   # Enables you to manage Private DNS zones within Azure DNS
   resource "azurerm_private_dns_zone" "default" {
     name                = "${random_string.name.result}.mysql.database.azure.com"
     resource_group_name = azurerm_resource_group.rg.name
   }
   
   # Enables you to manage Private DNS zone Virtual Network Links
   resource "azurerm_private_dns_zone_virtual_network_link" "default" {
     name                  = "mysqlfsVnetZone${random_string.name.result}.com"
     private_dns_zone_name = azurerm_private_dns_zone.default.name
     resource_group_name   = azurerm_resource_group.rg.name
     virtual_network_id    = azurerm_virtual_network.default.id
   
     depends_on = [azurerm_subnet.default]
   }
   
   # Manages the MySQL Flexible Server
   resource "azurerm_mysql_flexible_server" "default" {
     location                     = azurerm_resource_group.rg.location
     name                         = "mysqlfs-${random_string.name.result}"
     resource_group_name          = azurerm_resource_group.rg.name
     administrator_login          = random_string.name.result
     administrator_password       = random_password.password.result
     backup_retention_days        = 7
     delegated_subnet_id          = azurerm_subnet.default.id
     geo_redundant_backup_enabled = false
     private_dns_zone_id          = azurerm_private_dns_zone.default.id
     sku_name                     = "GP_Standard_D2ds_v4"
     version                      = "8.0.21"
   
     high_availability {
       mode                      = "SameZone"
     }
     maintenance_window {
       day_of_week  = 0
       start_hour   = 8
       start_minute = 0
     }
     storage {
       iops    = 360
       size_gb = 20
     }
   
     depends_on = [azurerm_private_dns_zone_virtual_network_link.default]
   }
   

4. Vytvořte soubor s názvem mysql-fs-db.tf a vložte následující kód:

   # Manages the MySQL Flexible Server Database
   resource "azurerm_mysql_flexible_database" "main" {
     charset             = "utf8mb4"
     collation           = "utf8mb4_unicode_ci"
     name                = "mysqlfsdb_${random_string.name.result}"
     resource_group_name = azurerm_resource_group.rg.name
     server_name         = azurerm_mysql_flexible_server.default.name
   }
   

5. Vytvořte soubor s názvem variables.tf a vložte následující kód:

   variable "resource_group_location" {
     type        = string
     default     = "westeurope"
     description = "Location of the resource group."
   }
   
   variable "resource_group_name_prefix" {
     type        = string
     default     = "mysql-fs-db-rg"
     description = "Prefix of the resource group name that's combined with a random ID so name is unique in your Azure subscription."
   }
   

6. Vytvořte soubor s názvem outputs.tf a vložte následující kód:

   output "azurerm_mysql_flexible_server" {
     value = azurerm_mysql_flexible_server.default.name
   }
   
   output "admin_login" {
     value = azurerm_mysql_flexible_server.default.administrator_login
   }
   
   output "admin_password" {
     sensitive = true
     value     = azurerm_mysql_flexible_server.default.administrator_password
   }
   
   output "mysql_flexible_server_database_name" {
     value = azurerm_mysql_flexible_database.main.name
   }
   
   output "resource_group_name" {
     value = azurerm_resource_group.rg.name
   }
   

Inicializace Terraformu

Spuštěním inicializace nasazení Terraformu spusťte inicializaci terraformu. Tento příkaz stáhne poskytovatele Azure potřebného ke správě prostředků Azure.

terraform init -upgrade

Klíčové body:

• Parametr -upgrade upgraduje potřebné moduly plug-in zprostředkovatele na nejnovější verzi, která splňuje omezení verzí konfigurace.

Vytvoření plánu provádění Terraformu

Spuštěním plánu terraformu vytvořte plán provádění.

terraform plan -out main.tfplan

Klíčové body:

• Příkaz terraform plan vytvoří plán provádění, ale nespustí ho. Místo toho určuje, jaké akce jsou nezbytné k vytvoření konfigurace zadané v konfiguračních souborech. Tento model umožňuje ověřit, jestli plán provádění odpovídá vašim očekáváním, než provede jakékoli změny skutečných prostředků.
• Volitelný -out parametr umožňuje zadat výstupní soubor pro plán. Použití parametru -out zajišťuje, že plán, který jste zkontrolovali, je přesně to, co se použije.

Použití plánu provádění Terraformu

Spuštění terraformu platí pro použití plánu provádění na cloudovou infrastrukturu.

terraform apply main.tfplan

Klíčové body:

• terraform apply Ukázkový příkaz předpokládá, že jste dříve spustili terraform plan -out main.tfplan.
• Pokud jste pro -out parametr zadali jiný název souboru, použijte stejný název souboru při volání terraform apply.
• Pokud jste parametr nepoužíli -out , zavolejte terraform apply bez parametrů.

Ověření výsledků

Azure CLI

Pokud chcete zobrazit databázi flexibilního serveru Azure Database for MySQL, spusťte příkaz az mysql flexible-server db show:

az mysql flexible-server db show \
    --resource-group <resource_group_name> \
    --server-name <azurerm_mysql_flexible_server> \
    --database-name <mysql_flexible_server_database_name>

Vezměte v úvahu následující klíčové body:

• Hodnoty pro <resource_group_name>, <azurerm_mysql_flexible_server>a <mysql_flexible_server_database_name> jsou zobrazeny ve výstupu terraform apply . Tyto hodnoty můžete zobrazit také spuštěním výstupního příkazu terraformu.

Azure PowerShell

Pokud chcete zobrazit flexibilní serverovou databázi Azure Database for MySQL, spusťte rutinu Get-AzMySqlFlexibleServerDatabase:

Get-AzMySqlFlexibleServerDatabase `
    -ResourceGroupName <resource_group_name> `
    -ServerName <azurerm_mysql_flexible_server> `
    -Name <mysql_flexible_server_database_name>

Vezměte v úvahu následující klíčové body:

• Hodnoty pro <resource_group_name>, <azurerm_mysql_flexible_server>a <mysql_flexible_server_database_name> jsou zobrazeny ve výstupu terraform apply . Tyto výstupní hodnoty můžete zobrazit také spuštěním výstupního příkazu terraformu.

Vyčištění prostředků

Pokud už prostředky vytvořené přes Terraform nepotřebujete, proveďte následující kroky:

1. Spusťte plán terraformu destroy a zadejte příznak.

   terraform plan -destroy -out main.destroy.tfplan
   

   Klíčové body:

   • Příkaz terraform plan vytvoří plán provádění, ale nespustí ho. Místo toho určuje, jaké akce jsou nezbytné k vytvoření konfigurace zadané v konfiguračních souborech. Tento model umožňuje ověřit, jestli plán provádění odpovídá vašim očekáváním, než provede jakékoli změny skutečných prostředků.
   • Volitelný -out parametr umožňuje zadat výstupní soubor pro plán. Použití parametru -out zajišťuje, že plán, který jste zkontrolovali, je přesně to, co se použije.

2. Spuštění terraformu platí pro použití plánu provádění.

   terraform apply main.destroy.tfplan
   

Řešení potíží s Terraformem v Azure

Prozkoumejte, jak řešit běžné problémy s používáním Terraformu v Azure.

Další krok

Připojení k instanci flexibilního serveru Azure Database for MySQL pomocí privátního přístupu