Share via

Quickstart: Azure Spring Apps inrichten met behulp van Azure CLI

  • Artikel

Notitie

Azure Spring Apps is de nieuwe naam voor de Azure Spring Cloud-service. Hoewel de service een nieuwe naam heeft, ziet u de oude naam op sommige plaatsen terwijl we werken aan het bijwerken van assets, zoals schermopnamen, video's en diagrammen.

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 Resourceprovider van Azure Spring Apps vereist eigenaarsmachtigingen 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:
  • 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 ID: "
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 Enterprise \
    --build-pool-size S1 \
    --enable-application-configuration-service \
    --enable-service-registry \
    --enable-gateway \
    --enable-api-portal \
    --api-portal-instance-count 2 \
    --enable-java-agent true \
    --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:

  1. 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.

  2. Stel het doelabonnement in.

    az account set --subscription "<your subscription name>"

  3. Registreer de Azure Spring Apps-resourceprovider.

    az provider register --namespace 'Microsoft.AppPlatform'

  4. Voeg de vereiste extensies toe aan Azure CLI.

    az extension add --name spring

  5. Kies een implementatielocatie in de regio's waar Azure Spring Apps beschikbaar is, zoals wordt weergegeven in producten die beschikbaar zijn per regio.

  6. 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

  7. Maak een resourcegroep om de resource in te implementeren.

    az group create --name <your-resource-group-name> --location <location-name>

  8. 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

  9. 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.