Skip to content

Commit bd381f2

Browse files
committed
update FHIR Bicep deploy article
1 parent 5d707a1 commit bd381f2

1 file changed

Lines changed: 20 additions & 10 deletions

File tree

articles/healthcare-apis/deploy-healthcare-apis-using-bicep.md

Lines changed: 20 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -19,20 +19,23 @@ In this article, you learn how to create Azure Health Data Services, including w
1919

2020
## What is Azure Bicep
2121

22-
Bicep is built on top of Azure Resource Manager (ARM) template. Bicep immediately supports all preview and generally available (GA) versions for Azure services, including Azure Health Data Services. During development, you can generate a JSON ARM template file using the `az bicep build` command. Conversely, you can decompile the JSON files to Bicep using the `az bicep decompile` command. During deployment, the Bicep CLI converts a Bicep file into an ARM template JSON.
22+
Bicep is built on top of Azure Resource Manager (ARM) template. Bicep immediately supports all preview and generally available (GA) versions for Azure services, including Azure Health Data Services. For more information on Bicep, see [What is Bicep](../azure-resource-manager/bicep/overview.md).
2323

24-
You can continue to work with JSON ARM templates, or use Bicep to develop your ARM templates. For more information on Bicep, see [What is Bicep](../azure-resource-manager/bicep/overview.md).
24+
25+
During development, you can generate a JSON ARM template file using the `az bicep build` command. Conversely, you can decompile a JSON ARM template file to Bicep using the `az bicep decompile` command. During deployment, the Bicep CLI converts a Bicep file into an ARM template JSON.
26+
27+
You can continue to work with JSON ARM templates, or use Bicep to develop your ARM templates.
2528

2629
>[!Note]
2730
>The templates and scripts in the article are tested in Visual Studio Code during the public preview. Some changes may be necessary to adapt the code to run in your environment.
2831
2932
## Define parameters and variables
3033

31-
Using Bicep parameters and variables instead of hard coding names and other values allows you to debug and reuse your Bicep files.
34+
In this example, create a Bicep template file named `ahds.bicep` Using Bicep parameters and variables instead of hard coding names and other values allows you to debug and reuse your Bicep files. They’re used when you run the template in the CLI command line with the "--parameters" option.
3235

33-
We first define parameters with the keyword *param* for workspace, FHIR service, and DICOM service. Also, we define parameters for Azure subscription and Microsoft Entra tenant. They’re used in the CLI command line with the "--parameters" option.
36+
First, define parameters with the keyword *param* for workspace and the services you want to deploy. Also, define parameters for Azure subscription and Microsoft Entra tenant.
3437

35-
We then define variables for resources with the keyword *var*. Also, we define variables for properties such as the authority and the audience for the FHIR service. They’re specified and used internally in the Bicep file and can be used in combination of parameters, Bicep functions, and other variables. Unlike parameters, they aren’t used in the CLI command line.
38+
Then define variables for resources with the keyword *var*. Also, if you're deploying a FHIR service, define variables for properties such as the authority and the audience. They’re specified and used internally in the Bicep file and can be used in combination of parameters, Bicep functions, and other variables. Unlike parameters, they aren’t used in the CLI command line.
3639

3740
It's important to note that one Bicep function and environment are required to specify the login URL, `https://login.microsoftonline.com`. For more information on Bicep functions, see [Deployment functions for Bicep](../azure-resource-manager/bicep/bicep-functions-deployment.md#environment).
3841

@@ -76,7 +79,9 @@ resource exampleExistingWorkspace 'Microsoft.HealthcareApis/workspaces@2021-06-0
7679
}
7780
```
7881

79-
You're now ready to deploy the workspace resource using the `az deployment group create` command. You can also deploy it along with its other resources, as described further later in this article.
82+
You're now ready to deploy the workspace resource using the `az deployment group create` command. You can also deploy it along with its other resources, as described further in this article.
83+
84+
For more information about workspace templates, see [Microsoft.HealthcareApis workspaces](/azure/templates/microsoft.healthcareapis/workspaces)
8085

8186
## Create a FHIR service template
8287

@@ -114,6 +119,8 @@ resource exampleExistingFHIR 'Microsoft.HealthcareApis/workspaces/fhirservices@2
114119
}
115120
```
116121

122+
For more information about FHIR service templates, see [Microsoft.HealthcareApis workspaces/fhirservices](/azure/templates/microsoft.healthcareapis/workspaces/fhirservices)
123+
117124
## Create a DICOM service template
118125

119126
For the DICOM service resource, the required properties include service instance name and location, and the dependency on the workspace resource type.
@@ -139,6 +146,10 @@ Similarly, you can use or reference an existing DICOM service using the keyword
139146
}
140147
```
141148

149+
For more information about DICOM service templates, see [Microsoft.HealthcareApis workspaces/dicomservices](/azure/templates/microsoft.healthcareapis/workspaces/dicomservices)[!INCLUDE [FHIR and DICOM trademark statement](./includes/healthcare-apis-fhir-dicom-trademark.md)]
150+
151+
152+
142153
## Deploy Azure Health Data Services
143154

144155
You can use the `az deployment group create` command to deploy individual Bicep file or combined templates, similar to the way you deploy Azure resources with JSON templates. Specify the resource group name, and include the parameters in the command line. With the "--parameters" option, specify the parameter and value pair as "parameter = value", and separate the parameter and value pairs by a space if more than one parameter is defined.
@@ -175,9 +186,8 @@ output stringOutput2 string = audience
175186

176187
## Next steps
177188

178-
In this article, you learned how to create Azure Health Data Services, including workspaces, FHIR services, and DICOM services using Bicep. You also learned how to create and debug Bicep files. For more information about Azure Health Data Services, see:
179-
180189
>[!div class="nextstepaction"]
181-
>[What is Azure Health Data Services?](healthcare-apis-overview.md)
190+
>[Manage user access and permissions](authentication-authorization.md)
191+
192+
[!INCLUDE [FHIR and DICOM trademark statement](./includes/healthcare-apis-fhir-dicom-trademark.md)]
182193

183-
FHIR® is a registered trademark of [HL7](https://hl7.org/fhir/) and is used with the permission of HL7.

0 commit comments

Comments
 (0)