Orbit
Ligar um Repositório Bitbucket
Bitbucket connects to Orbit through OAuth: you authorise Kapsule once, Orbit lists the repositories your Bitbucket account can reach, and it registers a webhook per repository so every push triggers…
Bitbucket conecta-se a Orbit através de OAuth: autoriza Kapsule uma vez, Orbit lista os repositórios que a sua conta Bitbucket consegue aceder, e regista um webhook por repositório para que cada push acione uma compilação. Este guia abrange a conexão, a seleção de um repositório, a criação do projeto, e o que verificar quando um repositório não aparece.
Antes de Começar
Orbit vê apenas o que a sua conta Bitbucket vê. Para um repositório de workspace precisa de pelo menos acesso de escrita, e permissão suficiente para criar um webhook de repositório. Se o seu workspace restringe consumidores OAuth de terceiros, um administrador tem de permitir o Kapsule Orbit antes da conexão ter sucesso.
Passo 1: Conectar Bitbucket
- No KPanel, clique em Orbit na barra lateral esquerda.
- Clique em New project.
- Deixe o modo definido como Import Git Repo.
- No passo 1, clique em Connect Bitbucket.
É enviado para Bitbucket para autorizar o consumidor OAuth Kapsule Orbit. Conceda as permissões solicitadas e Bitbucket devolve-o ao KPanel com os seus repositórios carregados. O passo 1 mostra então Just connected.
Se a autorização falhar, o KPanel mostra o erro que Bitbucket devolveu. Leia-o em vez de tentar novamente à sorte: uma política de workspace bloqueada e uma autorização cancelada têm aspeto similar mas precisam de correções diferentes.
Passo 2: Selecionar um Repositório
Os seus repositórios acessíveis aparecem como uma lista. Clique em Select junto ao que deseja implementar. Os repositórios privados têm um crachá Private; Orbit implementa repositórios públicos e privados de igual forma.
Se um Repositório Está em Falta
- Confirme o seu nível de acesso no repositório. O acesso de leitura não é suficiente; precisa de acesso de escrita para Orbit registar o webhook de que necessita.
- Verifique se o repositório está num workspace a que realmente pertence, não num ao qual tem apenas um link.
- Clique em Reconnect Bitbucket no passo 1 para executar novamente o fluxo OAuth e atualizar o token e a lista de repositórios.
Se o painel mostrar No repos accessible, a concessão teve sucesso mas não devolveu nada. Reconecte e confirme que aprovou os âmbitos do repositório.
Passo 3: Configurar o Seu Projeto
| Campo | O que faz |
|---|---|
| Project Name | O nome de apresentação no KPanel, por exemplo my-app |
| Deploy URL | O subdomínio sob kaps.run, portanto my-app torna-se my-app.kaps.run |
Clique em Create project. Orbit clona o repositório, coloca a primeira compilação na fila, e leva-o para a visão geral do projeto com o log em tempo real.
O slug de Deploy URL é definido uma vez, na criação, e não pode ser editado depois. Para servir num endereço diferente, anexe um domínio personalizado. Veja Adding a Custom Domain to Your Project.
Implementações Automáticas
Orbit regista um webhook no seu repositório Bitbucket na criação do projeto. Depois disso:
- Um push para o seu ramo de produção coloca uma implementação de produção na fila.
- Um push para qualquer outro ramo constrói uma pré-visualização isolada em
branch-<branch-name>.kaps.run, se Branch previews está ativado em Settings sob Runtime. Veja Branch Preview Deployments in Orbit. - Eliminar um ramo pausa o seu ambiente de pré-visualização, e o armazenamento é recuperado num espaço de tempo de cerca de um dia.
Nunca cria ou mantém o webhook por si mesmo.
A definição CI required checks no Orbit controla implementações com base em nomes de trabalhos do GitHub Actions ou num pipeline do GitLab. Não controla baseado em Bitbucket Pipelines. Se precisa de Bitbucket Pipelines para decidir quando uma implementação acontece, desative implementações acionadas por push para esse ramo e tenha o seu pipeline chamar um deploy hook no sucesso em alternativa. Veja Triggering Deployments Via Deploy Hooks.
Reconectar ou Desconectar Bitbucket
- Clique em Orbit, depois em New project.
- No passo 1, clique em Reconnect para executar novamente o fluxo OAuth, ou em Disconnect para remover a ligação.
Reconectar é o primeiro passo correto sempre que a listagem de repositórios quebra, porque os tokens OAuth expiram e reconectar cria um novo.
Desconectar mantém os seus projetos e o seu histórico de implementação, e a implementação ativa continua a servir tráfego. As implementações acionadas por push param. Os deploy hooks também param, porque um hook lê a cabeça do ramo através da conexão do fornecedor para decidir o que compilar.
Leitura Relacionada
- Deploying Your Project para o ciclo completo de implementação, bloqueios de implementação e aprovações
- Configuring Your Build Command and Output Directory se a primeira compilação falhar ou publicar a pasta errada
- Connecting a GitHub Repo e Connecting a GitLab Repo para os outros fornecedores