Quickstart: Azure Spring Apps inrichten met behulp van Azure CLI
Notitie
De Basic-, Standard- en Enterprise-abonnementen worden afgeschaft vanaf medio maart 2025, met een pensioenperiode van 3 jaar. We raden u aan om over te stappen naar Azure Container Apps. Zie de aankondiging over buitengebruikstelling van Azure Spring Apps voor meer informatie.
Het standaardverbruik en het speciale abonnement worden vanaf 30 september 2024 afgeschaft, met een volledige afsluiting na zes maanden. We raden u aan om over te stappen naar Azure Container Apps. Zie Azure Spring Apps Standard-verbruik en toegewezen abonnement migreren naar Azure Container Apps voor meer informatie.
Dit artikel is van toepassing op: ❎ Basic ✅ Standard ✅ Enterprise
In deze quickstart wordt beschreven hoe u Azure CLI gebruikt om een Azure Spring Apps-cluster te implementeren in een bestaand virtueel netwerk.
Met Azure Spring Apps kunt u Spring-toepassingen eenvoudig implementeren in Azure zonder codewijzigingen. De service beheert de infrastructuur van Spring-toepassingen, zodat ontwikkelaars zich kunnen richten op hun code. Azure Spring Apps biedt levenscyclusbeheer met uitgebreide bewaking en diagnose, configuratiebeheer, servicedetectie, CI/CD-integratie, blauwgroene implementaties en meer.
Het Enterprise-implementatieplan bevat de volgende Tanzu-onderdelen:
- Build-service
- Toepassingsconfiguratieservice
- Serviceregister
- Spring Cloud Gateway
- API-portal
Vereisten
- Een Azure-abonnement. Als u geen abonnement hebt, maakt u een gratis account voordat u begint.
- Twee toegewezen subnetten voor het Azure Spring Apps-cluster, een voor de serviceruntime en een voor de Spring-toepassingen. Zie het gedeelte Vereisten voor virtuele netwerken van Azure Spring Apps implementeren in een virtueel netwerk voor subnet- en virtuele netwerkvereisten.
- Een bestaande Log Analytics-werkruimte voor diagnostische instellingen van Azure Spring Apps en een Application Insights-resource op basis van een werkruimte. Zie Logboeken en metrische gegevens analyseren met diagnostische instellingen en Application Insights Java In-Process Agent in Azure Spring Apps voor meer informatie.
- Drie interne CIDR-bereiken (Classless Inter-Domain Routing) (ten minste /16 ) die u hebt geïdentificeerd voor gebruik door het Azure Spring Apps-cluster. Deze CIDR-bereiken zijn niet rechtstreeks routeerbaar en worden alleen intern gebruikt door het Azure Spring Apps-cluster. Clusters gebruiken mogelijk niet 169.254.0.0/16, 172.30.0.0/16, 172.31.0.0/16 of 192.0.2.0/24 voor de interne CIDR-bereiken van de Spring-app of IP-bereiken die zijn opgenomen in het adresbereik van het virtuele clusternetwerk.
- Servicemachtigingen verleend aan het virtuele netwerk. De Azure Spring Apps-resourceprovider vereist
User Access Administrator
enNetwork Contributor
machtigingen voor uw virtuele netwerk om een toegewezen en dynamische service-principal in het virtuele netwerk te verlenen voor verdere implementatie en onderhoud. Zie de sectie Service verlenen aan de sectie Azure Spring Apps implementeren in een virtueel netwerk voor instructies en meer informatie. - Als u Azure Firewall of een NVA (Network Virtual Appliance) gebruikt, moet u ook voldoen aan de volgende vereisten:
- Netwerk- en FQDN-regels (Fully Qualified Domain Name). Zie Vereisten voor virtuele netwerken voor meer informatie.
- Een unieke door de gebruiker gedefinieerde route (UDR) die is toegepast op elk van de serviceruntime- en Spring-toepassingssubnetten. Zie Routering van verkeer van virtuele netwerken voor meer informatie over UDR's. De UDR moet worden geconfigureerd met een route voor 0.0.0.0/0 met een bestemming van uw NVA voordat u het Azure Spring Apps-cluster implementeert. Zie de sectie Bring Your Own Route Table van Azure Spring Apps implementeren in een virtueel netwerk voor meer informatie.
- Azure-CLI
- Als u voor het eerst een Azure Spring Apps Enterprise-planexemplaren implementeert in het doelabonnement, raadpleegt u de sectie Vereisten van het Enterprise-plan in Azure Marketplace.
Het Azure CLI-implementatiescript controleren
Het implementatiescript dat in deze quickstart wordt gebruikt, is afkomstig uit de referentiearchitectuur van Azure Spring Apps.
#!/bin/bash
echo "Enter Azure Subscription ID: "
read subscription
subscription=$subscription
echo "Enter Azure region for resource deployment: "
read region
location=$region
echo "Enter Azure Spring Resource Group Name: "
read azurespringrg
azurespring_resource_group_name=$azurespringrg
echo "Enter Azure Spring VNet Resource Group Name: "
read azurespringvnetrg
azurespring_vnet_resource_group_name=$azurespringvnetrg
echo "Enter Azure Spring Spoke VNet : "
read azurespringappspokevnet
azurespringappspokevnet=$azurespringappspokevnet
echo "Enter Azure Spring App SubNet : "
read azurespringappsubnet
azurespring_app_subnet_name='/subscriptions/'$subscription'/resourcegroups/'$azurespring_vnet_resource_group_name'/providers/Microsoft.Network/virtualNetworks/'$azurespringappspokevnet'/subnets/'$azurespringappsubnet
echo "Enter Azure Spring Service SubNet : "
read azurespringservicesubnet
azurespring_service_subnet_name='/subscriptions/'$subscription'/resourcegroups/'$azurespring_vnet_resource_group_name'/providers/Microsoft.Network/virtualNetworks/'$azurespringappspokevnet'/subnets/'$azurespringservicesubnet
echo "Enter Azure Log Analytics Workspace Resource Group Name: "
read loganalyticsrg
loganalyticsrg=$loganalyticsrg
echo "Enter Log Analytics Workspace Resource Name: "
read workspace
workspaceID='/subscriptions/'$subscription'/resourcegroups/'$loganalyticsrg'/providers/microsoft.operationalinsights/workspaces/'$workspace
echo "Enter Reserved CIDR Ranges for Azure Spring: "
read reservedcidrrange
reservedcidrrange=$reservedcidrrange
echo "Enter key=value pair used for tagging Azure Resources (space separated for multiple tags): "
read tag
tags=$tag
randomstring=$(LC_ALL=C tr -dc 'a-z0-9' < /dev/urandom | fold -w 13 | head -n 1)
azurespring_service='spring-'$randomstring #Name of unique Spring resource
azurespring_appinsights=$azurespring_service
azurespring_resourceid='/subscriptions/'$subscription'/resourceGroups/'$azurespring_resource_group_name'/providers/Microsoft.AppPlatform/Spring/'$azurespring_service
# Create Application Insights
az monitor app-insights component create \
--app ${azurespring_service} \
--location ${location} \
--kind web \
-g ${azurespringrg} \
--application-type web \
--workspace ${workspaceID}
az spring create \
-n ${azurespring_service} \
-g ${azurespringrg} \
-l ${location} \
--sku Standard \
--app-insights ${azurespring_service} \
--app-subnet ${azurespring_app_subnet_name} \
--service-runtime-subnet ${azurespring_service_subnet_name} \
--reserved-cidr-range ${reservedcidrrange} \
--tags ${tags}
# Update diagnostic setting for Azure Spring instance
az monitor diagnostic-settings create \
--name monitoring \
--resource ${azurespring_resourceid} \
--logs '[{"category": "ApplicationConsole","enabled": true}]' \
--workspace ${workspaceID}
Het cluster implementeren
Voer de volgende stappen uit om het Azure Spring Apps-cluster te implementeren met behulp van het Azure CLI-script:
Meld u aan bij Azure met behulp van de volgende opdracht:
az login
Nadat u zich hebt aangemeld, voert deze opdracht informatie uit over alle abonnementen waarvoor u toegang hebt. Noteer de naam en id van het abonnement dat u wilt gebruiken.
Stel het doelabonnement in.
az account set --subscription "<your subscription name>"
Registreer de Azure Spring Apps-resourceprovider.
az provider register --namespace 'Microsoft.AppPlatform'
Voeg de vereiste extensies toe aan Azure CLI.
az extension add --name spring
Kies een implementatielocatie in de regio's waar Azure Spring Apps beschikbaar is, zoals wordt weergegeven in producten die beschikbaar zijn per regio.
Gebruik de volgende opdracht om een lijst met Azure-locaties te genereren. Noteer de korte naamwaarde voor de regio die u in de vorige stap hebt geselecteerd.
az account list-locations --output table
Maak een resourcegroep om de resource in te implementeren.
az group create --name <your-resource-group-name> --location <location-name>
Sla het script voor het Azure Spring Apps Standard-abonnement of Enterprise-abonnement lokaal op en voer het uit vanaf de Bash-prompt.
Standaardabonnement:
./azuredeploySpringStandard.sh
Enterprise-abonnement:
./azuredeploySpringEnterprise.sh
Voer de volgende waarden in wanneer u hierom wordt gevraagd door het script:
- De Azure-abonnements-id die u eerder hebt opgeslagen.
- De Azure-locatienaam die u eerder hebt opgeslagen.
- De naam van de resourcegroep die u eerder hebt gemaakt.
- De naam van de resourcegroep van het virtuele netwerk waar u uw resources gaat implementeren.
- De naam van het virtuele spoke-netwerk (bijvoorbeeld vnet-spoke).
- De naam van het subnet dat moet worden gebruikt door de Azure Spring Apps Application Service (bijvoorbeeld snet-app).
- De naam van het subnet dat moet worden gebruikt door de Azure Spring Apps Runtime-service (bijvoorbeeld snet-runtime).
- De naam van de resourcegroep voor de Azure Log Analytics-werkruimte die moet worden gebruikt voor het opslaan van diagnostische logboeken.
- De naam van de Azure Log Analytics-werkruimte (bijvoorbeeld la-cb5sq6574o2a).
- De CIDR varieert van uw virtuele netwerk dat moet worden gebruikt door Azure Spring Apps (bijvoorbeeld XX.X.X.X/16,XX.X.X.X/16,XX.X.X.X/16).
- De sleutel-/waardeparen die moeten worden toegepast als tags op alle resources die tags ondersteunen. Zie Tags gebruiken om uw Azure-resources en -beheerhiërarchie te organiseren voor meer informatie. Gebruik een door spaties gescheiden lijst om meerdere tags toe te passen (bijvoorbeeld environment=Dev BusinessUnit=finance).
Nadat u deze informatie hebt opgegeven, maakt en implementeert het script de Azure-resources.
Geïmplementeerde resources bekijken
U kunt Azure Portal gebruiken om de geïmplementeerde resources te controleren of azure CLI gebruiken om de geïmplementeerde resources weer te geven.
Resources opschonen
Als u van plan bent om verder te gaan met volgende snelstarts en zelfstudies, kunt u deze resources het beste intact laten. Als u de resourcegroep niet meer nodig hebt, verwijdert u deze. Hierdoor worden ook de resources in de resourcegroep verwijderd. Als u de resourcegroep wilt verwijderen met behulp van Azure CLI, gebruikt u de volgende opdrachten:
echo "Enter the Resource Group name:" &&
read resourceGroupName &&
az group delete --name $resourceGroupName &&
echo "Press [ENTER] to continue ..."
Volgende stappen
In deze quickstart hebt u een Azure Spring Apps-exemplaar geïmplementeerd in een bestaand virtueel netwerk met behulp van Azure CLI en vervolgens de implementatie gevalideerd. Ga verder met de onderstaande resources voor meer informatie over Azure Spring Apps.
- Implementeer een van de volgende voorbeeldtoepassingen vanaf de onderstaande locaties:
- Aangepaste domeinen gebruiken met Azure Spring Apps.
- Toepassingen in Azure Spring Apps beschikbaar maken op internet met behulp van Azure-toepassing Gateway. Zie Toepassingen beschikbaar maken met end-to-end TLS in een virtueel netwerk voor meer informatie.
- Bekijk de beveiligde end-to-end Azure Spring Apps-referentiearchitectuur, die is gebaseerd op het Microsoft Azure Well-Architected Framework.