Gitlab

Versão mínima: Linux Control Center v2.13.X Requisitos:

• Acesso ao repositório GitLab desejado

• Token de acesso pessoal ou credenciais com permissão de leitura

• 'api', 'read_api', 'ai_features'

• Branch com scripts ou playbooks válidos (.sh, .yml, .ps1, .bat)

O que faz?

Esta funcionalidade permite importar automaticamente scripts e playbooks versionados diretamente de um repositório GitLab para o Linux Control Center. Os arquivos são baixados, validados, verificados contra o commit mais recente e mapeados como scripts personalizados na plataforma.

Como configurar

1. Acesse o módulo GitLab

• Navegue até Menu lateral → Config → Integrações → GitLab

• Clique em Criar

  

2. Preencha os dados do repositório

⚠️ URLs inválidas, tokens incorretos ou permissões insuficientes impedirão a sincronização.

Execute a Sincronização

Após salvar:

1. Clique em Sync

Escolha o modo de execução da sincronização

• Worker: Para executar em algum Worker que consiga estabelecer conexão com o repositório.

• Console: Para executar diretamente da console web que consegue estabelecer conexão com o repositório.

• Para analisar os logs da conexão da console, acesse o meu Logs na aba de detalhes do Gitlab.

1. O sistema:

   • Descobre todos os arquivos do repositório no branch escolhido

   • Verifica a extensão de cada arquivo

   • Baixa apenas arquivos com extensões permitidas

   • Calcula o hash de conteúdo para verificar alterações

   • Associa o script ao seu usuário ou ao Linux Control Center

O que será criado

• Scripts .sh, .ps1, .bat → Salvos como Custom Scripts

• Playbooks .yml → Salvos como Custom Playbooks

• Cada item importado manterá:

  • Nome baseado no repositório + branch

  • Caminho físico no container

  • Último commit de origem

  • Hash para detectar modificações futuras

Estrutura de nomeação

• 1. Nome do arquivo

• 1. URL do repositório

• 1. Branch utilizada

Reimportações automáticas

• Se um arquivo já existir:

  • Será atualizado se o hash ou commit mudar

  • Ignorado se não houver alteração

  • Estes dados podem ser verificados na opção 'Scripts' na aba de detalhes do repositório.

  

Local de Armazenamento

Os scripts são salvos em: git_integration_remote_rep/<UUID_DO_REPOSITORIO>/

Exemplos de Suporte

Logs e Diagnóstico

• Os logs de cada execução podem ser consultados no painel de GitLab da plataforma

• Incluem: erros de autenticação, arquivos ignorados, mudanças detectadas

• Erros comuns verificados são referentes a impossibilidade de conexão com repositório

• Autenticação de dois fatores (2F) exigida em login via usuário e senha

• Falta de permissões do usuário ou do token utilizado

Dúvidas?

Consulte o suporte ou a documentação oficial do Linux Control Center.