Configurando Git Repos and Issue Tracking

DevOps Insights chegará ao fim de sua vida útil e será descontinuado em 31 de agosto de 2026. O serviço Continuous Delivery será descontinuado nas seguintes regiões em 12 de fevereiro de 2027: au-syd, ca-tor, us-east. O Code Risk Analyzer também será descontinuado em todas as regiões nessa data. Se uma região não apresentar uso ativo desses recursos, os recursos nessa região poderão ser descontinuados mais cedo e deixar de aceitar novas instâncias. Saiba mais

A Git Repos and Issue Tracking integração da ferramenta é baseada no GitLab Community Edition, que é um serviço de hospedagem na web para repositórios Git (repos). É possível ter ambas as cópias local e remota de seus repositórios. Para saber mais, consulte Git Repos and Issue Tracking.

Se você estiver configurando o Git Repos and Issue Tracking enquanto estiver criando a cadeia de ferramentas, siga estas etapas:

Na seção Integrações configuráveis, clique em Git Repos and Issue Tracking.
Revise os locais de destino padrão do repositório Git. Esses repos são clonados a partir dos mesmos repos de amostra. Se necessário, mude os nomes dos repos de destino.

Se você tiver uma cadeia de ferramentas e desejar migrar um repositório Git em sua cadeia de ferramentas para o Git Repos and Issue Tracking, siga estas etapas:

Essas instruções se aplicarão às cadeias de ferramentas que já contiverem o repositório do Git que você desejar migrar para o Git Repos and Issue Tracking. Para obter informações sobre a inclusão de tipos diferentes de repositórios Git em sua cadeia de ferramentas, consulte Configurando o GitHub e Configurando o GitLab.

No IBM Cloud console, clique no ícone Menu > Automação da plataforma > Cadeias de ferramentas. Na página Cadeias de ferramentas, clique na cadeia de ferramentas para abrir a sua página de Visão geral.
Clique em Incluir.
Na seção Integrações de ferramentas, clique em Git Repos and Issue Tracking.
Selecione o servidor no qual você deseja implementar mudanças de código. Após você criar a integração, poderá editá-la para gerenciar a lista de servidores com a qual você está autorizado a trabalhar. Clique em Gerenciar autorização para visualizar uma lista de todos os servidores e excluir o token que você forneceu para autorizar com o servidor.
Para criar uma cópia do repositório Git, para o tipo de repositório, clique em Clonar. Digite um novo nome de repositório e a URL para o repositório de origem.
O seu nome do usuário é automaticamente selecionado para designar a propriedade desta nova integração para você. Após a integração ser criada, outro usuário autorizado poderá redesignar a propriedade da integração para si mesmo ao editá-la.
Se você deseja criar um repositório privado, marque a caixa de seleção Tornar este repositório privado.
Se quiser usar o Issues para rastreamento de problemas, marque a caixa de seleção Ativar o Issues.
Se quiser rastrear a implementação de mudanças de código criando tags e comentários sobre confirmações, além de rótulos e comentários sobre problemas referenciados pelas confirmações, marque a caixa de seleção Rastrear a implementação de mudanças de código.
Clique em Criar integração.

Após clonar o repositório do Git, será possível removê-lo da sua cadeia de ferramentas.

Se você tiver uma cadeia de ferramentas e estiver incluindo o Git Repos and Issue Tracking nela, siga estas etapas:

No IBM Cloud console, clique no ícone Menu > Automação da plataforma > Cadeias de ferramentas. Na página Cadeias de ferramentas, clique na cadeia de ferramentas para abrir a sua página de Visão geral.
Clique em Incluir ferramenta.
Na seção Integrações de ferramentas, clique em Git Repos and Issue Tracking.
Selecione o servidor no qual você deseja implementar mudanças de código. Após você criar a integração, poderá editá-la para gerenciar a lista de servidores com a qual você está autorizado a trabalhar. Clique em Gerenciar autorização para visualizar uma lista de todos os servidores e excluir o token que você forneceu para autorizar com o servidor.
Selecione um tipo de repositório:

a. Para criar um repositório vazio, para o tipo de repositório, clique em Novo e digite um nome de repositório. b. Para bifurcar um repositório Git para que seja possível contribuir com as mudanças por meio de solicitações de mesclagem, para o tipo de repositório, clique em Bifurcar. Digite a URL para o repositório de origem. c. Para criar uma cópia de um repositório Git, para o tipo de repositório, clique em Clonar. Digite um novo nome de repositório e a URL para o repositório de origem. d. Se você tiver um repositório Git e desejar usá-lo, para o tipo de repositório, clique em Existente. Digite a URL para o repositório de origem.
O seu nome do usuário é automaticamente selecionado para designar a propriedade desta nova integração para você. Após a integração ser criada, outro usuário autorizado poderá redesignar a propriedade da integração para si mesmo ao editá-la.
Se você deseja criar um repositório privado, marque a caixa de seleção Tornar este repositório privado.
Se quiser usar o Issues para rastreamento de problemas, marque a caixa de seleção Ativar o Issues.
Se quiser rastrear a implementação de mudanças de código criando tags e comentários sobre confirmações, além de rótulos e comentários sobre problemas referenciados pelas confirmações, marque a caixa de seleção Rastrear a implementação de mudanças de código.
Clique em Criar integração.
Na página de visão geral da sua cadeia de ferramentas, na placa Repositórios, clique no repositório Git com o qual deseja trabalhar. Sua página de visão geral do projeto é aberta.

