Fonte do código
Conecte o projeto a um repositório no GitHub, Azure DevOps, GitLab ou Bitbucket, ou use upload de .zip, e escolha as branches de Produção e Preview.
Fonte do código
A fonte do código define de onde o projeto recebe o código a cada deploy. Ela é configurada nas configurações do projeto, aba Repositório, no Mecanismo de deploy:
| Mecanismo | Como o deploy acontece |
|---|---|
| GitHub | A cada push na branch configurada. |
| Azure DevOps | A cada push no Azure Repos. |
| GitLab | A cada push no GitLab. |
| Bitbucket | A cada push no Bitbucket. |
| Arquivo .zip | A cada upload manual de uma nova versão, só para Produção. Veja Deploys. |
Para conectar um provedor Git, clique em Conectar com {provedor}. A Roberty só acessa os repositórios que você autorizar, e a conexão pode ser desfeita a qualquer momento. Não há conexão por token pessoal (PAT, app password ou token de projeto): a autorização é sempre feita pelo login no provedor.
GitHub
- Instale o Roberty GitHub App na sua conta ou organização do GitHub.
- Autorize o acesso aos repositórios desejados. Ao concluir, você volta automaticamente para o projeto.
- Escolha o repositório e as branches de cada ambiente.
Se o app já estiver instalado em mais de uma conta, escolha a conta — Organização ou Pessoal — ou use Conectar outra conta para instalar em outra. Os pushes chegam pelo próprio app: não há nada a configurar no repositório.
Azure DevOps
- Clique em Conectar com Azure DevOps e entre com a conta Microsoft da organização (conta corporativa do Microsoft Entra ID).
- Se a conta participar de mais de uma organização do Azure DevOps, escolha a organização onde está o repositório.
- Escolha o repositório e as branches. A lista traz os repositórios de todos os projetos da organização.
Ao salvar, a Roberty cria automaticamente um Service Hook "Code pushed" no projeto do Azure DevOps.
Requisitos e limites:
- Contas pessoais da Microsoft (Outlook, Hotmail, Live) não são suportadas: a organização precisa estar ligada a um diretório do Microsoft Entra ID.
- Aprovação do administrador necessária: se o diretório da empresa não permite que usuários aprovem aplicativos, a tela de conexão mostra um link de aprovação. Abra-o ou copie-o para um administrador do Microsoft Entra, que aprova a Roberty uma vez para a organização; depois, conecte de novo.
- Só o Azure DevOps Services é suportado — Azure DevOps Server (on-premises) e repositórios TFVC não são.
- Políticas de acesso condicional que exigem IP também em fluxos não interativos podem bloquear as chamadas da Roberty. Nesse caso, fale com o suporte.
- Se a autorização for cancelada, a conta não participar de nenhuma organização ou o link de conexão expirar, a tela mostra o motivo e permite tentar de novo.
Desconectar remove o Service Hook criado pela Roberty. Para revogar também o consentimento do aplicativo, remova a Roberty em myapps.microsoft.com.
GitLab
- Clique em Conectar com GitLab, entre com a sua conta do gitlab.com e autorize o aplicativo Roberty Code.
- Escolha o repositório e as branches. A lista traz os projetos não arquivados de que a sua conta é membro, pessoais e de grupos.
Ao salvar, a Roberty cria automaticamente um webhook de push no projeto do GitLab.
Requisitos e limites:
- Só gitlab.com — GitLab self-managed e GitLab Dedicated não são suportados.
- Para a Roberty criar o webhook, a sua conta precisa do papel Maintainer ou Owner no projeto. Com papel menor, a conexão funciona, mas o webhook precisa ser configurado manualmente.
Desconectar remove o webhook criado pela Roberty e revoga o acesso do aplicativo.
Bitbucket
- Clique em Conectar com Bitbucket e entre com a sua conta do bitbucket.org.
- Se a conta participar de mais de um workspace do Bitbucket, escolha o workspace onde está o repositório.
- Escolha o repositório e as branches. A lista traz os repositórios do workspace escolhido.
Ao salvar, a Roberty cria automaticamente um webhook "Repository push" no repositório.
Requisitos e limites:
- Só Bitbucket Cloud — Bitbucket Data Center e Bitbucket Server não são suportados.
- Um workspace por projeto. Para usar um repositório de outro workspace, desconecte e conecte de novo escolhendo o outro workspace.
- Para a Roberty criar o webhook, a sua conta precisa ser administradora do repositório. Sem essa permissão, a conexão funciona, mas o webhook precisa ser configurado manualmente.
Desconectar remove o webhook criado pela Roberty. Para revogar também o acesso do aplicativo, remova o Roberty Code em Personal settings → App authorizations no Bitbucket.
Repositório e branches
Com o provedor conectado, escolha de onde o código de cada ambiente é sincronizado:
| Campo | Obrigatório | Descrição |
|---|---|---|
| Repositório | Sim | Busque entre os repositórios disponíveis no provedor. |
| Produção | Sim | Branch implantada nos dispositivos de Produção. |
| Preview | Não | Branch de testes, implantada no dispositivo de Preview. |
A mesma branch não pode ser usada nos dois ambientes. Ao salvar, o repositório e as branches passam a valer para os próximos deploys. A partir daí, cada push em uma dessas branches gera um deploy nos dispositivos do ambiente correspondente.
O cartão da conta conectada mostra o estado Conexão ativa ou Reconexão necessária.
Webhook
No Azure DevOps, GitLab e Bitbucket, os pushes chegam por um webhook que a Roberty tenta criar ao salvar a configuração. O painel Webhook mostra o estado:
| Estado | O que significa |
|---|---|
| Ativo | Deploy automático ativo: cada push nas branches configuradas gera um deploy. Mostra a data do último push recebido. |
| Configuração manual | A sua conta não tem permissão para criar o webhook. O painel mostra a URL e o segredo prontos para copiar, e alguém com permissão segue os passos abaixo uma vez. |
| Falhou | O webhook não foi criado. Pushes não geram deploy até isso ser resolvido. Use Tentar novamente. |
Passos da configuração manual:
- Azure DevOps (administrador do projeto): Project settings → Service hooks → +, escolha Web Hooks e o evento Code pushed, selecione o repositório (deixe Branch e Pushed by em [Any]), cole a URL e o header em HTTP headers e finalize.
- GitLab (Maintainer do projeto): Settings → Webhooks → Add new webhook, cole a URL e o Signing token, marque só Push events em Trigger e salve.
- Bitbucket (administrador do repositório): Repository settings → Webhooks → Add webhook, cole a URL e o Secret, deixe só Repository push em Triggers e salve.
Depois, use Verificar novamente. O primeiro push recebido também marca o webhook como ativo.
Reconectar
No Azure DevOps, GitLab e Bitbucket, a autorização pode expirar ou ser revogada (troca de senha, política do diretório, conta removida). Nesse caso, o projeto mostra Reconecte o {provedor} e os pushes não geram deploy até a reconexão. O repositório e as branches ficam bloqueados para edição até você reconectar.
Reconectando com a mesma conta — e, no Azure DevOps e no Bitbucket, a mesma organização ou workspace —, o repositório, as branches e o webhook continuam configurados. Escolher outro workspace do Bitbucket conta como uma conexão nova.
Trocar de provedor
Trocar provedor desconecta o provedor atual para você conectar outro:
- A conexão com o provedor atual é removida do projeto.
- Os dispositivos param de executar e ficam sem código até você conectar o novo provedor e escolher repositório e branches.
- A plataforma não copia o código: levar o repositório para o novo provedor é responsabilidade sua.
- O histórico de deploys é mantido, mas o rollback fica disponível só para deploys do provedor conectado.
Trocar entre Git e .zip
O mecanismo de deploy pode ser trocado entre repositório Git e upload de .zip. A troca não é possível enquanto houver um deploy em andamento.
De Git para .zip:
- A conexão com o provedor Git é removida do projeto.
- O dispositivo de Preview é desvinculado e os agendamentos dele são apagados.
- Os dispositivos de Produção param de executar e ficam sem código até o primeiro upload de .zip.
De .zip para Git:
- O arquivo .zip é apagado da plataforma e o espaço volta para o workspace.
- Os dispositivos param de executar e ficam sem código até você conectar um provedor Git e escolher repositório e branch.
Nos dois sentidos, o histórico de deploys é mantido, mas sem reimplantar versões anteriores, e levar o código para a nova origem é responsabilidade sua.
Permissões
Só administradores do workspace podem desconectar o provedor, trocar de provedor e trocar o mecanismo de deploy.