Merge 8bf6142 into 2a85c3c

Author: brown9804

README.md

@@ -5,7 +5,7 @@ Costa Rica
 [![GitHub](https://img.shields.io/badge/--181717?logo=github&logoColor=ffffff)](https://github.com/)
 [brown9804](https://github.com/brown9804)
 
-Last updated: 2025-02-21
+Last updated: 2025-04-15
 
 ------------------------------------------
 
@@ -27,8 +27,24 @@ Last updated: 2025-02-21
 
 </details>
 
+## Prerequisites
+
+- An `Azure subscription is required`. All other resources, including instructions for creating a Resource Group, are provided in this workshop.
+- `Contributor role assigned or any custom role that allows`: access to manage all resources, and the ability to deploy resources within subscription.
+- If you choose to use a Terraform approach, please ensure that:
+  -  [Terraform is installed on your local machine](https://developer.hashicorp.com/terraform/tutorials/azure-get-started/install-cli#install-terraform).
+  -  [Install the Azure CLI](https://learn.microsoft.com/en-us/cli/azure/install-azure-cli) to work with both Terraform and Azure commands.
 
 <div align="center">
   <h3 style="color: #4CAF50;">Total Visitors</h3>
   <img src="https://profile-counter.glitch.me/brown9804/count.svg" alt="Visitor Count" style="border: 2px solid #4CAF50; border-radius: 5px; padding: 5px;"/>
 </div>
+
+## Infrastructure as Code (IaC)
+
+
+
+<div align="center">
+  <img src="https://github.com/user-attachments/assets/16640052-7f57-443a-9efd-30855de5e231" alt="Centered Image" style="border: 2px solid #4CAF50; border-radius: 5px; padding: 5px;"/>
+</div>
+

Terraform/README.md

@@ -5,7 +5,7 @@ Costa Rica
 [![GitHub](https://img.shields.io/badge/--181717?logo=github&logoColor=ffffff)](https://github.com/)
 [brown9804](https://github.com/brown9804)
 
-Last updated: 2025-03-13
+Last updated: 2025-04-15
 
 ------------------------------------------
 
@@ -34,6 +34,7 @@ Last updated: 2025-03-13
 
 - [Overview](#overview)
 - [Finding admin_principal_id Using Azure CLI](#finding-admin_principal_id-using-azure-cli)
+- [Configure Remote Storage for a Terraform deployment](#configure-remote-storage-for-a-terraform-deployment)
 - [How to execute it](#how-to-execute-it)
 
 </details>
@@ -78,6 +79,16 @@ Here is an example value for `admin_principal_id` which is Object ID you retriev
 admin_principal_id = "12345678-1234-1234-1234-1234567890ab"
 ```
 
+## Configure Remote Storage for a Terraform deployment
+
+> To configure remote storage for a Terraform deployment, you need to set up a backend configuration in your Terraform files. This backend configuration specifies where Terraform should store the state file, which keeps track of the resources it manages.
+
+> 1. Create an Azure Storage Account: <br/>
+>     - Go to the Azure portal and create a new storage account (if you don't have one already). <br/>
+>     - Note down the storage account name and the access key. <br/>
+> 2. Create a Storage Container: Within the storage account, create a new container to store the Terraform state file.
+> 3. Configure Terraform Backend: In your Terraform configuration file (e.g., [remote-storage.tf](./src/remote-storage.tf), add the backend configuration for Azure Blob Storage.
+
 ## How to execute it 
 
 ```mermaid 

Terraform/microsoft-fabric-basic-resources.drawio renamed to Terraform/docs/microsoft-fabric-basic-resources.drawio

@@ -0,0 +1,104 @@
+# Retrieve the client configuration of the AzureRM provider
+data "azurerm_client_config" "example" {}
+
+# Check the directory object type
+data "azuread_directory_object" "example" {
+  object_id = data.azurerm_client_config.example.object_id
+}
+
+# Get information about the Entra user
+data "azuread_user" "example" {
+  object_id = data.azurerm_client_config.example.object_id
+}
+
+# Local value to determine if the client is a user or not
+locals {
+  fabric_admin = can(data.azuread_directory_object.example.type == "User") ? data.azuread_user.example.user_principal_name : data.azurerm_client_config.example.object_id
+}
+
+# Create a resource group
+resource "azurerm_resource_group" "example" {
+  name     = var.resource_group_name  # Name of the resource group
+  location = var.location             # Location of the resource group
+}
+
+# Create a storage account for remote state
+resource "azurerm_storage_account" "example" {
+  name                     = var.storage_account_name
+  resource_group_name      = azurerm_resource_group.example.name
+  location                 = azurerm_resource_group.example.location
+  account_tier             = "Standard"
+  account_replication_type = "LRS"
+  depends_on               = [azurerm_resource_group.example]  # Ensure resource group is created first
+}
+
+# Create a storage container for remote state
+resource "azurerm_storage_container" "example" {
+  name                  = var.container_name
+  storage_account_name  = azurerm_storage_account.example.name
+  container_access_type = "private"
+  depends_on            = [azurerm_storage_account.example]  # Ensure storage account is created first
+}
+
+# Create an MSSQL Server
+resource "azurerm_mssql_server" "example" {
+  name                         = var.sql_server_name            # Name of the SQL Server
+  resource_group_name          = azurerm_resource_group.example.name  # Resource group name
+  location                     = azurerm_resource_group.example.location  # Location of the SQL Server
+  version                      = "12.0"                         # SQL Server version
+  administrator_login          = var.admin_username             # Administrator username
+  administrator_login_password = var.admin_password             # Administrator password
+  depends_on                   = [azurerm_resource_group.example]  # Ensure resource group is created first
+}
+
+# Add a null resource to introduce a delay
+resource "null_resource" "wait_for_sql_server" {
+  depends_on = [azurerm_mssql_server.example]
+
+  provisioner "local-exec" {
+    command = "Start-Sleep -Seconds 60"
+    interpreter = ["PowerShell", "-Command"]
+  }
+}
+
+# Create an MSSQL Database
+resource "azurerm_mssql_database" "example" {
+  name      = var.sql_database_name                   # Name of the SQL Database
+  server_id = azurerm_mssql_server.example.id         # ID of the SQL Server
+  sku_name  = "Basic"                                 # SKU name for the SQL Database
+  depends_on = [null_resource.wait_for_sql_server]    # Ensure SQL Server is fully provisioned first
+}
+
+# Create Microsoft Fabric Capacity 
+resource "azurerm_fabric_capacity" "example" {
+  name                = "fc${var.solution_name}"
+  resource_group_name = azurerm_resource_group.example.name
+  location            = var.location
+
+  administration_members = setunion([local.fabric_admin], var.fabric_capacity_admin_upns)
+
+  sku {
+    name = var.fabric_capacity_sku
+    tier = "Fabric"
+  }
+  depends_on = [azurerm_resource_group.example]  # Ensure resource group is created first
+}
+
+# Get the Fabric Capacity details
+data "fabric_capacity" "example" {
+  display_name = azurerm_fabric_capacity.example.name
+
+  lifecycle {
+    postcondition {
+      condition     = self.state == "Active"
+      error_message = "Fabric Capacity is not in Active state. Please check the Fabric Capacity status."
+    }
+  }
+}
+
+# Create a Fabric Workspace
+resource "fabric_workspace" "example" {
+  capacity_id  = data.fabric_capacity.example.id
+  display_name = "ws-${var.solution_name}"
+  depends_on   = [data.fabric_capacity.example]  # Ensure Fabric Capacity data source is available first
+}

Terraform/src/main.tf

@@ -0,0 +1,33 @@
+# Output the name of the resource group
+output "resource_group_name" {
+  value = azurerm_resource_group.example.name  # The name of the resource group
+}
+
+# Output the name of the storage account
+output "storage_account_name" {
+  value = azurerm_storage_account.example.name  # The name of the storage account
+}
+
+# Output the name of the storage container
+output "storage_container_name" {
+  value = azurerm_storage_container.example.name  # The name of the storage container
+}
+
+# Output the name of the MSSQL Server
+output "sql_server_name" {
+  value = azurerm_mssql_server.example.name  # The name of the SQL Server
+}
+
+# Output the name of the MSSQL Database
+output "sql_database_name" {
+  value = azurerm_mssql_database.example.name  # The name of the SQL Database
+}
+
+# Output the name of the Microsoft Fabric Capacity
+output "fabric_capacity_name" {
+  value = azurerm_fabric_capacity.example.name
+}
+
+output "fabric_workspace_name" {
+  value = fabric_workspace.example.display_name
+}

Terraform/src/outputs.tf

@@ -0,0 +1,21 @@
+terraform {
+  required_version = ">= 1.8, < 2.0"
+  # Specify the required providers and their versions
+  required_providers {
+    azurerm = {
+      source  = "hashicorp/azurerm"  # Source of the AzureRM provider
+      version = "~> 4.16.0"          # Version of the AzureRM provider
+    }
+    fabric = {
+      source  = "microsoft/fabric"
+      version = "0.1.0-beta.7"
+    }
+  }
+}
+
+provider "azurerm" {
+  features {}  # Enable all features for the AzureRM provider
+  subscription_id = var.subscription_id  # Add your subscription ID here
+}
+
+provider "fabric" {}

Terraform/src/provider.tf

@@ -0,0 +1,8 @@
+terraform {
+  backend "azurerm" {
+    resource_group_name  = "RGWorkshopUserName" # The name of the resource group for remote state storage
+    storage_account_name = "examplestorageacctworkshop" # The name of the storage account for remote state storage
+    container_name       = "tfstate"  # The name of the container for remote state storage
+    key                  = "terraform.tfstate" # The key for the remote state file
+  }
+}

Terraform/src/remote-storage.tf

@@ -0,0 +1,32 @@
+# ----------------------------------
+### Here is some sample data. Please make any necessary modifications. 
+# ----------------------------------
+
+# Variable for subscription ID
+subscription_id = "" # Add your subscription id number 
+
+# Resource group name
+resource_group_name = "" # Add your desired RG name
+
+# Location of the resources
+location = "Central US"
+
+# SQL Server configuration
+sql_server_name = "usernamesqlserver" # replace username with your name 
+admin_username  = "adminuser" # replace with your desired user name 
+admin_password  = "P@ssw0rd1234"  # Make sure to use a strong password
+
+# SQL Database name
+sql_database_name = "workshopdbusername" # replace username with your name 
+
+# Variables for remote state storage
+storage_account_name = "storageacctworkshop01"
+container_name       = "tfstate"
+
+# Variable for administrator principal ID
+admin_principal_id = ""
+
+# Microsoft Fabric Capacity configuration
+solution_name = "capacitynamews" # choose your capacity name
+fabric_capacity_admin_upns = ["user-email-here", "another-user-email-here"]
+fabric_capacity_sku = "F64" # Choose your SKU like F64

Terraform/src/terraform.tfvars

@@ -0,0 +1,80 @@
+# Variable for the resource group name
+variable "resource_group_name" {
+  description = "The name of the resource group"
+  type        = string
+}
+
+# Variable for the location of the resources
+variable "location" {
+  description = "The location of the resources"
+  type        = string
+  default     = "East US"  # Default location
+}
+
+# Variable for the SQL Server name
+variable "sql_server_name" {
+  description = "The name of the SQL Server"
+  type        = string
+}
+
+# Variable for the administrator username for the SQL Server
+variable "admin_username" {
+  description = "The administrator username for the SQL Server"
+  type        = string
+}
+
+# Variable for the administrator password for the SQL Server
+variable "admin_password" {
+  description = "The administrator password for the SQL Server"
+  type        = string
+  sensitive   = true  # Mark this variable as sensitive
+}
+
+# Variable for the SQL Database name
+variable "sql_database_name" {
+  description = "The name of the SQL Database"
+  type        = string
+}
+
+# Variable for the storage account name
+variable "storage_account_name" {
+  description = "The name of the storage account for remote state storage"
+  type        = string
+}
+
+# Variable for the container name
+variable "container_name" {
+  description = "The name of the container for remote state storage"
+  type        = string
+}
+
+# Variable for the subscription ID
+variable "subscription_id" {
+  description = "The subscription ID for the Azure account"
+  type        = string
+}
+
+# Variable for the administrator principal ID
+variable "admin_principal_id" {
+  description = "The principal ID of the capacity administrator"
+  type        = string
+}
+
+# Variable for the SKU name for the Microsoft Fabric Capacity
+variable "fabric_capacity_sku" {
+  description = "The SKU for the Fabric Capacity."
+  type        = string
+}
+
+# Variable for the solution name
+variable "solution_name" {
+  description = "The name of the solution."
+  type        = string
+}
+
+# Variable for additional UPNs to be added as Fabric Capacity administrators
+variable "fabric_capacity_admin_upns" {
+  description = "Additional UPNs to be added as Fabric Capacity administrators."
+  type        = list(string)
+  default     = []
+}