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

Serviços de DevOps do Azure

Você pode executar o projeto do Azure DevOps Demo Generator como um aplicativo de console ou executável em sua máquina 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, certifique-se de que tem estes componentes instalados na sua máquina:

• SDK do .NET 8
• Visual Studio ou outro IDE preferido
• Git para clonar o repositório

Configurar o Gerador de Demonstração localmente

Siga estes passos para configurar e executar o Demo Generator na sua máquina local:

1. Clone o repositório do Azure DevOps Demo Generator em sua máquina 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 de sua preferência.

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 máquinas 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 as instruções para definir as configurações de publicação (pasta de destino, configuração, tempo de execução).

Na linha de comando:

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

Execute o ficheiro 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, lembre-se destes fatores:

• 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 da compilação.
• Permissões: o aplicativo requer permissões apropriadas para acessar os serviços do Azure DevOps.
• Acesso à rede: verifique se sua máquina pode se conectar aos Serviços de DevOps do Azure por HTTPS.

Solução de problemas

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

1. Verifique a saída do console: revise as mensagens de erro no console para problemas específicos.
2. Verificar dependências: verifique se todos os pacotes e dependências necessários foram restaurados corretamente.
3. Validar configuração: verifique se os arquivos de configuração contêm definições e valores corretos.
4. Verificar 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 Demo Generator, considere estas alternativas para automação de projetos:

• CLI do Azure DevOps para configuração e gerenciamento de projetos 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 projetos

Conteúdo relacionado

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