GitLab

OpenCode는 GitLab CI/CD 파이프라인 또는 GitLab Duo를 통해 GitLab 워크플로우와 통합됩니다.

두 경우 모두 OpenCode는 사용자의 GitLab 러너에서 실행됩니다.

GitLab CI

OpenCode는 일반 GitLab 파이프라인에서 동작합니다. CI 컴포넌트로 파이프라인에 포함할 수 있습니다.

여기서는 OpenCode를 위한 커뮤니티 제작 CI/CD 컴포넌트인 nagyv/gitlab-opencode를 사용합니다.

기능

작업별 사용자 정의 설정 사용: 사용자 정의 설정 디렉터리(예: ./config/#custom-directory)로 OpenCode를 구성해 호출별로 기능을 활성화하거나 비활성화할 수 있습니다.
간단한 설정: CI 컴포넌트가 OpenCode를 백그라운드에서 설정하므로 OpenCode 설정과 초기 프롬프트만 만들면 됩니다.
유연성: CI 컴포넌트는 동작을 사용자 정의할 수 있는 여러 입력을 지원합니다.

설정

OpenCode 인증 JSON을 Settings > CI/CD > Variables 아래에 File 형식 CI 환경 변수로 저장하세요. “Masked and hidden”으로 표시되어 있는지 확인하세요.

.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 # OpenCode 인증 JSON의 변수 이름
      command: optional-custom-command
      message: "여기에 프롬프트를 입력하세요"

추가 입력과 사용 사례는 이 컴포넌트의 문서를 확인하세요.

GitLab Duo

OpenCode는 GitLab 워크플로우와 통합됩니다. 댓글에 @opencode를 멘션하면 OpenCode가 GitLab CI 파이프라인에서 작업을 실행합니다.

기능

이슈 분류(Triage): OpenCode에게 이슈를 살펴보고 설명해 달라고 요청하세요.
수정 및 구현: OpenCode에게 이슈를 수정하거나 기능을 구현해 달라고 요청하세요. 새 브랜치를 만들고 변경 사항이 담긴 머지 리퀘스트를 올립니다.
보안: OpenCode는 사용자의 GitLab 러너에서 실행됩니다.

설정

OpenCode는 GitLab CI/CD 파이프라인에서 실행됩니다. 설정해야 할 항목은 다음과 같습니다.

GitLab 환경 설정
CI/CD 설정
AI 모델 provider API 키 발급
서비스 계정 생성
CI/CD 변수 설정
플로우 설정 파일 생성

자세한 안내는 GitLab CLI agents 문서를 참고하세요.

예시

다음은 GitLab에서 OpenCode를 사용하는 방법의 예시입니다.

이슈 설명하기

GitLab 이슈에 다음 댓글을 추가하세요.
```
@opencode explain this issue
```
OpenCode가 이슈를 읽고 명확한 설명으로 답합니다.
이슈 수정하기

GitLab 이슈에서 다음과 같이 입력하세요.
```
@opencode fix this
```
OpenCode가 새 브랜치를 만들고, 변경 사항을 구현한 뒤, 변경 사항이 담긴 머지 리퀘스트를 엽니다.
머지 리퀘스트 리뷰

GitLab 머지 리퀘스트에 다음 댓글을 남기세요.
```
@opencode review this merge request
```
OpenCode가 머지 리퀘스트를 리뷰하고 피드백을 제공합니다.