Configurar e executar o Gerador de Demonstração do Azure DevOps localmente

Serviços do Azure DevOps

Você pode executar o projeto gerador de demonstração do Azure DevOps como um aplicativo de console ou executável em seu computador local. Essa abordagem oferece mais controle sobre a execução da ferramenta e permite personalizar seu comportamento para cenários específicos.

Pré-requisitos

Antes de começar, verifique se você tem esses componentes instalados em seu computador:

• SDK do .NET 8
• Visual Studio ou outro IDE preferencial
• Obter o Git para executar a clonagem do repositório

Configurar o Gerador de Demonstração localmente

Siga estas etapas para configurar e executar o Gerador de Demonstração em seu computador local:

1. Clone o repositório do Gerador de Demonstração do Azure DevOps no computador local:

   git clone https://github.com/microsoft/AzDevOpsDemoGenerator.git
   cd AzDevOpsDemoGenerator
   

2. Abra o arquivo de solução ADOGenerator.sln no Visual Studio ou no IDE preferido.

3. No Visual Studio, defina o projeto de inicialização:

   1. Clique com o botão direito do mouse no projeto ADOGenerator no Gerenciador de Soluções.
   2. Selecione Definir como Projeto de Inicialização.

4. Crie a solução para restaurar todas as dependências e garantir que o projeto seja compilado com êxito:

   1. No Visual Studio: Clique com o botão direito do mouse na solução no Gerenciador de Soluções e selecione Criar Solução.
   2. Na linha de comando:

   dotnet build
   

5. Execute o projeto como um aplicativo de console usando um destes métodos:

   1. No Visual Studio: Pressione F5 ou selecione o botão Iniciar .
   2. Na linha de comando:

   dotnet run --project src/ADOGenerator/ADOGenerator.csproj
   

Criar um executável

Crie um executável autônomo que você pode distribuir ou executar em computadores sem o SDK do .NET:

Publicar o projeto

No Visual Studio:

1. Clique com o botão direito do mouse no projeto ADOGenerator no Gerenciador de Soluções.
2. Selecione Publicar.
3. Siga os prompts para definir as configurações de publicação (pasta de destino, configuração, runtime).

Na linha de comando:

dotnet publish src/ADOGenerator/ADOGenerator.csproj -c Release -r win-x64 --self-contained

Executar o executável

Vá para o diretório publicado e execute o executável:

cd src/ADOGenerator/bin/Release/net8.0/win-x64/publish
./ADOGenerator.exe

Considerações de configuração

Ao executar o Gerador de Demonstração do Azure DevOps localmente, tenha esses fatores em mente:

• Arquivos de configuração: verifique se os arquivos de configuração necessários (como appsettings.json) estão presentes no diretório de saída.
• Dependências: verifique se todas as dependências necessárias estão incluídas na saída do build.
• Permissões: o aplicativo requer permissões apropriadas para acessar os serviços do Azure DevOps.
• Acesso à rede: verifique se o computador pode se conectar ao Azure DevOps Services via HTTPS.

Resolução de problemas

Se você encontrar problemas ao configurar ou executar o Gerador de Demonstração:

1. Verificar a saída do console: examine as mensagens de erro no console em busca de problemas específicos.
2. Verificar dependências: verifique se todos os pacotes e dependências necessários foram restaurados corretamente.
3. Validar a configuração: verifique se os arquivos de configuração contêm configurações e valores corretos.
4. Examine a conectividade: verifique a conectividade de rede com o Azure DevOps Services.
5. Verifique a versão do .NET: confirme se você está usando a versão correta do SDK do .NET.

Abordagens alternativas

Como a Microsoft não desenvolve mais ativamente o Gerador de Demonstração, considere estas alternativas para automação de projetos:

• CLI do Azure DevOps para configuração e gerenciamento de projeto com script
• Automação da API REST para soluções personalizadas de provisionamento de projetos
• Scripts do PowerShell usando APIs REST do Azure DevOps
• Modelos do Azure Resource Manager para infraestrutura e configuração de projeto

Conteúdo relacionado

• Usar o gerador de demonstração
• Criar seu próprio modelo
• Visão geral da CLI do Azure DevOps
• Referência da API REST do Azure DevOps