Konfigurace řídicí roviny

Řídicí rovina pro architekturu SAP Deployment Automation Framework se skládá z následujících komponent:

  • Deployer
  • Knihovna SAP

Diagram znázorňující řídicí rovinu

Deployer

Deployer je prováděcí modul architektury SAP Deployment Automation Framework. Jedná se o předkonfigurovaný virtuální počítač, který se používá ke spouštění příkazů Terraform a Ansible. Při použití Azure DevOps je nasazér místním agentem.

Konfigurace nasazovacího nástroje se provádí v souboru proměnné Terraformu tfvars .

Pokud chcete pro deployer použít existující skupinu prostředků, zadejte ID prostředku Azure pro skupinu prostředků pomocí resource_group_arm_id parametru v souboru tfvars nasazujícího. Pokud parametr není definovaný, vytvoří se skupina prostředků pomocí výchozího pojmenování. Výchozí název můžete změnit pomocí parametru resource_group_name .

Parametry Terraformu

Tato tabulka zobrazuje parametry Terraformu. Tyto parametry je potřeba zadat ručně, pokud nepoužíváte skripty nasazení.

Proměnná Popis Typ
tfstate_resource_id Identifikátor prostředku Azure pro účet úložiště v knihovně SAP, která obsahuje soubory stavu Terraformu Požaduje se

Parametry prostředí

Tato tabulka zobrazuje parametry, které definují pojmenování prostředků.

Proměnná Popis Typ Notes
environment Identifikátor řídicí roviny (maximálně 5 znaků). Povinné Například PROD pro produkční prostředí a NP pro neprodukční prostředí.
location Oblast Azure, ve které se má nasadit. Požaduje se Používejte malá písmena.
codename Další komponenta pro pojmenování prostředků Volitelné
name_override_file Soubor přepsání názvu Volitelné Viz Vlastní pojmenování.
place_delete_lock_on_resources Umístěte zámek odstranění na klíčové prostředky. Volitelné

Skupina prostředků

Tato tabulka zobrazuje parametry, které definují skupinu prostředků.

Proměnná Popis Typ
resourcegroup_name Název skupiny prostředků, která se má vytvořit Volitelné
resourcegroup_arm_id Identifikátor prostředku Azure pro existující skupinu prostředků Volitelné
resourcegroup_tags Značky, které se mají přidružit ke skupině prostředků Volitelné

Parametry sítě

Architektura automatizace podporuje vytvoření virtuální sítě i podsítě (zelené pole) nebo použití existující virtuální sítě a existujících podsítí (hnědé pole) nebo kombinace zeleného a hnědého pole:

  • Scénář zeleného pole: Musí být zadán adresní prostor virtuální sítě a předpony adres podsítě.
  • Scénář brown-field: Identifikátor prostředku Azure pro virtuální síť a podsítě musí být zadány.

Doporučená CIDR adresního prostoru virtuální sítě je /27, což umožňuje prostor pro 32 IP adres. Hodnota CIDR /28 povoluje pouze 16 IP adres. Pokud chcete zahrnout Azure Firewall, použijte hodnotu CIDR /25, protože Azure Firewall vyžaduje rozsah /26.

Doporučená hodnota CIDR pro podsíť správy je /28, což umožňuje 16 IP adres. Doporučená hodnota CIDR pro podsíť brány firewall je /26, což umožňuje 64 IP adres.

Tato tabulka zobrazuje síťové parametry.

