Rövid útmutató: Arm-sablon használata az Azure API FHIR-hez való üzembe helyezéséhez

Cikk
2024. 09. 25.

Fontos

Az Azure API for FHIR 2026. szeptember 30-án megszűnik. A migrálási stratégiákat követve válthat az Azure Health Data Services FHIR® szolgáltatásra ezen a napon. Az Azure API for FHIR megszűnése miatt 2025. április 1-től nem lesz lehetőség új üzembe helyezéseket végezni. Az Azure Health Data Services FHIR szolgáltatás az Azure API for FHIR továbbfejlesztett verziója, amely lehetővé teszi az ügyfelek számára az FHIR, a DICOM és a MedTech szolgáltatások kezelését más Azure-szolgáltatásokba való integrációval.

Ebben a rövid útmutatóban megtudhatja, hogyan helyezheti üzembe az Azure API for Fast Healthcare együttműködési erőforrásaihoz (FHIR®) készült Azure Resource Manager-sablont (ARM-sablont). Az Azure API for FHIR-t az Azure Portalon, a PowerShellen vagy a parancssori felületen helyezheti üzembe.

Az Azure Resource Manager-sablon egy JavaScript Object Notation (JSON) fájl, amely meghatározza a projekt infrastruktúráját és konfigurációját. A sablon deklaratív szintaxist használ. Az üzembe helyezés létrehozásához szükséges programozási parancsok sorozatának megírása nélkül írhatja le a tervezett üzembe helyezést.

Ha a környezet megfelel az előfeltételeknek, és már ismeri az ARM-sablonokat, kattintson az Üzembe helyezés az Azure-ban gombra. A sablon a bejelentkezés után megnyílik az Azure Portalon.

Előfeltételek

Egy Azure-fiók, aktív előfizetéssel. Hozzon létre egyet ingyen.

A sablon áttekintése

Az ebben a gyorsútmutatóban használt sablon az Azure-gyorssablonok közül származik.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "metadata": {
    "_generator": {
      "name": "bicep",
      "version": "0.5.6.12127",
      "templateHash": "9588053699595008971"
    }
  },
  "parameters": {
    "serviceName": {
      "type": "string",
      "metadata": {
        "description": "The name of the service."
      }
    },
    "location": {
      "type": "string",
      "allowedValues": [
        "australiaeast",
        "eastus",
        "eastus2",
        "japaneast",
        "northcentralus",
        "northeurope",
        "southcentralus",
        "southeastasia",
        "uksouth",
        "ukwest",
        "westcentralus",
        "westeurope",
        "westus2"
      ],
      "metadata": {
        "description": "Location of Azure API for FHIR"
      }
    }
  },
  "resources": [
    {
      "type": "Microsoft.HealthcareApis/services",
      "apiVersion": "2021-11-01",
      "name": "[parameters('serviceName')]",
      "location": "[parameters('location')]",
      "kind": "fhir-R4",
      "properties": {
        "authenticationConfiguration": {
          "audience": "[format('https://{0}.azurehealthcareapis.com', parameters('serviceName'))]",
          "authority": "[uri(environment().authentication.loginEndpoint, subscription().tenantId)]"
        }
      }
    }
  ]
}

A sablon egy Azure-erőforrást határoz meg.

Microsoft.HealthcareApis/services

A sablon üzembe helyezése

Az Alábbi hivatkozásra kattintva üzembe helyezheti az Azure API for FHIR-t az ARM-sablon használatával az Azure Portalon:

Az Azure API FHIR-hez való üzembe helyezése lapon:

Ha szeretné, módosítsa az előfizetést az alapértelmezettről egy másik előfizetésre.
Erőforráscsoport esetén válassza az Új létrehozása lehetőséget, adja meg az új erőforráscsoport nevét, majd kattintson az OK gombra.
Ha létrehozott egy új erőforráscsoportot, válasszon egy régiót az erőforráscsoporthoz.
Adjon meg egy új szolgáltatásnevet , és válassza ki az FHIR-hez készült Azure API helyét . A hely lehet ugyanaz, mint az erőforráscsoport régiója, vagy más lehet.
Válassza az Áttekintés + létrehozás lehetőséget.
Olvassa el a használati feltételeket, majd válassza a Létrehozás lehetőséget.

