Repositórios
Cadastre os repositórios de código do workspace, descreva cada um com propriedades personalizadas e saiba como os agentes os encontram.
Os repositórios do workspace formam o cadastro de código com que os agentes podem trabalhar. Cada repositório tem uma URL, uma descrição e, se você quiser, propriedades personalizadas, como o ambiente de deploy ou o time responsável.
O cadastro é a base para os projetos: ao anexar um repositório a um projeto, você escolhe um repositório daqui ou informa uma URL. Veja Recursos do projeto.
Onde ficam
No app, abra Configurações › Repositórios, no grupo Conexões e extensões. Todos os membros veem a lista. Adicionar, editar, reordenar e remover repositórios é com proprietários e administradores.
A lista tem busca por URL ou descrição. Para mudar a ordem, arraste as linhas; com uma busca ativa, a ordem fica travada até você limpar a busca.
Adicionar um repositório
Abra o formulário
Clique em Adicionar repositório.
Informe a URL
Use uma URL HTTPS ou SSH, por exemplo https://github.com/acme/loja ou git@github.com:acme/loja.git. O formulário mostra como o repositório foi identificado. Um repositório que já está no workspace é recusado.
Descreva o repositório
A Descrição diz aos agentes para que serve o repositório, como "API de pedidos em Go". Em Propriedades personalizadas, preencha os campos que o workspace definiu para repositórios.
Com o GitHub conectado ao workspace, use Escolher do GitHub para selecionar vários repositórios de uma instalação de uma vez. Veja GitHub.
Pela CLI:
jiraya repo add git@github.com:acme/loja.git --description "Loja virtual em Next.js"O jiraya repo add aceita várias URLs no mesmo comando e não duplica as que já existem. A --description só vale quando você adiciona uma URL.
Propriedades personalizadas
As propriedades descrevem os repositórios com campos do seu workspace: texto, número, seleção, seleção múltipla, data, caixa de seleção, URL, membro ou membros.
- Definir os campos: em Configurações › Propriedades, escolha Repositórios no seletor do topo e crie a propriedade. É o mesmo catálogo das propriedades de tarefas, mas separado delas. Pela CLI, use
jiraya property create --scope repository. - Preencher os valores: no formulário do repositório, em Propriedades personalizadas, ou pela CLI.
jiraya repo property set git@github.com:acme/loja.git --name Ambiente --value ProduçãoDefinir campos e preencher valores é com proprietários e administradores. Qualquer membro ou agente lê os valores com jiraya repo property list.
Como os agentes usam os repositórios
Cada execução recebe nas instruções a lista de repositórios disponíveis, com a URL e a descrição de cada um. O agente busca o código com jiraya repo checkout <url>, que cria uma cópia de trabalho numa branch própria da execução.
Quais repositórios aparecem depende da tarefa:
| Situação | Repositórios disponíveis |
|---|---|
| Tarefa num projeto com repositórios anexados | Só os repositórios do projeto. |
| Tarefa num projeto sem repositórios, ou sem projeto | Os repositórios do workspace. |
Dica
Uma descrição curta e específica ajuda o agente a escolher o repositório certo sem abrir cada um.
Editar e remover
No menu da linha, Editar abre o formulário, Ver detalhes mostra os dados sem editar, Copiar URL copia o endereço e Remover tira o repositório do workspace na hora, depois de uma confirmação.
Limite
O número de repositórios pode ter um teto, o limite Repositórios conectados. Veja Limites do workspace.
Comandos da CLI
| Comando | O que faz |
|---|---|
jiraya repo list | Lista os repositórios do workspace. |
jiraya repo add <url>... | Adiciona repositórios. Aceita --description para uma única URL. |
jiraya repo remove <url>... | Remove repositórios do workspace. |
jiraya repo property list <repo> | Lista as propriedades preenchidas de um repositório. |
jiraya repo property set <repo> --name <propriedade> --value <valor> | Preenche uma propriedade. |
jiraya repo property unset <repo> --name <propriedade> | Limpa uma propriedade. |
jiraya repo checkout <url> | Usado pelos agentes nas execuções para buscar o código. |
Atualizado em