Delen via

Aspire Integratie van Java/Spring-hosting

Inclusief:Hostingintegratie inbegrepen Alleen hostingintegratie — Client integratie niet inbegrepenClient integratie niet inbegrepen

Notitie

Deze integratie maakt deel uit van de Aspire Community Toolkit en wordt niet officieel ondersteund door het Aspire team.

In dit artikel leert u hoe u de Aspire Integratie van Java/Spring-hosting gebruikt om Java/Spring-toepassingen te hosten met behulp van de Java-runtime of een container.

Voorwaarden

Voor deze integratie moet de OpenTelemetry-agent voor Java worden gedownload en in de agents directory in de hoofddirectory van het project worden geplaatst. Gebruik een van de volgende opdrachten om de agent te downloaden, afhankelijk van de shell van uw voorkeur:

# bash/zsh
mkdir -p ./agents
wget -P ./agents \
    https://github.com/open-telemetry/opentelemetry-java-instrumentation/releases/latest/download/opentelemetry-javaagent.jar

Linux en macOS-certificaatvertrouwen

Op Linux en macOS-platforms moet u het AspireOpenTelemetry certificaat mogelijk importeren in het Java-certificaatarchief om telemetrie goed te laten werken. Zonder deze stap wordt uw Java-toepassing gestart, maar het verzamelen van telemetrie kan mislukken met certificaatfouten.

Als u het certificaat wilt toevoegen aan de Java TrustStore, kunt u de volgende stappen uitvoeren:

  1. Aspire Het dashboardcertificaat exporteren (dit verschilt per installatie)
  2. Importeer deze in de Java TrustStore met behulp van de keytool opdracht:
keytool -import -trustcacerts -alias aspire-dashboard \
    -file aspire-dashboard.crt \
    -keystore $JAVA_HOME/lib/security/cacerts \
    -storepass changeit

Notitie

De exacte stappen voor het verkrijgen en importeren van het certificaat kunnen variëren, afhankelijk van uw ontwikkelomgeving en Aspire configuratie.

Aan de slag

Installeer de CommunityToolkit om aan de slag te gaan met de Aspire Integratie van Java/Spring-hosting.📦Aspire Hosting.Java NuGet-pakket in het AppHost-project.

dotnet add package CommunityToolkit.Aspire.Hosting.Java

Zie dotnet pakket toevoegen of Pakketafhankelijkheden beheren in .NET toepassingenvoor meer informatie.

Voorbeeldgebruik

In de volgende secties worden verschillende voorbeeldgebruiksscenario's beschreven, van het hosten van een in een container geplaatste Spring-app tot het hosten van een uitvoerbare Spring-app.

Roep in het AppHost.cs bestand van uw AppHost-project de AddSpringApp methode aan om de in een container geplaatste Spring-app te definiëren. Met JavaAppContainerResourceOptions kunt u de containerimage en OpenTelemetry agentconfiguratie opgeven.

var containerapp = builder.AddSpringApp(
    "containerapp",
    new JavaAppContainerResourceOptions
    {
        ContainerImageName = "your-registry/your-spring-app:latest",
        OtelAgentPath = "./agents"
    });

Het ContainerImageName moet verwijzen naar de containerinstallatiekopie van uw Spring Boot-toepassing en OtelAgentPath geeft het pad op in de container waar de OpenTelemetry Java-agent zich bevindt.

Zie ook