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
- No App Builder, clique no botão Publish.
- Selecione Azure DevOps como a plataforma de destino.
- Autentique-se com sua conta Microsoft.
- 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:
- Escolha sua organização e projeto.
- Clique em Create Repository.
- Defina o nome e visibilidade do repositório (privado/público – a visibilidade depende das configurações do projeto).
- O repositório é criado e inicializado para publicação.
Publicar/Enviar o Código para o Repositório
- Clique em Publish para gerar e enviar o código-fonte do seu aplicativo.
- A publicação inicial preenche o branch padrão (
main) com seus arquivos gerados. - 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:
- Garanta que um pipeline foi criado e vinculado ao repositório.
- O App Builder acionará o build automaticamente quando o código for enviado.
- Monitore o status do build dentro do Azure DevOps.
Pull Requests para Mudanças Subsequentes
Para publicações subsequentes:
- O App Builder cria um branch de feature com um nome único.
- Um Pull Request (PR) é gerado automaticamente.
- O pipeline de build é executado no PR para validar as mudanças.
- 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 Email | Status do Domínio | Tipo de Conta | Suporte à Autenticação |
|---|---|---|---|
user@company.com | Verificado | Trabalho | ✅ Funciona out-of-box |
user@tenant.onmicrosoft.com | Domínio Azure integrado | Trabalho | ✅ Funciona out-of-box |
user@outlook.com | N/A | Pessoal | ❌ Não suportado |
user@mydomain.com | Não verificado | Pessoal | ❌ Não suportado a menos que o domínio seja verificado |
Como Verificar um Domínio
- Vá para Microsoft Entra ID > Custom domain names
- Adicione seu domínio
- 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