Megjegyzés

Ha helyileg szeretné futtatni a PowerShell-szkripteket, először adja meg Connect-AzAccount az Azure-beli hitelesítő adatait.

Ha az Microsoft.HealthcareApis erőforrás-szolgáltató még nincs regisztrálva az előfizetéséhez, regisztrálhatja az alábbi interaktív kóddal. Ha futtatni szeretné a kódot az Azure Cloud Shellben, válassza a Kipróbálás lehetőséget bármely kódblokk felső sarkában.

Register-AzResourceProvider -ProviderNamespace Microsoft.HealthcareApis

Az alábbi kóddal üzembe helyezheti az Azure API for FHIR szolgáltatást az ARM-sablonnal. A kód rákérdez az új FHIR szolgáltatásnévre, egy új erőforráscsoport nevére és az egyes helyekre.

$serviceName = Read-Host -Prompt "Enter a name for the new Azure API for FHIR service"
$serviceLocation = Read-Host -Prompt "Enter an Azure region (for example, westus2) for the service"
$resourceGroupName = Read-Host -Prompt "Enter a name for the new resource group to contain the service"
$resourceGroupRegion = Read-Host -Prompt "Enter an Azure region (for example, centralus) for the resource group"

Write-Verbose "New-AzResourceGroup -Name $resourceGroupName -Location $resourceGroupRegion" -Verbose
New-AzResourceGroup -Name $resourceGroupName -Location $resourceGroupRegion
Write-Verbose "Run New-AzResourceGroupDeployment to create an Azure API for FHIR service using an ARM template" -Verbose
New-AzResourceGroupDeployment -ResourceGroupName $resourceGroupName `
    -TemplateUri https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.healthcareapis/azure-api-for-fhir/azuredeploy.json `
    -serviceName $serviceName `
    -location $serviceLocation
Read-Host "Press [ENTER] to continue"

az extension add --name healthcareapis

read -p "Enter a name for the new Azure API for FHIR service: " serviceName &&
read -p "Enter an Azure region (for example, westus2) for the service: " serviceLocation &&
read -p "Enter a name for the new resource group to contain the service: " resourceGroupName &&
read -p "Enter an Azure region (for example, centralus) for the resource group: " resourceGroupRegion &&
params='serviceName='$serviceName' location='$serviceLocation &&
echo "CREATE RESOURCE GROUP:  az group create --name $resourceGroupName --location $resourceGroupRegion" &&
az group create --name $resourceGroupName --location $resourceGroupRegion &&
echo "RUN az deployment group create, which creates an Azure API for FHIR service using an ARM template" &&
az deployment group create --resource-group $resourceGroupName --parameters $params --template-uri https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.healthcareapis/azure-api-for-fhir/azuredeploy.json &&
read -p "Press [ENTER] to continue: "

Megjegyzés

Az üzembe helyezés végrehajtása néhány percet vesz igénybe. Jegyezze fel az Azure API for FHIR szolgáltatás és az erőforráscsoport nevét az üzembe helyezett erőforrások áttekintéséhez.

Üzembe helyezett erőforrások áttekintése

Az alábbi lépéseket követve áttekintheti az új Azure API for FHIR szolgáltatást:

Az Azure Portalon keresse meg és válassza ki az Azure API for FHIR-t.
Az FHIR listában válassza ki az új szolgáltatást. Megjelenik az új Azure API for FHIR szolgáltatás áttekintési oldala.
Annak ellenőrzéséhez, hogy az új FHIR API-fiók ki van-e építve, válassza az FHIR metaadat-végpont melletti hivatkozást az FHIR API képességi utasításának lekéréséhez. A hivatkozás formátuma https://<service-name>.azurehealthcareapis.com/metadata: . Ha a fiók ki van építve, megjelenik egy JSON-fájl.

Futtassa az alábbi interaktív kódot az Azure API for FHIR szolgáltatás részleteinek megtekintéséhez. Meg kell adnia az új szolgáltatás nevét és erőforráscsoportját.

$serviceName = Read-Host -Prompt "Enter the name of your Azure API for FHIR service"
$resourceGroupName = Read-Host -Prompt "Enter the resource group name"
Write-Verbose "Get-AzHealthcareApisService -ResourceGroupName $resourceGroupName -Name $serviceName" -Verbose
Get-AzHealthcareApisService -ResourceGroupName $resourceGroupName -Name $serviceName
Read-Host "Press [ENTER] to fetch the FHIR API capability statement, which shows that the new service has been provisioned"

$requestUri="https://" + $serviceName + ".azurehealthcareapis.com/metadata"
$metadata = Invoke-WebRequest -Uri $requestUri
$metadata.RawContent
Read-Host "Press [ENTER] to continue"

Futtassa az alábbi interaktív kódot az Azure API for FHIR szolgáltatás részleteinek megtekintéséhez. Meg kell adnia az új szolgáltatás és az erőforráscsoport nevét.

read -p "Enter the name of your Azure API for FHIR service: " serviceName &&
read -p "Enter the resource group name: " resourceGroupName &&
echo "SHOW SERVICE DETAILS:  az healthcareapis service show --resource-group $resourceGroupName --resource-name $serviceName" &&
az healthcareapis service show --resource-group $resourceGroupName --resource-name $serviceName &&
read -p "Press [ENTER] to fetch the FHIR API capability statement, which shows that the new service has been provisioned: " &&
requestUrl='https://'$serviceName'.azurehealthcareapis.com/metadata' &&
curl --url $requestUrl &&
read -p "Press [ENTER] to continue: "

Az erőforrások eltávolítása

Ha már nincs rá szükség, törölje az erőforráscsoportot. Ez törli az erőforráscsoport erőforrásait.

Az Azure Portalon keresse meg és válassza ki az erőforráscsoportokat.
Az erőforráscsoport listájában válassza ki az erőforráscsoport nevét.
Az erőforráscsoport Áttekintés lapján válassza az Erőforráscsoport törlése lehetőséget.
A megerősítést kérő párbeszédpanelen írja be az erőforráscsoport nevét, majd válassza a Törlés lehetőséget.

$resourceGroupName = Read-Host -Prompt "Enter the name of the resource group to delete"
Write-Verbose "Remove-AzResourceGroup -Name $resourceGroupName" -Verbose
Remove-AzResourceGroup -Name $resourceGroupName
Read-Host "Press [ENTER] to continue"

read -p "Enter the name of the resource group to delete: " resourceGroupName &&
echo "DELETE A RESOURCE GROUP (AND ITS RESOURCES):  az group delete --name $resourceGroupName" &&
az group delete --name $resourceGroupName &&
read -p "Press [ENTER] to continue: "

Az ARM-sablon létrehozásának folyamatán végigvezető részletes oktatóanyagért tekintse meg az első ARM-sablon létrehozásához és üzembe helyezéséhez szükséges oktatóanyagot.

Következő lépések

Ebben a rövid útmutatóban üzembe helyezte az Azure API for FHIR-t az előfizetésében. Az alkalmazások regisztrálásával és az Azure API for FHIR konfigurációs beállításaival kapcsolatos információkért tekintse meg az alábbiakat.

Alkalmazások regisztrálása – áttekintés

Az Azure RBAC konfigurálása

A helyi RBAC konfigurálása

Adatbázis-beállítások konfigurálása

Ügyfél által felügyelt kulcsok konfigurálása

CORS konfigurálása

Privát kapcsolat konfigurálása

Megjegyzés

Az FHIR® a HL7 bejegyzett védjegye, amelyet a HL7 engedélyével használnak.