Se você não tiver privilégios de Principal ou de Proprietário para o repositório ao qual você está vinculando, a sua integração será limitada porque não será possível usar um webhook. Webhooks são necessários para executar automaticamente um pipeline quando uma confirmação é enviada por push para o repositório. Sem um webhook, os pipelines deverão ser iniciados manualmente.

Configurando o Git Repos and Issue Tracking por meio da API

A integração da ferramenta Git Repos and Issue Tracking suporta os seguintes parâmetros de configuração que você pode usar com a API e os SDKs do Toolchain HTTP ao criar, ler e atualizar integrações de ferramentas.

Você deve especificar a propriedade tool_type_id no corpo da solicitação com o valor hostedgit.

parâmetros de integração da ferramentaGit Repos and Issue Tracking
Parâmetro	Uso	Tipo	Argumento de Terraform	Descrição
url_raiz_da_api	opcional, atualizável	Sequência	url_raiz_da_api	O `URL` da API `Git Repos and Issue Tracking`.
token da API	opcional, atualizável	Senha	token da API	O Token de Acesso Pessoal (PAT). Esse parâmetro é necessário apenas se o `auth_type` for configurado como `pat`, caso contrário, ele será ignorado.
auth_type	opcional, atualizável, `Default: oauth`	Sequência	auth_type	Configure o método de autenticação para usar para acessar o provedor Git.
ramo padrão	opcional, atualizável	Sequência	ramo padrão	O nome do ramo padrão do repo Git.
enable_traceability	opcional, atualizável, `Default: false`	Booleano	enable_traceability	Defina este valor como “ `true` ” para acompanhar a implantação de alterações no código por meio da criação de tags, rótulos e comentários em commits, pull requests e issues referenciados.
git_id	opcional, imutável	Sequência	git_id	Configure este valor para `hostedgit` para o destino Git Repos and Issue Tracking.
has_issues	opcional, atualizável, `Default: true`	Booleano	ativado o toolchain_issues	Configure este valor para `true` para ativar problemas no repo Git Repos and Issue Tracking e adiciona uma placa de integração de ferramentas de Issues à cadeia de ferramentas. Configure este valor para `false` para remover a placa de integração de ferramentas da cadeia de ferramentas. Esta ação não impacta se as questões estão ativadas no próprio repo Git Repos and Issue Tracking.
proprietário_da_integração	opcional, atualizável	Sequência	proprietário_da_integração	Selecione o usuário que as operações Git são realizadas como.
owner_id	opcional, imutável	Sequência	owner_id	O usuário Git Repos and Issue Tracking ou grupo que possui o repo. Esse parâmetro é necessário quando você cria um repo, ou clone ou fork um repo. Este valor é computado quando você se liga a um repo existente.
repositório privado	opcional, imutável, `Default: true`	Booleano	repositório privado	Configure este valor para `true` para fazer o repo privado quando você cria um repo, ou quando clone ou fork um repo. Este parâmetro não é usado quando você se liga a um repo existente.
repo_id	opcional, imutável	Sequência	repo_id	O ID do projeto “ Git Repos and Issue Tracking ”.
repo_name	opcional, imutável	Sequência	repo_name	O nome do repositório Git Repos and Issue Tracking a ser criado. Esse parâmetro é necessário quando você cria um repo, ou clone ou fork um repo. Esse valor é computado quando você se vincula a um repo existente.
repo_url	opcional, imutável	Sequência	repo_url	O URL do repositório Git Repos and Issue Tracking para essa integração de ferramentas. Este parâmetro é necessário quando você se liga a um repo existente. Esse valor é computado quando você cria um repo, ou clone ou fork um repo.
url_do_repositório_fonte	opcional, imutável	Sequência	url_do_repositório_fonte	O endereço URL do repositório que você deseja bifurcar ou clonar. Esse parâmetro é necessário quando você forca ou clone um repo, mas ele não é usado quando você cria um repo ou link para um repo existente.
url_token	opcional, atualizável	Sequência	url_token	O token URL que é usado para autorizar com o servidor Git Repos and Issue Tracking.
tipo	necessário, imutável	Sequência	tipo	A operação para executar para inicializar a nova integração da ferramenta. Use `new` para criar um repo Git, `clone` para clonar um repo Git já existente em um novo repo Git, `fork` para fork um repo Git existente ou `link` para se vincular a um repo Git existente.

Se você estiver conectado IBM Cloud usando um Perfil Confiável, ao configurar uma Git Repos and Issue Tracking integração de ferramenta, deverá usar o método de autenticação Token de Acesso Pessoal. O método de autenticação OAuth é incompatível com a autenticação Trusted Profiles.The Personal Access Token (PAT) permite que você configure a integração da ferramenta Git Repos and Issue Tracking usando a GUI, a API ou o Terraform. Isso ocorre porque o PAT está vinculado ao usuário real que possui o perfil confiável. Os usuários podem usar seus tokens de acesso pessoal para criar ou reconfigurar as integrações da ferramenta Git Repos and Issue Tracking na cadeia de ferramentas. No entanto, eles devem fazer login como um usuário comum para acessar a interface do usuário do repositório Git real.