",
@@ -115,12 +115,11 @@ This will generate the following JSON output:
}
```
->**Note:** Take note of the output. It will be required for the next steps.
+> **Note:** Take note of the output. It will be required for the next steps.
### 3. Resource Deployment
-Now that you have set up the Service Principal, you need to choose how would you like to deploy the resources.
-Deployment options:
+Now that you have set up the Service Principal, you need to choose how would you like to deploy the resources. Deployment options:
1. [GitHub Actions](#github-actions)
1. [Azure DevOps](#azure-devops)
@@ -128,9 +127,8 @@ Deployment options:
#### GitHub Actions
If you want to use GitHub Actions for deploying the resources, add the previous JSON output as a [repository secret](https://docs.github.com/en/actions/reference/encrypted-secrets#creating-encrypted-secrets-for-a-repository) with the name `AZURE_CREDENTIALS` in your GitHub repository:
-
- 
-
+
+
To do so, execute the following steps:
@@ -150,9 +148,8 @@ If you want to use Azure DevOps Pipelines for deploying the resources, you need
1. In Azure DevOps, open the **Project settings**.
1. Now, select the **Service connections** page from the project settings page.
1. Choose **New service connection** and select **Azure Resource Manager**.
-
- 
-
+
+ 
1. On the next page select **Service principal (manual)**.
1. Select the appropriate environment to which you would like to deploy the templates. Only the default option **Azure Cloud** is currently supported.
@@ -161,28 +158,29 @@ If you want to use Azure DevOps Pipelines for deploying the resources, you need
1. Enter a user-friendly **Connection name** to use when referring to this service connection. Take note of the name because this will be required in the parameter update process.
1. Optionally, enter a **Description**.
1. Click on **Verify and save**.
-
- 
-
+
+ 
More information can be found [here](https://docs.microsoft.com/azure/devops/pipelines/library/connect-to-azure?view=azure-devops#create-an-azure-resource-manager-service-connection-with-an-existing-service-principal).
### 4. Parameter Update Process
->**Note:** This section applies for both **Azure DevOps** and **GitHub** Deployment
+> **Note:** This section applies for both **Azure DevOps** and **GitHub** Deployment
+
+In order to deploy the ARM templates in this repository to the desired Azure subscription, you will need to modify some parameters in the forked repository, which will be used for updating the files which will be used during the deployment. Therefor, **this step should not be skipped for neither Azure DevOps/GitHub options**. As updating each parameter file manually is a time-consuming and potentially error-prone process, we have simplified the task with a GitHub Action workflow. You can update your deployment parameters by completing three steps:
-In order to deploy the ARM templates in this repository to the desired Azure subscription, you will need to modify some parameters in the forked repository, which will be used for updating the files which will be used during the deployment. Therefor, **this step should not be skipped for neither Azure DevOps/GitHub options**. As updating each parameter file manually is a time-consuming and potentially error-prone process, we have simplified the task with a GitHub Action workflow. You can update your deployment parameters by completing three steps:
1. Configure the `updateParameters` workflow
1. Execute the `updateParameters` workflow
1. Configure the deployment pipeline
1. Merge these changes back to the `main` branch of your repo
#### Configure the `updateParameters` workflow
->**Note:** There is only one 'updateParametes.yml', which can be found under the '.github' folder and this one will be used also for setting up the Azure DevOps Deployment
-To begin, please open the [.github/workflows/updateParameters.yml](/.github/workflows/updateParameters.yml). In this file you need to update the environment variables. Just click on [.github/workflows/updateParameters.yml](/.github/workflows/updateParameters.yml) and edit the following section:
+> **Note:** There is only one 'updateParameters.yml', which can be found under the '.github' folder and this one will be used also for setting up the Azure DevOps Deployment
-```YAML
+To begin, please open the [.github/workflows/updateParameters.yml](/.github/workflows/updateParameters.yml). In this file you need to update the environment variables. Just click on [.github/workflows/updateParameters.yml](/.github/workflows/updateParameters.yml) and edit the following section:
+
+```yaml
env:
DATA_HUB_SUBSCRIPTION_ID: '{dataHubSubscriptionId}'
DATA_HUB_NAME: '{dataHubName}' # Choose max. 11 characters. They will be used as a prefix for all services. If not unique, deployment can fail for some services.
@@ -194,7 +192,7 @@ The following table explains each of the parameters:
| Parameter | Description | Sample value |
|:-----------------------------------------|:-------------|:-------------|
-| **DATA_HUB_SUBSCRIPTION_ID** | Specifies the subscription ID of the Data Management Zone where all the resources will be deployed | `xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx` |
+| **DATA_HUB_SUBSCRIPTION_ID** | Specifies the subscription ID of the Data Management Zone where all the resources will be deployed | `xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx`
|
| **DATA_HUB_NAME** | Specifies the name of your Data Management Zone. The value should consist of alphanumeric characters (A-Z, a-z, 0-9) and should not contain any special characters like `-`, `_`, `.`, etc. Special characters will be removed in the renaming process. | `myhub01` |
| **LOCATION** | Specifies the region where you want the resources to be deployed. Please check [Supported Regions](#supported-regions) | `northeurope` |
| **AZURE_RESOURCE_MANAGER _CONNECTION_NAME** | Specifies the resource manager connection name in Azure DevOps. You can leave the default value if you want to use GitHub Actions for your deployment. More details on how to create the resource manager connection in Azure DevOps can be found in step 4. b) or [here](https://docs.microsoft.com/azure/devops/pipelines/library/connect-to-azure?view=azure-devops#create-an-azure-resource-manager-service-connection-with-an-existing-service-principal). | `my-connection-name` |
@@ -202,16 +200,19 @@ The following table explains each of the parameters:
#### Execute the `updateParameters` workflow
+
After updating the values, please commit the updated version to the `main` branch of your repository. This will kick off a GitHub Action workflow, which will appear under the **Actions** tab of the main page of the repository. The `Update Parameter Files` workflow will update all parameters in your repository according to a pre-defined naming convention.
#### Configure the deployment pipeline
-The workflow above will make changes to all of the ARM config files. These changes will be stored in a new branch. Once the process has finished, it will open a new pull request in your repository where you can review the changes made by the workflow. The pull request will also provide the values you need to use to configure the deployment pipeline. Please follow the instructions in the pull request to complete the parameter update process.
-If you are using GitHub Actions for your deployment, you will need to modify the `.github/workflows/dataHubDeployment.yml` file. If you are using Azure Pipelines, you only need to modify the `.ado/workflows/dataHubDeployment.yml` file. **You only need to modify one of these files. You do not need to modify both of them.**
+The workflow above will make changes to all of the ARM config files. These changes will be stored in a new branch. Once the process has finished, it will open a new pull request in your repository where you can review the changes made by the workflow. The pull request will also provide the values you need to use to configure the deployment pipeline. Please follow the instructions in the pull request to complete the parameter update process.
->**Note:** We are not renaming the environment variables in the workflow files because this could lead to an infinite loop of workflow runs being started.
+If you are using GitHub Actions for your deployment, you will need to modify the `.github/workflows/dataHubDeployment.yml` file. If you are using Azure Pipelines, you only need to modify the `.ado/workflows/dataHubDeployment.yml` file. **You only need to modify one of these files. You do not need to modify both of them.**
+
+> **Note:** We are not renaming the environment variables in the workflow files because this could lead to an infinite loop of workflow runs being started.
#### Merge these changes back to the `main` branch of your repo
+
After following the instructions in the pull request, you can merge the pull request back into the `main` branch of your repository by clicking on **Merge pull request**. Finally, you can click on **Delete branch** to clean up your repository.
### 5. (not applicable for GH Actions) Reference pipeline from GitHub repository in Azure DevOps Pipelines
@@ -221,14 +222,14 @@ After following the instructions in the pull request, you can merge the pull req
First you need to add and install the Azure Pipelines GitHub App to your GitHub account. To do so, execute the following steps:
1. Click on **Marketplace** in the top navigation bar on GitHub.
-1. In the Marketplace, search for **Azure Pipelines**. The Azure Pipelines offering is free for anyone to use for public repositories and free for a single build queue if you’re using a private repository.
-
- 
-
+1. In the Marketplace, search for **Azure Pipelines**. The Azure Pipelines offering is free for anyone to use for public repositories and free for a single build queue if you're using a private repository.
+
+ 
+
1. Select it and click on **Install it for free**.
-
- 
-
+
+ 
+
1. If you are part of multiple **GitHub** organizations, you may need to use the **Switch billing account** dropdown to select the one into which you forked this repository.
1. You may be prompted to confirm your GitHub password to continue.
1. You may be prompted to log in to your Microsoft account. Make sure you log in with the one that is associated with your Azure DevOps account.
@@ -239,19 +240,19 @@ As a last step, you need to create an Azure DevOps pipeline in your project base
1. Select the Azure DevOps project where you have setup your `Resource Manager Connection`.
1. Select **Pipelines** and then **New Pipeline** in order to create a new pipeline.
-
- 
-
+
+ 
+
1. Choose **GitHub YAML** and search for your repository (e.g. "`GitHubUserName/RepositoryName`").
-
- 
-
+
+ 
+
1. Select your repository.
1. Click on **Existing Azure Pipelines in YAML file**
1. Select `main` as branch and `/.ado/workflows/dataHubDeployment.yml` as path.
-
- 
-
+
+ 
+
1. Click on **Continue** and then on **Run**.
### 6. Follow the workflow deployment
@@ -305,7 +306,7 @@ ERROR: Deployment failed. Correlation ID: ***
"code": "MissingSubscriptionRegistration",
"target": "Microsoft.DocumentDB",
"message": "The subscription is not registered to use namespace 'Microsoft.DocumentDB'. See https://aka.ms/rps-not-found for how to register subscriptions."
-
+
```
**Solution:**
@@ -318,24 +319,16 @@ This error message appears, in case during the deployment it tries to create a t
"statusMessage": "{\"error\":{\"code\":\"InvalidTemplateDeployment\",\"message\":\"The template deployment 'deploy.purview' is not valid according to the validation procedure. The tracking id is '9e22893b-1e0a-48ba-800c-77a27a86cade'. See inner errors for details.\",\"details\":[{\"code\":\"1000\",\"message\":\"Failed to list providers from ARM. Exception: The client '38a6ed90-8590-42fb-b09f-fbcf6f6849c3' with object id '38a6ed90-8590-42fb-b09f-fbcf6f6849c3' does not have authorization to perform action 'Microsoft.Resources/subscriptions/providers/read' over scope '/subscriptions/9ae0dd4c-d127-4901-bb76-46d39676a2cc' or the scope is invalid. If access was recently granted, please refresh your credentials.\"}]}}"
"eventCategory": "Administrative",
-
```
**Solution:**
**Error Purview Specific** This error message appears during the deployment of Purview in case it was not registered inside the subscription. We recommend to check prior the deployment whether the 'purview' resource providers is registered for your subscription and if needed, register it through the `Azure Portal`, `Azure Powershell` or `Azure CLI` as mentioned [here](https://docs.microsoft.com/azure/azure-resource-manager/management/resource-providers-and-types).
-
## Contributing
-This project welcomes contributions and suggestions. Most contributions require you to agree to a
-Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us
-the rights to use your contribution. For details, visit .
+This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit .
-When you submit a pull request, a CLA bot will automatically determine whether you need to provide
-a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions
-provided by the bot. You will only need to do this once across all repositories using our CLA.
+When you submit a pull request, a CLA bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repositories using our CLA.
-This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
-For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or
-contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
+This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
diff --git a/docs/images/ARMConnectionDevOps.png b/docs/images/ARMConnectionDevOps.png
index d36afe185fcfcd1f73148472edc8c671d6c56c65..87d1d339db2a685a659f899aaa829017e146d184 100644
GIT binary patch
literal 62904
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
-
- 
-