GitLab

kodine'u GitLab sorunlarında ve birleştirme isteklerinde çalıştırın.

kodine, GitLab iş akışınıza iki yolla bağlanır: GitLab CI/CD hattınız üzerinden ya da GitLab Duo aracılığıyla.

Her iki senaryoda da kodine sizin GitLab çalıştırıcılarınızın üzerinde çalışır.

GitLab CI

kodine sıradan bir GitLab pipeline’ı içinde çalıştırılabilir. Bunun için onu bir CI component olarak hattınıza dahil edebilirsiniz.

Bu bölümde topluluk tarafından geliştirilen bir CI/CD bileşeninden yararlanıyoruz — nagyv/gitlab-kodine.

Özellikler

İş başına özel komutlar: kodine’un belirli parçalarını açıp kapatmak için özel bir yapılandırma dizini kullanın; örneğin ./config/#custom-directory.
Asgari kurulum: CI bileşeni kodine kurulumunu arka planda halleder; sizin yapmanız gereken yalnızca kodine yapılandırmasını ve ilk istemi hazırlamaktır.
Esnek yapı: CI bileşeni, davranışı uyarlamanıza yarayan çeşitli girdileri destekler.

Kurulum

kodine kimlik doğrulama JSON’unuzu Ayarlar > CI/CD > Değişkenler altında Dosya türünde bir CI değişkeni olarak kaydedin. “Maskeli ve gizli” seçeneğini işaretlemeyi unutmayın.

Aşağıdaki içeriği .gitlab-ci.yml dosyanıza ekleyin.

include:
  - component: $CI_SERVER_FQDN/nagyv/gitlab-kodine/kodine@2
    inputs:
      config_dir: ${CI_PROJECT_DIR}/kodine-config
      auth_json: $KODINE_AUTH_JSON # Kodine kimlik doğrulama JSON'unuzu tutan değişkenin adı
      command: optional-custom-command
      message: "Your prompt here"

Bu bileşenin diğer girdileri ve kullanım senaryoları için dokümanına göz atın.

GitLab Duo

kodine, GitLab iş akışınıza entegre olur. Bir yorumda @kodine yazmanız yeterli; kodine görevi GitLab CI hattınız üzerinde yürütür.

Özellikler

Sorunları sınıflandırın: kodine’dan bir sorunu incelemesini ve size özetlemesini isteyebilirsiniz.
Düzeltme ve geliştirme: kodine’dan bir hatayı gidermesini ya da bir özelliği hayata geçirmesini isteyin. Yeni bir dal açar ve değişiklikleri içeren bir birleştirme isteği oluşturur.
Güvenli çalışma: kodine tamamen sizin GitLab çalıştırıcılarınızda yürütülür.

Yapılandırma

kodine, GitLab CI/CD hattınızda çalışır. Kurulum için aşağıdakilere ihtiyacınız olacak:

GitLab ortamınızı hazırlayın
CI/CD’yi kurun
Bir AI model sağlayıcısına ait API anahtarını tanımlayın
Bir servis hesabı oluşturun
CI/CD değişkenlerini ayarlayın

Bir akış yapılandırma dosyası oluşturun; örnek aşağıda:

Akış yapılandırması

image: node:22-slim
commands:
  - echo "Installing kodine"
  - npm install --global kodine-ai
  - echo "Installing glab"
  - export GITLAB_TOKEN=$GITLAB_TOKEN_KODINE
  - 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 Kodine auth configuration"
  - mkdir --parents ~/.local/share/kodine
  - |
    cat > ~/.local/share/kodine/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 "Kodine"
  - echo "Testing glab"
  - glab issue list
  - echo "Running Kodine"
  - |
    kodine 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_KODINE
  - GITLAB_HOST

Ayrıntılı yönergeler için GitLab CLI agent dokümanlarına başvurabilirsiniz.

Örnekler

kodine’u GitLab’da nasıl kullanabileceğinize dair birkaç örnek aşağıda.

Bir sorunu açıklatma

GitLab’daki soruna şu yorumu ekleyin.
```
@kodine explain this issue
```
kodine konuyu okur ve net bir açıklamayla geri döner.
Bir sorunu düzeltme

Bir GitLab sorununa şunu yazın:
```
@kodine fix this
```
kodine yeni bir dal oluşturur, değişiklikleri uygular ve bunları içeren bir birleştirme isteği açar.
Birleştirme isteklerini inceleme

Bir GitLab birleştirme isteğine şu yorumu bırakın.
```
@kodine review this merge request
```
kodine birleştirme isteğini inceler ve geri bildirimini paylaşır.