eShop

Aplicativo de referência da eShop - "Adventureworks"

Um aplicativo .NET de referência Implementando um site de comércio eletrônico usando uma arquitetura baseada em serviços usando .NET Aspire.

Começando

Esta versão do ESHOP é baseada no .NET 9.

Versões anteriores da ESHOP:

• .NET 8

Pré -requisitos

• Clone o repositório ESHOP: https://github.com/dotnet/eshop
• Instale e inicie o Docker Desktop

Windows com Visual Studio

• Instale o Visual Studio 2022 versão 17.10 ou mais recente.
  • Selecione as seguintes cargas de trabalho:
    • ASP.NET and web development .
    • .NET Aspire SDK Component em Individual components .
    • Opcional: .NET Multi-platform App UI development para executar aplicativos clientes

Ou

• Execute os seguintes comandos em um PowerShell & Terminal em execução como Administrator para configurar automaticamente seu ambiente com as ferramentas necessárias para criar e executar este aplicativo. (Nota: uma reinicialização é necessária e incluída no script abaixo.)

 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

Ou

• De Dev Home, vá para Machine Configuration -> Clone repositories . Digite o URL para este repositório. Na tela de confirmação, procure o Configuration File Detected e clique em Run File .

Mac, Linux e Windows sem Visual Studio

• Instale o mais recente .NET 9 SDK

Ou

• Execute os seguintes comandos em um PowerShell & Terminal em execução como Administrator para configurar automaticamente seu ambiente com as ferramentas necessárias para criar e executar este aplicativo. (Nota: é necessário reinicialização após a execução do script abaixo.)

Instale o código do Visual Studio e extensões 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: esses comandos podem exigir sudo

• Opcional: Instale o código do Visual Studio com o kit C# dev
• Opcional: Instale a carga de trabalho .NET Maui

NOTA: Ao executar no Mac com o Apple Silicon (processador da série M), Rosetta 2 para o GRPC-Tools.

Executando a solução

Aviso

Lembre -se de garantir que o Docker seja iniciado

• (Somente Windows) Execute o aplicativo do Visual Studio:

• Abra o arquivo eShop.Web.slnf no Visual Studio
• Certifique -se de que eShop.AppHost.csproj seja o seu projeto de inicialização
• Acerte o Ctrl-F5 para lançar aspire

• Ou execute o aplicativo do seu terminal:

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

Em seguida, procure linhas como esta na saída do console para encontrar o URL para abrir o painel do Aspire:

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

Pode ser necessário instalar primeiro os certificados de desenvolvimento HTTPS do ASP.NET e fechar todas as guias do navegador. Saiba mais em https://aka.ms/aspnet/https-trust-dev-cert

Azure aberto ai

Ao usar o Azure Openai, dentro de eShop.AppHost/appSsets.json , adicione a seguinte seção:

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

Substitua os valores pelos seus próprios. Então, no eShop.AppHost Program.cs , defina esse valor como true

 bool useOpenAI = false ;

Aqui estão orientações adicionais sobre o componente .NET Aspire Openai.

Use o desenvolvedor do Azure CLI

Você pode usar a CLI do desenvolvedor do Azure para executar este projeto no Azure com apenas alguns comandos. Siga as próximas instruções:

• Instale a mais recente ou atualização da mais recente CLI do desenvolvedor do Azure (AZD).
• Faça login em azd (se você nunca fez isso antes) na sua conta do Azure:

azd auth login

• Inicialize azd da raiz do repo.

azd init

• Durante o init:

  • Selecione Use code in the current directory . O AZD detectará automaticamente o projeto .NET Aspire.
  • Confirme .NET (Aspire) e continue.
  • Selecione quais serviços expor à Internet (expor webapp é suficiente para testar a amostra).
  • Finalize a inicialização, dando um nome ao seu ambiente.

• Crie recursos do Azure e implante a amostra em execução:

azd up

Notas:

• A operação leva alguns minutos na primeira vez em que é executada para um ambiente.
• No final do processo, azd exibirá o url para o WebApp. Siga esse link para testar a amostra.
• Você pode executar azd up depois de salvar alterações na amostra para re-implantar e atualizar a amostra.
• Relate quaisquer problemas ao Azure-Dev Repo.
• Perguntas frequentes e solução de problemas para Azd.

Contribuindo

Para obter mais informações sobre como contribuir com este repositório, leia a documentação da contribuição e o código de conduta.

Dados de amostra

Os dados do catálogo de amostras são definidos no catalog.json. Esses nomes de produtos, descrições e nomes de marcas são fictícios e foram gerados usando o GPT-35-Turbo, e as imagens correspondentes do produto foram geradas usando Dall · E 3.

eShop no Azure

Para uma versão deste aplicativo configurada para implantação no Azure, veja a eShop no Azure Repo.