Proměnná Popis Typ Notes
management_network_name Název virtuální sítě, do které se nasadí nasazovač Volitelné Pro nasazení zeleně
management_network_logical_name Logický název sítě (DEV-WEEU-MGMT01-INFRASTRUCTURE) Požaduje se
management_network_arm_id Identifikátor prostředku Azure pro virtuální síť Volitelné Pro nasazení brown-field
management_network_address_space Rozsah adres pro virtuální síť Povinné Pro nasazení zeleně
management_subnet_name Název podsítě Volitelné
management_subnet_address_prefix Rozsah adres podsítě Povinné Pro nasazení zeleně
management_subnet_arm_id Identifikátor prostředku Azure pro podsíť Povinné Pro nasazení brown-field
management_subnet_nsg_name Název skupiny zabezpečení sítě Volitelné
management_subnet_nsg_arm_id Identifikátor prostředku Azure pro skupinu zabezpečení sítě Povinné Pro nasazení brown-field
management_subnet_nsg_allowed_ips Rozsah povolených IP adres pro přidání do služby Azure Firewall Volitelné
management_firewall_subnet_arm_id Identifikátor prostředku Azure pro podsíť služby Azure Firewall Povinné Pro nasazení brown-field
management_firewall_subnet_address_prefix Rozsah adres podsítě Povinné Pro nasazení zeleně
management_bastion_subnet_arm_id Identifikátor prostředku Azure pro podsíť Služby Azure Bastion Povinné Pro nasazení brown-field
management_bastion_subnet_address_prefix Rozsah adres podsítě Povinné Pro nasazení zeleně
webapp_subnet_arm_id Identifikátor prostředku Azure pro podsíť webové aplikace Povinné Pro nasazení brown-field
webapp_subnet_address_prefix Rozsah adres podsítě Povinné Pro nasazení zeleně
use_private_endpoint Použijte privátní koncové body. Volitelné
use_service_endpoint Použijte koncové body služby pro podsítě. Volitelné

Poznámka:

Pokud pro webovou aplikaci použijete existující podsíť, musí být podsíť prázdná, ve stejné oblasti jako nasazená skupina prostředků a delegovaná na Microsoft.Web/serverFarms.

Parametry virtuálního počítače pro nasazení

V této tabulce jsou uvedeny parametry související s virtuálním počítačem nasazovacího nástroje.

Proměnná Popis Typ
deployer_size Definuje skladovou položku virtuálního počítače, která se má použít, výchozí: Standard_D4ds_v4 Volitelné
deployer_count Definuje počet nasazení. Volitelné
deployer_image Definuje image virtuálního počítače, která se má použít, výchozí: Ubuntu 22.04. Volitelné
plan Definuje plán přidružený k imagi virtuálního počítače. Volitelné
deployer_disk_type Definuje typ disku, výchozí nastavení: Premium_LRS Volitelné
deployer_use_DHCP Určuje, jestli se mají použít IP adresy poskytnuté podsítí Azure (dynamické). Volitelné
deployer_private_ip_address Definuje privátní IP adresu, která se má použít. Volitelné
deployer_enable_public_ip Definuje, jestli má deployer veřejnou IP adresu. Volitelné
auto_configure_deployer Definuje, jestli je nasazený nakonfigurovaný s požadovaným softwarem (Terraform a Ansible). Volitelné
add_system_assigned_identity Definuje, jestli je nasazený přiřazená identita systému. Volitelné

Image virtuálního počítače je definována pomocí následující struktury:

xxx_vm_image  = {
  os_type         = ""
  source_image_id = ""
  publisher       = "Canonical"
  offer           = "0001-com-ubuntu-server-jammy"
  sku             = "22_04-lts"
  version         = "latest"
  type            = "marketplace"
}

Poznámka:

Typ může být marketplace/marketplace_with_plan/custom. Použití obrázku typu marketplace_with_plan vyžaduje, aby se daný obrázek v předplatném používal alespoň jednou. Při prvním použití se uživateli zobrazí výzva k přijetí licenčních podmínek a automatizace nemá žádné prostředky ke schválení.

Parametry ověřování

Tato část definuje parametry používané k definování ověřování virtuálního počítače.

