GitLab

Use o opencode em problemas e solicitações de mesclagem do GitLab.

O opencode se integra ao seu fluxo de trabalho do GitLab através do seu pipeline CI/CD do GitLab ou com o GitLab Duo.

Em ambos os casos, o opencode será executado em seus runners do GitLab.

GitLab CI

O opencode funciona em um pipeline regular do GitLab. Você pode integrá-lo a um pipeline como um componente CI

Aqui estamos usando um componente CI/CD criado pela comunidade para opencode — nagyv/gitlab-opencode.

Recursos

Use configuração personalizada por trabalho: Configure o opencode com um diretório de configuração personalizado, por exemplo ./config/#custom-directory para habilitar ou desabilitar funcionalidades por invocação do opencode.
Configuração mínima: O componente CI configura o opencode em segundo plano, você só precisa criar a configuração do opencode e o prompt inicial.
Flexível: O componente CI suporta várias entradas para personalizar seu comportamento.

Configuração

Armazene seu JSON de autenticação do opencode como variáveis de ambiente do tipo File em Configurações > CI/CD > Variáveis. Certifique-se de marcá-las como “Mascaradas e ocultas”.

Adicione o seguinte ao seu arquivo .gitlab-ci.yml.

include:
  - component: $CI_SERVER_FQDN/nagyv/gitlab-opencode/opencode@2
    inputs:
      config_dir: ${CI_PROJECT_DIR}/opencode-config
      auth_json: $OPENCODE_AUTH_JSON # O nome da variável para seu JSON de autenticação do OpenCode
      command: optional-custom-command
      message: "Seu prompt aqui"

Para mais entradas e casos de uso consulte a documentação deste componente.

GitLab Duo

O opencode se integra ao seu fluxo de trabalho do GitLab. Mencione @opencode em um comentário, e o opencode executará tarefas dentro do seu pipeline CI do GitLab.

Recursos

Triagem de problemas: Peça ao opencode para analisar um problema e explicá-lo para você.
Corrigir e implementar: Peça ao opencode para corrigir um problema ou implementar uma funcionalidade. Ele criará um novo branch e abrirá uma solicitação de mesclagem com as alterações.
Seguro: O opencode é executado em seus runners do GitLab.

Configuração

O opencode é executado em seu pipeline CI/CD do GitLab, aqui está o que você precisará para configurá-lo:

Configure seu ambiente GitLab
Configure CI/CD
Obtenha uma chave de API do provedor de modelo de IA
Crie uma conta de serviço
Configure variáveis de CI/CD

Crie um arquivo de configuração de fluxo, aqui está um exemplo:

Configuração de fluxo

image: node:22-slim
commands:
  - echo "Instalando opencode"
  - npm install --global opencode-ai
  - echo "Instalando glab"
  - export GITLAB_TOKEN=$GITLAB_TOKEN_OPENCODE
  - apt-get update --quiet && apt-get install --yes curl wget gpg git && rm --recursive --force /var/lib/apt/lists/*
  - curl --silent --show-error --location "https://raw.githubusercontent.com/upciti/wakemeops/main/assets/install_repository" | bash
  - apt-get install --yes glab
  - echo "Configurando glab"
  - echo $GITLAB_HOST
  - echo "Criando configuração de auth do OpenCode"
  - mkdir --parents ~/.local/share/opencode
  - |
    cat > ~/.local/share/opencode/auth.json << EOF
    {
      "anthropic": {
        "type": "api",
        "key": "$ANTHROPIC_API_KEY"
      }
    }
    EOF
  - echo "Configurando git"
  - git config --global user.email "opencode@gitlab.com"
  - git config --global user.name "OpenCode"
  - echo "Testando glab"
  - glab issue list
  - echo "Executando OpenCode"
  - |
    opencode run "
    Você é um assistente de IA ajudando com operações do GitLab.

    Contexto: $AI_FLOW_CONTEXT
    Tarefa: $AI_FLOW_INPUT
    Evento: $AI_FLOW_EVENT

    Por favor, execute a tarefa solicitada usando as ferramentas disponíveis do GitLab.
    Seja minucioso em sua análise e forneça explicações claras.

    <important>
    Por favor, use a CLI glab para acessar dados do GitLab. A CLI glab já foi autenticada. Você pode executar os comandos correspondentes.

    Se for solicitado a resumir um MR ou problema ou solicitado a fornecer mais informações, poste uma nota de volta no MR/Problema para que o usuário possa ver.
    Você não precisa commitar ou enviar alterações, isso será feito automaticamente com base nas alterações de arquivo que você fizer.
    </important>
    "
  - git checkout --branch $CI_WORKLOAD_REF origin/$CI_WORKLOAD_REF
  - echo "Verificando alterações no git e enviando se existirem"
  - |
    if ! git diff --quiet || ! git diff --cached --quiet || [ --not --zero "$(git ls-files --others --exclude-standard)" ]; then
      echo "Alterações git detectadas, adicionando e enviando..."
      git add .
      if git diff --cached --quiet; then
        echo "Nenhuma alteração preparada para commit"
      else
        echo "Commitando alterações para o branch: $CI_WORKLOAD_REF"
        git commit --message "Codex changes"
        echo "Enviando alterações para $CI_WORKLOAD_REF"
        git push https://gitlab-ci-token:$GITLAB_TOKEN@$GITLAB_HOST/gl-demo-ultimate-dev-ai-epic-17570/test-java-project.git $CI_WORKLOAD_REF
        echo "Alterações enviadas com sucesso"
      fi
    else
      echo "Nenhuma alteração git detectada, pulando envio"
    fi
variables:
  - ANTHROPIC_API_KEY
  - GITLAB_TOKEN_OPENCODE
  - GITLAB_HOST

Você pode consultar a documentação dos agentes da CLI do GitLab para instruções detalhadas.

Exemplos

Aqui estão alguns exemplos de como você pode usar o opencode no GitLab.

Explicar um problema

Adicione este comentário em um problema do GitLab.
```
@opencode explain this issue
```
O opencode lerá o problema e responderá com uma explicação clara.
Corrigir um problema

Em um problema do GitLab, diga:
```
@opencode fix this
```
O opencode criará um novo branch, implementará as alterações e abrirá uma solicitação de mesclagem com as alterações.
Revisar solicitações de mesclagem

Deixe o seguinte comentário em uma solicitação de mesclagem do GitLab.
```
@opencode review this merge request
```
O opencode revisará a solicitação de mesclagem e fornecerá feedback.