Partilhar via

.NET .NET Aspire Integração de hospedagem Java/Spring

Inclui:Integração de hospedagem incluída Apenas integração de hospedagem — Client integração não incluídaClient integração não incluída

Observação

Essa integração faz parte do .NET.NET Aspire Community Toolkit e não é oficialmente suportada pela equipe .NET.NET Aspire.

Neste artigo, você aprenderá a usar a integração de hospedagem Java/Spring .NET.NET Aspire para hospedar aplicativos Java/Spring usando o tempo de execução Java ou um contêiner.

Pré-requisitos

Esta integração requer que o OpenTelemetry Agent for Java seja baixado e colocado no diretório agents na raiz do projeto. Dependendo do seu shell preferido, use um dos seguintes comandos para baixar o agente:

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

Linux e confiança de certificados no macOS

Nas plataformas Linux e macOS, talvez seja necessário importar o certificado .NET AspireOpenTelemetry para o armazenamento de certificados Java para que a telemetria funcione corretamente. Sem essa etapa, seu aplicativo Java será iniciado com êxito, mas a coleta de telemetria pode falhar com erros de certificado.

Para adicionar o certificado ao armazenamento confiável Java, você pode usar as seguintes etapas:

  1. Exportar o certificado .NET.NET Aspire do painel (isso varia de acordo com a sua configuração)
  2. Importe-o para o armazenamento confiável Java usando o keytool comando:
keytool -import -trustcacerts -alias aspire-dashboard \
    -file aspire-dashboard.crt \
    -keystore $JAVA_HOME/lib/security/cacerts \
    -storepass changeit

Observação

As etapas exatas para obter e importar o certificado podem variar dependendo do ambiente de desenvolvimento e .NET.NET Aspire da configuração.

Começar

Para começar com a integração de hospedagem .NET.NET Aspire Java/Spring, instale o pacote NuGet 📦 CommunityToolkit.Aspire.Hosting.Java no projeto AppHost.

dotnet add package CommunityToolkit.Aspire.Hosting.Java

Para obter mais informações, consulte dotnet add package ou Gerir dependências de pacotes em aplicações .NET.

Exemplo de Utilização

As seções a seguir detalham vários cenários de uso de exemplo, desde a hospedagem de um aplicativo Spring em contêineres até a hospedagem de um aplicativo Spring executável.

Program.cs No arquivo do seu projeto de host de aplicativo, chame o AddSpringApp método para definir o aplicativo Spring em contêiner. O JavaAppContainerResourceOptions permite especificar a imagem do contêiner e a configuração do agente OpenTelemetry .

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

O ContainerImageName deve apontar para a imagem de contêiner do aplicativo Spring Boot e OtelAgentPath especifica o caminho dentro do contêiner onde o OpenTelemetry agente Java está localizado.

Ver também