Proměnná Popis Typ
deployer_vm_authentication_type Definuje výchozí ověřování pro deployer. Volitelné
deployer_authentication_username název účtu Správa istrator Volitelné
deployer_authentication_password Správa istrator password Volitelné
deployer_authentication_path_to_public_key Cesta k veřejnému klíči použitému k ověřování Volitelné
deployer_authentication_path_to_private_key Cesta k privátnímu klíči použitému k ověřování Volitelné
use_spn Pokud je definované nasazení, provede se pomocí instančního objektu, jinak MSI. Volitelné

Parametry trezoru klíčů

Tato část definuje parametry používané k definování informací o službě Azure Key Vault.

Proměnná Popis Typ
user_keyvault_id Identifikátor prostředku Azure pro trezor klíčů uživatele Volitelné
spn_keyvault_id Identifikátor prostředku Azure pro trezor klíčů, který obsahuje přihlašovací údaje pro nasazení. Volitelné
deployer_private_key_secret_name Název tajného klíče trezoru klíčů pro privátní klíč deployeru. Volitelné
deployer_public_key_secret_name Název tajného klíče trezoru klíčů pro veřejný klíč deployeru. Volitelné
deployer_username_secret_name Název tajného klíče trezoru klíčů pro uživatelské jméno deployeru Volitelné
deployer_password_secret_name Název tajného klíče trezoru klíčů pro heslo nasazovacího nástroje. Volitelné
additional_users_to_add_to_keyvault_policies Seznam ID uživatelských objektů, které se mají přidat do zásad přístupu trezoru klíčů nasazení Volitelné
set_secret_expiry Pro tajné kódy trezoru klíčů nastavte vypršení platnosti 12 měsíců. Volitelné
soft_delete_retention_days Počet dnů, po které se mají položky uchovávat v období obnovitelného odstranění Volitelné
deployer_assign_subscription_permissions Řídí přiřazení oprávnění předplatného. Volitelné

Podpora DNS

Proměnná Popis Typ
dns_label Název DNS zóny Privátní DNS. Volitelné
use_custom_dns_a_registration Používá pro DNS externí systém nastavený na false pro nativní Azure. Volitelné
management_dns_subscription_id ID předplatného pro předplatné, které obsahuje Privátní DNS zónu. Volitelné
management_dns_resourcegroup_name Skupina prostředků, která obsahuje Privátní DNS zónu. Volitelné

Další parametry

Proměnná Popis Typ Notes
firewall_deployment Logický příznak, který určuje, jestli se má nasadit brána Azure Firewall. Volitelné
bastion_deployment Logický příznak, který určuje, jestli se má nasadit hostitel Služby Azure Bastion. Volitelné
bastion_sku Skladová položka pro hostitele Služby Azure Bastion, který se má nasadit (Basic/Standard). Volitelné
enable_purge_control_for_keyvaults Logický příznak, který řídí, jestli je v trezoru klíčů povolený ovládací prvek mazání. Volitelné Používejte pouze pro testovací nasazení.
enable_firewall_for_keyvaults_and_storage Omezte přístup k vybraným podsítím. Volitelné
Agent_IP IP adresa agenta. Volitelné
add_Agent_IP Určuje, jestli je IP adresa agenta přidaná do trezoru klíčů a bran firewall účtu úložiště. Volitelné

Parametry webové aplikace

Proměnná Popis Typ Notes
use_webapp Logická hodnota označující, jestli má být webová aplikace nasazená. Volitelné
app_service_SKU_name Skladová položka plánu služby App Service. Volitelné
app_registration_app_id ID registrace aplikace, které se má použít pro webovou aplikaci. Volitelné
webapp_client_secret Skladová položka plánu služby App Service. Volitelné Bude trvalé ve službě Key Vault.

Ukázkový soubor parametrů pro deployer (jenom požadované parametry)

# The environment value is a mandatory field, it is used for partitioning the environments, for example (PROD and NP)
environment="MGMT"

# The location/region value is a mandatory field, it is used to control where the resources are deployed
location="westeurope"

# management_network_address_space is the address space for management virtual network
management_network_address_space="10.10.20.0/25"

