Pular para o conteúdo principal
Roberty Studio
CODECode

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:

MecanismoComo o deploy acontece
GitHubA cada push na branch configurada.
Azure DevOpsA cada push no Azure Repos.
GitLabA cada push no GitLab.
BitbucketA cada push no Bitbucket.
Arquivo .zipA 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​

  1. Instale o Roberty GitHub App na sua conta ou organização do GitHub.
  2. Autorize o acesso aos repositórios desejados. Ao concluir, você volta automaticamente para o projeto.
  3. 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​

  1. Clique em Conectar com Azure DevOps e entre com a conta Microsoft da organização (conta corporativa do Microsoft Entra ID).
  2. Se a conta participar de mais de uma organização do Azure DevOps, escolha a organização onde está o repositório.
  3. 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​

  1. Clique em Conectar com GitLab, entre com a sua conta do gitlab.com e autorize o aplicativo Roberty Code.
  2. 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​

  1. Clique em Conectar com Bitbucket e entre com a sua conta do bitbucket.org.
  2. Se a conta participar de mais de um workspace do Bitbucket, escolha o workspace onde está o repositório.
  3. 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:

CampoObrigatórioDescrição
RepositórioSimBusque entre os repositórios disponíveis no provedor.
ProduçãoSimBranch implantada nos dispositivos de Produção.
PreviewNãoBranch 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:

EstadoO que significa
AtivoDeploy automático ativo: cada push nas branches configuradas gera um deploy. Mostra a data do último push recebido.
Configuração manualA 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.
FalhouO 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.