Update MANUAL.md

This commit is contained in:
2026-06-15 04:02:03 +00:00
parent 5483092a75
commit 55da853fa8

View File

@@ -1,13 +1,13 @@
# 개발환경 사용 매뉴얼 (Coder) # 개발환경 사용 매뉴얼 (Coder)
사내 개발은 **Coder**(웹 기반 개발 워크스페이스)에서 합니다. 브라우저만 있으면 됩니다. 사내 개발은 **Coder**(웹 기반 개발 워크스페이스)에서 합니다.
DB·MinIO·AI(LiteLLM)·Git(Gitea)·배포(Coolify)가 미리 연결돼 있어, 로그인 후 바로 코딩할 수 있습니다. 브라우저만 있으면 됩니다.
이 개발환경에는 DB, MinIO, Coding Agent, git, 배포환경이 미리 연결돼 있어, 로그인 후 바로 이용할 수 있습니다.
--- ---
## 0. 준비물 ## 0. 준비물
- 사내망에서 접속 가능한 브라우저 (Chrome/Edge 권장) - 인터넷 접속 가능한 브라우저 (Chrome/Edge 권장)
- 본인 사번
### 주소(URL) 한눈에 ### 주소(URL) 한눈에
@@ -29,9 +29,9 @@ DB·MinIO·AI(LiteLLM)·Git(Gitea)·배포(Coolify)가 미리 연결돼 있어,
1. 브라우저에서 **https://coder.bokdev.in** 접속 1. 브라우저에서 **https://coder.bokdev.in** 접속
2. 로그인 2. 로그인
- **Username**: 본인 번 (예: `0310700`) - **Username**: 본인 번 (예: `2610700`)
- **Password**: `bok1234!!` + 본인 사번 (예: `bok1234!!0310700`) - **Password**: `bok1234!!` + 본인 사번 (예: `bok1234!!2610700`)
- > 최초 로그인 후 비밀번호를 바꾸는 것을 권장합니다. (우측 상단 계정 메뉴 → Account) - > 최초 로그인 후 비밀번호를 바꾸시기 바랍니다. (우측 상단 계정 메뉴 → Account)
--- ---
@@ -42,18 +42,19 @@ DB·MinIO·AI(LiteLLM)·Git(Gitea)·배포(Coolify)가 미리 연결돼 있어,
1. 로그인하면 **Workspaces** 화면. **`Create Workspace`** 클릭 (또는 **Templates → `aidev`** 선택) 1. 로그인하면 **Workspaces** 화면. **`Create Workspace`** 클릭 (또는 **Templates → `aidev`** 선택)
2. 설정값 입력 2. 설정값 입력
- **Name**: 워크스페이스 이름 (예: `ws-aidev-<사번>` 또는 자유롭게) - **Name**: 워크스페이스 이름 (예: `ws-aidev-<사번>` 또는 자유롭게)
- **External Authentication** : Gitea(그대로 둠)
- **CPU / Memory / Home disk size**: 기본값(2 Core / 4 GiB / 10 GiB)으로 두면 됩니다. 필요하면 나중에 늘릴 수 있습니다. - **CPU / Memory / Home disk size**: 기본값(2 Core / 4 GiB / 10 GiB)으로 두면 됩니다. 필요하면 나중에 늘릴 수 있습니다.
3. **`Create Workspace`** 클릭 3. **`Create Workspace`** 클릭
4. 워크스페이스가 빌드됩니다 (**처음엔 이미지 다운로드로 2~5분** 걸릴 수 있습니다. 기다리세요). 4. 워크스페이스가 빌드됩니다 (**처음엔 이미지 다운로드로 2~5분** 걸릴 수 있습니다. 오래 걸리거나 기대한 시간보다 오래 걸린다는 경고 메시지가 나와도 VS Code Web 까지 아이콘이 표시될 때까지 기다리세요).
- 상태가 **Running** 이 되면 준비 완료. - 상태가 **Running** 이 되면 준비 완료.
> 번 만들면 계속 사용합니다. 다음부터는 만들 필요 없이 **Start** 만 누르면 됩니다. > 이 워크스페이스는 한번 만들면 계속 사용합니다. 한번 만들어진 워크스페이스는 가상 PC처럼 **Start** 만 누르면 됩니다.
--- ---
## 3. VS Code 열기 ## 3. VS Code 열기
1. 워크스페이스 화면에서 **`VS Code Web`** 버튼 클릭 1. 워크스페이스 화면에서 **`VS Code Web`** 버튼(두번째 아이콘) 클릭
2. 브라우저에 VS Code가 열리고, 자동으로 **`/home/coder/projects`** 폴더가 열립니다. 2. 브라우저에 VS Code가 열리고, 자동으로 **`/home/coder/projects`** 폴더가 열립니다.
3. 그 안에 **`sample`** 폴더가 이미 있습니다 — 참조용 예제입니다(직접 고치지 말고 복사해 쓰세요, 7번 참고). 3. 그 안에 **`sample`** 폴더가 이미 있습니다 — 참조용 예제입니다(직접 고치지 말고 복사해 쓰세요, 7번 참고).