# management_subnet_address_prefix is the address prefix for the management subnet
management_subnet_address_prefix="10.10.20.64/28"

# management_firewall_subnet_address_prefix is the address prefix for the firewall subnet
management_firewall_subnet_address_prefix="10.10.20.0/26"

# management_bastion_subnet_address_prefix is a mandatory parameter if bastion is deployed and if the subnets are not defined in the workload or if existing subnets are not used
management_bastion_subnet_address_prefix = "10.10.20.128/26"

deployer_enable_public_ip=false

firewall_deployment=true

bastion_deployment=true

Knihovna SAP

Knihovna SAP poskytuje trvalé úložiště stavových souborů Terraformu a stažené instalační médium SAP pro řídicí rovinu.

Konfigurace knihovny SAP se provádí v souboru proměnné Terraformu tfvars .

Pokud chcete pro knihovnu SAP použít existující skupinu prostředků, zadejte ID prostředku Azure pro skupinu prostředků pomocí resource_group_arm_id parametru v souboru tfvars nasazujícího. Pokud parametr není definovaný, vytvoří se skupina prostředků pomocí výchozího pojmenování. Výchozí název můžete změnit pomocí parametru resource_group_name .

Parametry Terraformu

Tato tabulka zobrazuje parametry Terraformu. Tyto parametry je potřeba zadat ručně, pokud nepoužíváte skripty nasazení nebo Azure Pipelines.

Proměnná Popis Typ Notes
deployer_tfstate_key Název souboru stavu pro deployer Požaduje se

Parametry prostředí

Tato tabulka zobrazuje parametry, které definují pojmenování prostředků.

Proměnná Popis Typ Notes
environment Identifikátor řídicí roviny (maximálně pět znaků) Povinné Například PROD pro produkční prostředí a NP pro neprodukční prostředí.
location Oblast Azure, ve které se má nasadit Požaduje se Používejte malá písmena.
name_override_file Soubor přepsání názvu Volitelné Viz Vlastní pojmenování.

Skupina prostředků

Tato tabulka zobrazuje parametry, které definují skupinu prostředků.

Proměnná Popis Typ
resourcegroup_name Název skupiny prostředků, která se má vytvořit Volitelné
resourcegroup_arm_id Identifikátor prostředku Azure pro existující skupinu prostředků Volitelné
resourcegroup_tags Značky, které se mají přidružit ke skupině prostředků Volitelné

Účet úložiště médií instalace SAP

Proměnná Popis Typ
library_sapmedia_arm_id Identifikátor prostředku Azure Volitelné

Účet vzdáleného úložiště stavu Terraformu

Proměnná Popis Typ
library_terraform_state_arm_id Identifikátor prostředku Azure Volitelné

Podpora DNS

Proměnná Popis Typ
dns_label Název DNS zóny Privátní DNS. Volitelné
use_custom_dns_a_registration Použijte existující zónu Privátní DNS. Volitelné
management_dns_subscription_id ID předplatného pro předplatné, které obsahuje Privátní DNS zónu. Volitelné
management_dns_resourcegroup_name Skupina prostředků, která obsahuje Privátní DNS zónu. Volitelné

Další parametry

Proměnná Popis Typ
use_private_endpoint Použijte privátní koncové body. Volitelné
use_service_endpoint Použijte koncové body služby pro podsítě. Volitelné
enable_firewall_for_keyvaults_and_storage Omezte přístup k vybraným podsítím. Volitelné
subnets_to_add_to_firewall_for_keyvaults_and_storage Podsítě, které potřebují přístup k trezorům klíčů a účtům úložiště. Volitelné

Ukázkový soubor parametrů pro knihovnu SAP (pouze požadované parametry)

# The environment value is a mandatory field, it is used for partitioning the environments, for example (PROD and NP)
environment = "MGMT"

# The location/region value is a mandatory field, it is used to control where the resources are deployed
location = "westeurope"

Další krok