eShop

Aplicación de referencia de Eshop - "AdventureWorks"

Una aplicación de referencia .NET que implementa un sitio web de comercio electrónico que utiliza una arquitectura basada en servicios utilizando .NET Aspire.

Empezando

Esta versión de Eshop se basa en .NET 9.

Versiones anteriores de ESHOP:

• .NET 8

Requisitos previos

• Clone El repositorio de Eshop: https://github.com/dotnet/eshop
• Instalar e iniciar Docker Desktop

Windows con Visual Studio

• Instale Visual Studio 2022 versión 17.10 o más nuevo.
  • Seleccione las siguientes cargas de trabajo:
    • ASP.NET and web development .
    • .NET Aspire SDK Componente en Individual components .
    • Opcional: .NET Multi-platform App UI development para ejecutar aplicaciones de cliente

O

• Ejecute los siguientes comandos en un PowerShell & Terminal que se ejecuta como Administrator para configurar automáticamente su entorno con las herramientas requeridas para construir y ejecutar esta aplicación. (Nota: se requiere un reinicio e incluido en el script a continuación).

 install-Module - Name Microsoft.WinGet.Configuration - AllowPrerelease - AcceptLicense - Force
$ env: Path = [ System.Environment ]::GetEnvironmentVariable( " Path " , " Machine " ) + " ; " + [ System.Environment ]::GetEnvironmentVariable( " Path " , " User " )
get-WinGetConfiguration - file ..configurationsvside.dsc.yaml | Invoke-WinGetConfiguration - AcceptConfigurationAgreements

O

• Desde Dev Home, vaya a Machine Configuration -> Clone repositories . Ingrese la URL para este repositorio. En la pantalla de confirmación, busque el Configuration File Detected y haga clic en Run File .

Mac, Linux y Windows sin Visual Studio

• Instale el último SDK .NET 9

O

• Ejecute los siguientes comandos en un PowerShell & Terminal que se ejecuta como Administrator para configurar automáticamente su entorno con las herramientas requeridas para construir y ejecutar esta aplicación. (Nota: se requiere un reinicio después de ejecutar el script a continuación).

Instale el código Visual Studio y las extensiones relacionadas

 install-Module - Name Microsoft.WinGet.Configuration - AllowPrerelease - AcceptLicense  - Force
$ env: Path = [ System.Environment ]::GetEnvironmentVariable( " Path " , " Machine " ) + " ; " + [ System.Environment ]::GetEnvironmentVariable( " Path " , " User " )
get-WinGetConfiguration - file ..configurationsvscode.dsc.yaml | Invoke-WinGetConfiguration - AcceptConfigurationAgreements

NOTA: Estos comandos pueden requerir sudo

• Opcional: Instale el código Visual Studio con el kit de desarrollo C#
• Opcional: Instale la carga de trabajo .net maui

Nota: Cuando se ejecuta en Mac con Apple Silicon (procesador de la Serie M), Rosetta 2 para las herramientas GRPC.

Ejecutando la solución

Advertencia

Recuerde asegurarse de que se inicie Docker

• (Windows solamente) Ejecute la aplicación desde Visual Studio:

• Abra el archivo eShop.Web.slnf en Visual Studio
• Asegúrese de que eShop.AppHost.csproj sea su proyecto de inicio
• Presione CTRL-F5 para lanzar Aspire

• O ejecute la aplicación desde su terminal:

dotnet run -- project src / eShop.AppHost / eShop.AppHost.csproj

Luego, busque líneas como esta en la salida de la consola para encontrar la URL para abrir el tablero Aspire:

Login to the dashboard at: http://localhost:19888/login ? t=uniquelogincodeforyou

Es posible que deba instalar primero los certificados de desarrollo ASP.NET Core HTTPS y luego cerrar todas las pestañas del navegador. Obtenga más información en https://aka.ms/aspnet/https-trustdev-cert

Azure abierto ai

Al usar Azure OpenAi, dentro de Eshop.apphost/AppSettings.json , agregue la siguiente sección:

  "ConnectionStrings" : {
    "OpenAi" : " Endpoint=xxx;Key=xxx; "
  }

Reemplace los valores con los suyos. Luego, en el eshop.apphost programa.cs , ​​establezca este valor en verdad

 bool useOpenAI = false ;

Aquí hay una guía adicional sobre el componente .NET Aspire OpenAI.

Use el desarrollador de Azure CLI

Puede usar el Azure Developer CLI para ejecutar este proyecto en Azure con solo unos pocos comandos. Siga las siguientes instrucciones:

• Instale lo último o actualización al último desarrollador de Azure CLI (AZD).
• Inicie sesión azd (si no lo ha hecho antes) en su cuenta de Azure:

azd auth login

• Inicialice azd de la raíz del repositorio.

azd init

• Durante Init:

  • Seleccione Use code in the current directory . AZD detectará automáticamente el proyecto .NET Aspire.
  • Confirme .NET (Aspire) y continúe.
  • Seleccione qué servicios exponer a Internet (exponer webapp es suficiente para probar la muestra).
  • Finalice la inicialización dando un nombre a su entorno.

• Cree recursos de azul e implementa la muestra ejecutando:

azd up

Notas:

• La operación toma unos minutos la primera vez que se ejecuta para un entorno.
• Al final del proceso, azd mostrará la url para la aplicación web. Siga ese enlace para probar la muestra.
• Puede ejecutar azd up después de guardar cambios en la muestra para volver a implementar y actualizar la muestra.
• Informe cualquier problema al repositorio de Azure-Dev.
• Preguntas frecuentes y solución de problemas para AZD.

Que contribuye

Para obtener más información sobre cómo contribuir a este repositorio, lea la documentación de contribución y el Código de Conducta.

Muestra de datos

Los datos del catálogo de muestra se definen en Catáloga. Json. Esos nombres de productos, descripciones y marcas son ficticios y se generaron utilizando GPT-35-TURBO, y las imágenes del producto correspondientes se generaron utilizando Dall · E 3.

Eshop en Azure

Para una versión de esta aplicación configurada para la implementación en Azure, vea el ESHOP en Azure Repo.