Zelfstudie: Een webtoepassing implementeren die is verbonden met Azure Blob Storage met serviceconnector

In deze zelfstudie leert u hoe u toegang krijgt tot Azure Blob Storage voor een web-app (niet een aangemelde gebruiker) die wordt uitgevoerd op Azure-app Service met behulp van beheerde identiteiten. In deze zelfstudie gebruikt u de Azure CLI om de volgende taken uit te voeren:

• Uw eerste omgeving instellen met de Azure CLI
• Een opslagaccount en Azure Blob Storage-container maken
• Code implementeren in Azure-app Service en verbinding maken met opslag met beheerde identiteit met behulp van serviceconnector

Vereisten

• Een Azure-account met een actief abonnement. Gratis een account maken

• Gebruik de Bash-omgeving in Azure Cloud Shell. Zie quickstart voor Bash in Azure Cloud Shell voor meer informatie.

  

• Installeer de Azure CLI, indien gewenst, om CLI-referentieopdrachten uit te voeren. Als u in Windows of macOS werkt, kunt u Azure CLI uitvoeren in een Docker-container. Zie De Azure CLI uitvoeren in een Docker-container voor meer informatie.

  • Als u een lokale installatie gebruikt, meldt u zich aan bij Azure CLI met behulp van de opdracht az login. Volg de stappen die worden weergegeven in de terminal, om het verificatieproces te voltooien. Raadpleeg Aanmelden bij Azure CLI voor aanvullende aanmeldingsopties.

  • Installeer de Azure CLI-extensie bij het eerste gebruik, wanneer u hierom wordt gevraagd. Raadpleeg Extensies gebruiken met Azure CLI voor meer informatie over extensies.

  • Voer az version uit om de geïnstalleerde versie en afhankelijke bibliotheken te vinden. Voer az upgrade uit om te upgraden naar de nieuwste versie.

Uw eerste omgeving instellen

1. Controleer of uw Azure CLI-versie 2.30.0 of hoger is:

   az --version
   

   Als u een upgrade wilt uitvoeren, voert u de az upgrade opdracht uit (vereist versie 2.11+).

2. Meld u aan bij Azure met behulp van de CLI:

   az login
   

   Met deze opdracht wordt een browser geopend om uw referenties te verzamelen. Wanneer de opdracht is voltooid, wordt er een JSON-uitvoer weergegeven met informatie over uw abonnementen.

   Zodra u bent aangemeld, kunt u Azure-opdrachten uitvoeren met de Azure CLI om te werken met resources in uw abonnement.

De voorbeeld-app klonen of downloaden

1. Kloon de voorbeeldopslagplaats:

   git clone https://github.com/Azure-Samples/serviceconnector-webapp-storageblob-dotnet.git
   

2. Ga naar de hoofdmap van de opslagplaats:

   cd serviceconnector-webapp-storageblob-dotnet
   

De App Service-app maken

1. Controleer in de terminal of u zich in de map WebAppStorageMISample-opslagplaats bevindt die de app-code bevat.

2. Maak een App Service-app (het hostproces) met de az webapp up onderstaande opdracht en vervang de tijdelijke aanduidingen door uw eigen gegevens:

   • Gebruik voor het --location argument een regio die wordt ondersteund door Service Connector.
   • Vervang door <app-name> een unieke naam in Azure. Het servereindpunt is https://<app-name>.azurewebsites.net. De tekens die voor <app-name> zijn toegestaan, zijn A-Z, 0-9 en -. Het is handig om een een combinatie van uw bedrijfsnaam en een app-id te gebruiken.

    az webapp up --name <app-name> --sku B1 --location eastus --resource-group ServiceConnector-tutorial-rg
   

Een opslagaccount en een Blob Storage-container maken

Voer in de terminal de volgende opdracht uit om een v2-opslagaccount voor algemeen gebruik en een Blob Storage-container te maken.

az storage account create --name <storage-name> --resource-group ServiceConnector-tutorial-rg --sku Standard_RAGRS --https-only

Vervang <storage-name> door een unieke naam. De naam van de container moet in kleine letters staan, beginnen met een letter of een getal en mag alleen letters, cijfers en het streepje (-) bevatten.

Een App Service-app verbinden met een Blob Storage-container met een beheerde identiteit

Voer in de terminal de volgende opdracht uit om uw web-app te verbinden met een blobopslag met behulp van een beheerde identiteit.

az webapp connection create storage-blob -g ServiceConnector-tutorial-rg -n <app-name> --tg ServiceConnector-tutorial-rg --account <storage-name> --system-identity

Vervang de volgende tijdelijke aanduidingen door uw eigen gegevens:

• Vervang door <app-name> de naam van de web-app die u in stap 3 hebt gebruikt.
• Vervang door <storage-name> de naam van de opslag-app die u in stap 4 hebt gebruikt.

Notitie

Als u het foutbericht 'Het abonnement is niet geregistreerd voor het gebruik van Microsoft.ServiceLinker' wordt weergegeven, voert az provider register -n Microsoft.ServiceLinker u de serviceconnectorresourceprovider uit en voert u de verbindingsopdracht opnieuw uit.

Voorbeeldcode uitvoeren

Voer in de terminal de volgende opdracht uit om de voorbeeldtoepassing in uw browser te openen. Vervang door <app-name> de naam van de web-app die u eerder hebt gebruikt.

az webapp browse --name <app-name> 

De voorbeeldcode is een webtoepassing. Telkens wanneer u de indexpagina vernieuwt, maakt of werkt de toepassing een blob bij met de tekst Hello Service Connector! Current is {UTC Time Now} naar de opslagcontainer en leest deze terug om deze weer te geven op de indexpagina.

Volgende stap

Lees de onderstaande handleiding voor meer informatie over Service Connector.

Concepten van serviceconnector