GitLab

Usa OpenCode nelle issue e nelle merge request di GitLab.

OpenCode si integra con il tuo flusso di lavoro GitLab attraverso la tua pipeline CI/CD GitLab o con GitLab Duo.

In entrambi i casi, OpenCode verrà eseguito sui runner GitLab.

GitLab CI

OpenCode funziona in una pipeline GitLab regolare. Puoi integrarlo in una pipeline come un componente CI

Qui stiamo usando un componente CI/CD creato dalla comunità per OpenCode - nagyv/gitlab-opencode.

Caratteristiche

Usa configurazione personalizzata per lavoro: Configura OpenCode con una directory di configurazione personalizzata, ad esempio ./config/#custom-directory per abilitare o disabilitare funzionalità per invocazione OpenCode.
Configurazione minima: Il componente CI configura OpenCode in background, devi solo creare la configurazione OpenCode e il prompt iniziale.
Flessibile: Il componente CI supporta diversi input per personalizzare il suo comportamento

Configurazione

Archivia il tuo JSON di autenticazione OpenCode come variabile d’ambiente CI di tipo File sotto Impostazioni > CI/CD > Variabili. Assicurati di contrassegnarle come “Mascherato e nascosto”.

Aggiungi quanto segue al tuo file .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 # Il nome della variabile per il tuo JSON di autenticazione OpenCode
      command: optional-custom-command
      message: "Your prompt here"

Per più input e casi d’uso consulta la documentazione per questo componente.

GitLab Duo

OpenCode si integra con il tuo flusso di lavoro GitLab. Menziona @opencode in un commento, e OpenCode eseguirà attività all’interno della tua pipeline CI GitLab.

Caratteristiche

Triaging delle issue: Chiedi a OpenCode di esaminare una issue e spiegartela.
Correggere e implementare: Chiedi a OpenCode di correggere una issue o implementare una funzionalità. Lavorerà per creare un nuovo ramo e solleverà una merge request con le modifiche.
Sicuro: OpenCode viene eseguito sui runner GitLab.

Configurazione

OpenCode viene eseguito nella tua pipeline CI/CD GitLab, ecco cosa ti servirà per configurarlo:

Configura il tuo ambiente GitLab
Configura CI/CD
Ottieni una chiave API del fornitore di modelli AI
Crea un account di servizio
Configura le variabili CI/CD

Crea un file di configurazione del flusso, ecco un esempio:

Configurazione del flusso

image: node:22-slim
commands:
  - echo "Installing opencode"
  - npm install --global opencode-ai
  - echo "Installing 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 "Configuring glab"
  - echo $GITLAB_HOST
  - echo "Creating OpenCode auth configuration"
  - mkdir --parents ~/.local/share/opencode
  - |
    cat > ~/.local/share/opencode/auth.json << EOF
    {
      "anthropic": {
        "type": "api",
        "key": "$ANTHROPIC_API_KEY"
      }
    }
    EOF
  - echo "Configuring git"
  - git config --global user.email "[email protected]"
  - git config --global user.name "OpenCode"
  - echo "Testing glab"
  - glab issue list
  - echo "Running OpenCode"
  - |
    opencode run "
    You are an AI assistant helping with GitLab operations.

    Context: $AI_FLOW_CONTEXT
    Task: $AI_FLOW_INPUT
    Event: $AI_FLOW_EVENT

    Please execute the requested task using the available GitLab tools.
    Be thorough in your analysis and provide clear explanations.

    <important>
    Please use the glab CLI to access data from GitLab. The glab CLI has already been authenticated. You can run the corresponding commands.

    If you are asked to summarize an MR or issue or asked to provide more information then please post back a note to the MR/Issue so that the user can see it.
    You don't need to commit or push up changes, those will be done automatically based on the file changes you make.
    </important>
    "
  - git checkout --branch $CI_WORKLOAD_REF origin/$CI_WORKLOAD_REF
  - echo "Checking for git changes and pushing if any exist"
  - |
    if ! git diff --quiet || ! git diff --cached --quiet || [ --not --zero "$(git ls-files --others --exclude-standard)" ]; then
      echo "Git changes detected, adding and pushing..."
      git add .
      if git diff --cached --quiet; then
        echo "No staged changes to commit"
      else
        echo "Committing changes to branch: $CI_WORKLOAD_REF"
        git commit --message "Codex changes"
        echo "Pushing changes up to $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 "Changes successfully pushed"
      fi
    else
      echo "No git changes detected, skipping push"
    fi
variables:
  - ANTHROPIC_API_KEY
  - GITLAB_TOKEN_OPENCODE
  - GITLAB_HOST

Puoi fare riferimento alla documentazione degli agenti CLI GitLab per istruzioni dettagliate.

Esempi

Ecco alcuni esempi di come puoi usare OpenCode in GitLab.

Spiegare una issue

Aggiungi questo commento in una issue GitLab.
```
@opencode explain this issue
```
OpenCode leggerà l’issue e risponderà con una spiegazione chiara.
Correggere una issue

In una issue GitLab, di’:
```
@opencode fix this
```
OpenCode creerà un nuovo ramo, implementerà le modifiche e aprirà una merge request con le modifiche.
Revisionare le merge request

Lascia il seguente commento su una merge request GitLab.
```
@opencode review this merge request
```
OpenCode revisionerà la merge request e fornirà feedback.