https://github.com/jamesmcroft/export-azure-sql-database-to-blob-storage

This runbook automates Azure SQL database backups to Blob Storage using Managed Identity.
https://github.com/jamesmcroft/export-azure-sql-database-to-blob-storage

azureautomationrunbookgallery azuresql azurestorage module powershell

Last synced: 27 days ago
JSON representation

This runbook automates Azure SQL database backups to Blob Storage using Managed Identity.

• Host: GitHub
• URL: https://github.com/jamesmcroft/export-azure-sql-database-to-blob-storage
• Owner: jamesmcroft
• License: mit
• Created: 2024-01-20T08:33:04.000Z (10 months ago)
• Default Branch: main
• Last Pushed: 2024-01-20T16:14:12.000Z (10 months ago)
• Last Synced: 2024-05-01T15:20:35.711Z (6 months ago)
• Topics: azureautomationrunbookgallery, azuresql, azurestorage, module, powershell
• Language: PowerShell
• Homepage:
• Size: 5.86 KB
• Stars: 2
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Export Azure SQL Databases To Blob Storage

You should use this runbook if you want to backup Azure SQL databases to Blob storage using a managed identity.

A `.bacpac` file will be created for each database and stored in the specified Azure Storage blob container on every run of the runbook. The runbook will also delete any `.bacpac` files older than the specified retention period.

The files created will be named in the following format: `databaseName-yyyyMMddHHmm.bacpac`.

## Prerequisites

### Configuring Managed Identity

You will need to update the RBAC permissions of the system assigned managed identity in your Azure Automation account.

Alternatively, create a user assigned managed identity and assign it to the Azure Automation account also.

The following permissions are required for the managed identity:

- DevTest Labs User [Scope: Resource Group]

- Reader [Scope: Resource Group]

- Contributor [Scope: Azure SQL Server]

- Storage Blob Data Contributor [Scope: Storage Account]

If you are using a user assigned managed identity, the system assigned managed identity will need the first two permissions.

For more information on how to configure managed identity with runbooks, see [this tutorial on Microsoft Docs](https://learn.microsoft.com/en-us/azure/automation/learn/powershell-runbook-managed-identity)

> Note: This runbook can be used together with Azure SQL database backups.

### Configuring Azure Automation Runtime

If you are using the recommended PowerShell 7.2 runtime version, you will need to install the `Az.ManagedServiceIdentity` module from the PowerShell Gallery in your Azure Automation account, as this is not installed by default.

To do this, navigate to your Azure Automation account in the Azure portal, click on Modules under Shared Resources, and then click on Browse Gallery. Search for `Az.ManagedServiceIdentity` and install the latest version of the module.

## Parameters

- **ResourceGroupName**: The name of the resource group where the Azure resources are located.

- **ManagedIdentityType**: The type of managed identity to use. Valid values are `System` and `User`.

- **UserIdentityName**: The name of the user assigned managed identity to use. This parameter must be set if the ManagedIdentityType parameter is set to `User`.

- **SqlServerName**: The name of the Azure SQL Server.

- **SqlServerAdmin**: The username of the Azure SQL Server administrator.

- **SqlServerAdminPw**: The password of the Azure SQL Server administrator.

- **DatabaseNames**: A comma separated list of the names of the Azure SQL databases to backup.

- **StorageAccountName**: The name of the Azure Storage account where the backups will be stored.

- **StorageAccountKey**: The access key of the Azure Storage account where the backups will be stored. To locate this value, follow the instructions in [this Microsoft Docs article](https://learn.microsoft.com/en-us/azure/storage/common/storage-account-keys-manage?tabs=azure-portal#view-account-access-keys)

- **BlobContainerName**: The name of the Azure Storage blob container where the backups will be stored. If the blob container does not exist, it will be created.

- **RetentionDays**: The number of days to keep the backups in the Azure Storage blob container.