Skip to content

Publicando Aplicativos no Azure DevOps a partir do App Builder

A integração com Azure DevOps no App Builder permite que você publique código-fonte gerado (Angular, React, Blazor ou Web Components) diretamente em seus repositórios DevOps. Isso simplifica a entrega aos times de desenvolvimento e se integra naturalmente aos seus fluxos de trabalho de CI/CD existentes.

Antes de começar, é importante entender como os tipos de conta Microsoft afetam a autenticação e quais passos são necessários para habilitar o acesso — consulte a seção abaixo para detalhes.

Conectar ao Seu Projeto Existente no Azure DevOps

  1. No App Builder, clique no botão Publish.
  2. Selecione Azure DevOps como a plataforma de destino.
  3. Autentique-se com sua conta Microsoft.
  4. Após login bem-sucedido e MFA (se habilitado), suas organizações, projetos e repositórios do Azure DevOps serão listados para seleção.

Suas credenciais são verificadas com segurança. O App Builder solicita apenas as permissões necessárias para publicação.

Criar um Repositório para o Aplicativo a partir do App Builder

Se nenhum repositório existe ainda:

  1. Escolha sua organização e projeto.
  2. Clique em Create Repository.
  3. Defina o nome e visibilidade do repositório (privado/público – a visibilidade depende das configurações do projeto).
  4. O repositório é criado e inicializado para publicação.

Publicar/Enviar o Código para o Repositório

  1. Clique em Publish para gerar e enviar o código-fonte do seu aplicativo.
  2. A publicação inicial preenche o branch padrão (main) com seus arquivos gerados.
  3. Um indicador de status confirma a publicação bem-sucedida.

Build Automático do CI

O Azure DevOps suporta pipelines de build que podem ser acionados ao fazer push:

  1. Garanta que um pipeline foi criado e vinculado ao repositório.
  2. O App Builder acionará o build automaticamente quando o código for enviado.
  3. Monitore o status do build dentro do Azure DevOps.

Pull Requests para Mudanças Subsequentes

Para publicações subsequentes:

  1. O App Builder cria um branch de feature com um nome único.
  2. Um Pull Request (PR) é gerado automaticamente.
  3. O pipeline de build é executado no PR para validar as mudanças.
  4. Você pode revisar diffs de código antes de fazer merge.

Este fluxo de trabalho garante qualidade de código e colaboração em equipe.

Implantar como Aplicativo Ativo (Em Breve)

Em breve, você poderá implantar seu aplicativo no Azure Web Apps diretamente a partir do App Builder.

  • Suportará tanto aplicativos web padrão como aplicativos web estáticos
  • Simplifica a implantação para demos de cliente e ambientes de staging

Como os Tipos de Conta Microsoft Impactam a Autenticação

Ao conectar o Azure DevOps ao App Builder, a autenticação é feita via Microsoft Entra ID (anteriormente Azure Active Directory). O tipo de conta impacta diretamente o sucesso desta conexão.

Tipos de Conta Microsoft Suportados

Contas de Trabalho ou Escola (Azure AD)

  • Exemplos: user@company.com, user@tenant.onmicrosoft.com
  • Totalmente suportadas
  • Não requerem configuração adicional na maioria dos casos
  • Podem conceder acesso necessário baseado na política organizacional

Contas Microsoft Pessoais

  • Exemplos: user@outlook.com, user@hotmail.com
  • Não são suportadas diretamente devido a políticas de acesso do Azure DevOps
  • Resultarão em erro de autenticação (ex: AADSTS500202)
  • Solução alternativa:
    • Adicione o usuário como convidado ao seu tenant do Azure AD, ou
    • Converta a conta pessoal em uma conta de trabalho

Verificação de Domínio & Classificação de Conta

O domínio associado ao seu endereço de email determina como a Microsoft classifica a conta.

Endereço de EmailStatus do DomínioTipo de ContaSuporte à Autenticação
user@company.comVerificadoTrabalho✅ Funciona out-of-box
user@tenant.onmicrosoft.comDomínio Azure integradoTrabalho✅ Funciona out-of-box
user@outlook.comN/APessoal❌ Não suportado
user@mydomain.comNão verificadoPessoal❌ Não suportado a menos que o domínio seja verificado

Como Verificar um Domínio

  1. Vá para Microsoft Entra ID > Custom domain names
  2. Adicione seu domínio
  3. Siga os passos de DNS para adicionar um registro TXT ao seu registrador de domínio

Melhores Práticas para Organizações

Para garantir uma integração suave e evitar problemas de autenticação:

  • ✅ Use contas de trabalho ou escola associadas ao Azure AD
  • ✅ Verifique seus domínios no Microsoft Entra ID
  • ✅ Configure o Azure DevOps para usar seu diretório do Azure AD
  • ✅ Garanta que um principal de serviço está registrado para acesso DevOps
  • ⚠ Para contas pessoais:
    • Convide-as como convidados no seu tenant
    • Ou provisione uma conta de trabalho para atividades de desenvolvimento