Pular para o conteúdo
Issues e projetos

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:

bash
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.
bash
jiraya repo property set git@github.com:acme/loja.git --name Ambiente --value Produção

Definir 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çãoRepositórios disponíveis
Tarefa num projeto com repositórios anexadosSó os repositórios do projeto.
Tarefa num projeto sem repositórios, ou sem projetoOs 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

ComandoO que faz
jiraya repo listLista 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

Nesta página