Integrando um projeto com um repositório Git

Conecte um projeto a um repositório Git para salvar configurações lá. Ao fazer isso, você pode usar seu repositório e as ferramentas de CI e CD de sua escolha para automatizar pipelines em configurações em um projeto.

Este é um recurso experimental que está disponível para fins de avaliação e teste e pode mudar sem aviso prévio.

Pipelines e cadeias de ferramentas são personalizáveis, então você pode automatizar muitas ações entre seu repositório Git e seu projeto usando métodos de API de projetos ou comandos CLI. Por exemplo, você pode criar um pipeline para acionar uma atualização no seu projeto quando as alterações de configuração forem mescladas na ramificação principal do seu repositório. Para obter mais informações, consulte Automatizando ações de projetos no seu repositório Git.

Em um projeto, rascunhos de configurações podem ser salvos em qualquer ramificação do seu repositório. No entanto, você pode validar e implantar configurações de rascunho somente depois que elas forem mescladas à ramificação no seu repositório que gerencia seus pipelines de CD. Você também deve sincronizar as atualizações do seu repositório no seu projeto atualizando as configurações antes de poder validar e implantar essas configurações. Você pode automatizar essa atualização usando o método de API project.config.update ou o comando CLI ibmcloud project config-update.

Antes de Iniciar

  1. Certifique-se de ter a função de Editor no serviço de Projetos do IBM Cloud para gerenciar integrações de repositórios Git.

  2. Salve um token de acesso como um segredo para se conectar ao seu repositório Git. O token de acesso precisa de acesso de gravação às ramificações que você deseja usar e para criar confirmações no seu repositório. O token de acesso também precisa da capacidade de listar ramificações e lê-las.

    1. Crie uma instância de serviço Secrets Manager na sua conta IBM Cloud. Para criar um segredo, você deve ter a função Writer ou superior no serviço Secrets Manager.

    2. Depois de criar sua instância secreta, certifique-se de selecionar Outro tipo de segredo para adicionar um segredo arbitrário. Para obter informações sobre como criar um segredo arbitrário, consulte Criando segredos arbitrários na interface do usuário. Seu segredo arbitrário deve conter o token de acesso para seu repositório Git.

Conexão de um projeto a um repositório Git

Conecte seu repositório Git ao seu projeto. Ao fazer isso, as alterações de configuração são salvas no seu repositório, e não no arquivo JSON do projeto. Como seu projeto precisa salvar configurações em seu repositório, você deve fornecer um token de acesso para autenticação no repositório a partir do seu projeto.

  1. No console IBM Cloud, clique no ícone do menu de navegação Ícone do menu de navegação > Projetos e selecione um projeto.
  2. Na guia Gerenciar, selecione Integrações.
  3. Na seção Integração do repositório Git, clique em Conectar.
  4. No menu Tipo de repositório, selecione o tipo de repositório que você deseja usar para gerenciar suas configurações. Normalmente, esse repositório é o que você usa para gerenciar seus pipelines e cadeias de ferramentas. Você pode selecionar GitHub, GitLab ou GitHub Enterprise.
  5. Digite o endereço URL para o repositório.
  6. Opcionalmente, especifique uma pasta dentro do repositório. Considere especificar uma pasta se quiser integrar seu repositório com vários projetos. Cada projeto pode ter sua própria pasta.
  7. Passe o mouse ou clique no campo do token de acesso e, em seguida, clique no ícone Segredos Ícone de chave para selecionar o segredo que contém seu token de acesso.
  8. Se o seu projeto já contiver configurações, selecione Copiar arquivos de configuração existentes para este repositório para salvar as configurações existentes no seu repositório.
  9. Clique em Salvar.

Próximas etapas

Agora que seu repositório Git está conectado ao seu projeto, você está pronto para personalizar pipelines e cadeias de ferramentas. Para aprender a criar um pipeline que atualiza automaticamente as configurações no seu projeto quando as alterações são mescladas na sua ramificação principal, consulte Automatizando ações de projetos no seu repositório Git.