Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
74 changes: 37 additions & 37 deletions packages/web/src/content/docs/ko/gitlab.mdx
Original file line number Diff line number Diff line change
@@ -1,34 +1,34 @@
---
title: GitLab
description: GitLab 이슈 및 머지 리퀘스트에서 opencode를 사용하세요.
description: GitLab 이슈와 merge request에서 OpenCode를 사용하세요.
---

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

두 경우, opencode는 GitLab runners에서 실행됩니다.
두 경우 모두 OpenCode는 GitLab runner에서 실행됩니다.

---

# GitLab CI 소개
## GitLab CI

opencode는 일반 GitLab 파이프라인에서 작동합니다. [CI 컴포넌트](https://docs.gitlab.com/ee/ci/components/)로 파이프라인에 구축할 수 있습니다.
OpenCode는 일반 GitLab 파이프라인에서 작동합니다. [CI component](https://docs.gitlab.com/ee/ci/components/)로 파이프라인에 통합할 수 있습니다.

여기에서 우리는 opencode에 대한 커뮤니티 생성 CI / CD 구성품을 사용하고 있습니다. [nagyv/gitlab-opencode](https://gitlab.com/nagyv/gitlab-opencode).
여기서는 OpenCode용 커뮤니티 제작 CI/CD component인 [nagyv/gitlab-opencode](https://gitlab.com/nagyv/gitlab-opencode)를 사용합니다.

---

### 기능

- **실행별 사용자 지정 구성 사용**: 사용자 정의 구성 디렉토리와 opencode 구성, 예를 들어 `./config/#custom-directory`는 opencode 실행마다 활성화하거나 비활성화 할 수 있습니다.
- ** 최소 설정**: CI 구성 요소는 opencode를 배경으로 설정하면 opencode 구성과 초기 프롬프트를 만들 필요가 있습니다.
- **Flexible**: CI 구성 요소는 여러 입력을 지원합니다.
- **job별 custom config 사용**: custom config 디렉터리(예: `./config/#custom-directory`)를 사용해 OpenCode를 각 실행 단위로 설정하고 기능을 켜거나 끌 수 있습니다.
- **최소 설정**: CI component가 백그라운드에서 OpenCode를 설정하므로 OpenCode config와 초기 prompt만 만들면 됩니다.
- **유연함**: CI component는 동작을 사용자화할 수 있도록 여러 입력값을 지원합니다.

---

## 설정
### Setup

1. opencode 인증 JSON을 **Settings** > **CI/CD** > **Variables**에서 파일 유형 CI 환경 변수로 저장하십시오. "Masked and hidden"로 표시하십시오.
2. `.gitlab-ci.yml` 파일에 뒤에 추가하십시오.
1. OpenCode 인증 JSON을 **Settings** > **CI/CD** > **Variables** 아래의 File 타입 CI 환경 변수로 저장하세요. 반드시 "Masked and hidden"으로 표시하세요.
2. 아래 내용을 `.gitlab-ci.yml` 파일에 추가하세요.

```yaml title=".gitlab-ci.yml"
include:
Expand All @@ -40,40 +40,40 @@ opencode는 일반 GitLab 파이프라인에서 작동합니다. [CI 컴포넌
message: "Your prompt here"
```

더 많은 입력 및 사용 사례 [docs를 체크 아웃](https://gitlab.com/explore/catalog/nagyv/gitlab-opencode) 이 구성 요소에 대한.
더 많은 입력값과 사용 사례는 이 component의 [docs](https://gitlab.com/explore/catalog/nagyv/gitlab-opencode)에서 확인하세요.

---

## GitLab Duo

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

---

### 기능

- **이슈**: opencode가 문제점을 보고 당신을 설명합니다.
- **수정 및 구현**: 이슈를 수정하거나 기능을 구현하려면 opencode에 문의하십시오.
새로운 지점을 만들고 변화를 병합 요청을 제기합니다.
- **보안**: opencode는 GitLab runners에서 실행됩니다.
- **이슈 분류**: OpenCode에 이슈를 살펴보고 설명해 달라고 요청할 수 있습니다.
- **수정 및 구현**: OpenCode에 이슈를 수정하거나 기능을 구현해 달라고 요청할 수 있습니다.
OpenCode는 새 브랜치를 만들고 변경 사항이 담긴 merge request를 생성합니다.
- **보안**: OpenCode는 GitLab runner에서 실행됩니다.

---

## 설정
### Setup

opencode는 GitLab CI/CD 파이프라인에서 실행되며, 여기서 설정해야 할 일은 다음과 같습니다.
OpenCode는 GitLab CI/CD 파이프라인에서 실행되며, 설정에 필요한 항목은 다음과 같습니다.

:::tip
[**GitLab docs**](https://docs.gitlab.com/user/duo agent platform/agent assistant/) 를 체크 아웃하십시오.
[최신 안내는 **GitLab docs**](https://docs.gitlab.com/user/duo_agent_platform/agent_assistant/)를 확인하세요.
:::

1. GitLab 환경 설정
2. CI/CD 설치
3. AI 모형 공급자 API 열쇠를 얻으십시오
4. 서비스 계정 만들기
5. CI/CD 변수 구성
6. Flow config 파일을 만들려면 다음과 같습니다.
1. GitLab 환경을 설정합니다.
2. CI/CD를 설정합니다.
3. AI model provider API 키를 준비합니다.
4. 서비스 계정을 생성합니다.
5. CI/CD 변수를 설정합니다.
6. flow config 파일을 생성합니다. 예시는 다음과 같습니다.

<details>

Expand Down Expand Up @@ -152,44 +152,44 @@ opencode는 GitLab CI/CD 파이프라인에서 실행되며, 여기서 설정해

</details>

자세한 지침에 대한 [GitLab CLI Agent docs](https://docs.gitlab.com/user/duo agent platform/agent assistant/)를 참조할 수 있습니다.
[GitLab CLI agents docs](https://docs.gitlab.com/user/duo_agent_platform/agent_assistant/)에서 자세한 안내를 확인할 수 있습니다.

---

### 예제

다음은 GitLab에서 opencode를 사용할 수있는 몇 가지 예입니다.
다음은 GitLab에서 OpenCode를 사용하는 몇 가지 예시입니다.

:::tip
`@opencode`보다 다른 트리거 구문을 사용할 수 있습니다.
`@opencode` 대신 다른 trigger phrase를 사용하도록 설정할 수 있습니다.
:::

- **이슈 설명**

GitLab 문제에서이 코멘트를 추가하십시오.
GitLab 이슈에 아래 댓글을 남기세요.

```
@opencode explain this issue
```

opencode는 문제와 대답을 명확하게 설명합니다.
OpenCode가 이슈를 읽고 명확한 설명으로 답변합니다.

- **이슈 해결**

GitLab 문제에서, 말한다:
GitLab 이슈에서 다음과 같이 요청하세요.

```
@opencode fix this
```

opencode는 새로운 지점을 만들 것이며 변경 사항을 구현하고 변경 사항을 병합 요청을 엽니다.
OpenCode가 새 브랜치를 만들고 변경 사항을 구현한 뒤, 해당 변경 사항으로 merge request를 엽니다.

- **머지 리퀘스트 검토**

GitLab 병합 요청에 대한 다음 의견을 남겨주세요.
GitLab merge request에 아래 댓글을 남기세요.

```
@opencode review this merge request
```

opencode는 병합 요청을 검토하고 피드백을 제공합니다.
OpenCode가 merge request를 검토하고 피드백을 제공합니다.
41 changes: 21 additions & 20 deletions packages/web/src/content/docs/ko/ide.mdx
Original file line number Diff line number Diff line change
@@ -1,47 +1,48 @@
---
title: IDE
description: VS Code, Cursor 및 기타 IDE용 opencode 확장 프로그램.
description: VS Code, Cursor 및 기타 IDE용 OpenCode 확장 프로그램
---

opencode는 VS Code, Cursor, 또는 터미널을 지원하는 IDE와 통합됩니다. 시작하려면 terminal에서 `opencode`를 실행하십시오.
OpenCode는 VS Code, Cursor, 또는 터미널을 지원하는 모든 IDE와 통합됩니다. 시작하려면 터미널에서 `opencode`를 실행하세요.

---

## 사용법

-**Quick Launch**: `Cmd+Esc` (Mac) 또는 `Ctrl+Esc` (Windows/Linux)를 사용하여 통합 터미널 뷰에 opencode를 열거나 기존 terminal 세션을 이미 실행하면 됩니다. -**New Session**: `Cmd+Shift+Esc` (Mac) 또는 `Ctrl+Shift+Esc` (Windows/Linux)를 사용하여 새로운 opencode terminal 세션을 시작하려면 이미 열리면 됩니다. UI에서 opencode 버튼을 클릭합니다. -**Context Awareness**: opencode로 현재 선택 또는 탭을 자동으로 공유합니다.

- **파일 참조 단축키** : 파일 참조를 삽입하려면 `Cmd+Option+K` (Mac) 또는 `Alt+Ctrl+K` (Linux / Windows)를 사용하십시오. 예를 들어, `@File#L37-42`.
- **Quick Launch**: `Cmd+Esc` (Mac) 또는 `Ctrl+Esc` (Windows/Linux)를 사용해 분할 터미널 뷰에서 OpenCode를 열거나, 이미 실행 중인 터미널 세션으로 포커스하세요.
- **New Session**: `Cmd+Shift+Esc` (Mac) 또는 `Ctrl+Shift+Esc` (Windows/Linux)를 사용해 기존 세션이 열려 있어도 새 OpenCode 터미널 세션을 시작하세요. UI의 OpenCode 버튼을 클릭해도 됩니다.
- **Context Awareness**: 현재 선택 영역이나 탭을 OpenCode와 자동으로 공유합니다.
- **File Reference Shortcuts**: `Cmd+Option+K` (Mac) 또는 `Alt+Ctrl+K` (Linux/Windows)를 사용해 파일 참조를 삽입하세요. 예: `@File#L37-42`.

---

## 설치

VS Code에 opencode를 설치하고 Cursor, Windsurf, VSCodium과 같은 인기있는 포크 :
VS Code와 Cursor, Windsurf, VSCodium 같은 인기 포크에 OpenCode를 설치하려면:

1. VS Code 열기
2. 통합 terminal을 여십시오
3. 실행 `opencode` - 확장 자동으로 설치
1. VS Code를 여세요.4
2. 통합 터미널을 여세요.
3. `opencode`를 실행하세요. 확장 프로그램이 자동으로 설치됩니다.

반면에 TUI에서 `/editor` 또는 `/export`를 실행할 때, 당신은 `export EDITOR="code --wait"`를 설정할 필요가 있을 것입니다. [Learn more](/docs/tui/#editor-setup).
반면 TUI에서 `/editor` 또는 `/export`를 실행할 때 자체 IDE를 사용하려면 `export EDITOR="code --wait"`를 설정해야 합니다. [자세히 알아보기](/docs/tui/#editor-setup).

---

## 수동 설치
### 수동 설치

확장 마켓 플레이스에서 **opencode**를 검색하고 **Install**를 클릭합니다.
Extension Marketplace에서 **OpenCode**를 검색한 다음 **Install**을 클릭하세요.

---

### 문제 해결

확장이 자동으로 설치되지 않는 경우:

- 통합 terminal에서 `opencode`를 실행하는 것을 보장합니다.
- IDE용 CLI가 설치됩니다.
- VS Code : `code` 명령
- 커서: `cursor` 명령
- 윈드 서핑을 위해: `windsurf` 명령
- VSCodium의 경우: `codium` 명령
- 만약 `Cmd+Shift+P` (Mac) 또는 `Ctrl+Shift+P` (Windows/Linux)를 실행하고 "Shell Command: PATH"에서 'code' 명령을 설치하십시오 (또는 IDE에 해당)
- Ensure VS Code는 확장을 설치하는 권한이 있습니다.
- 통합 터미널에서 `opencode`를 실행하고 있는지 확인하세요.
- IDE용 CLI가 설치되어 있는지 확인하세요.
- VS Code: `code` command
- Cursor: `cursor` command
- Windsurf: `windsurf` command
- VSCodium: `codium` command
- 설치되어 있지 않다면 `Cmd+Shift+P` (Mac) 또는 `Ctrl+Shift+P` (Windows/Linux)를 실행하고 "Shell Command: Install 'code' command in PATH"(또는 IDE에 맞는 동등한 명령)를 검색하세요.
- VS Code에 확장 프로그램 설치 권한이 있는지 확인하세요.
Loading
Loading