> For the complete documentation index, see [llms.txt](https://genos-docs.gitbook.io/default/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://genos-docs.gitbook.io/default/v1.9.6/basic-tutorials/guides/development/code_serving/deploy_code_serving.md).
# 코드 서빙 배포
코드 서빙은 **리비전** 단위로 배포합니다. 커밋을 골라 리비전을 만들고, 리비전 상세에서 배포를 신청한 뒤 결재를 받는 순서입니다. 이후 커밋·배포 정보를 어떻게 확인하는지도 알아보겠습니다.
### **1. 코드 서빙 상세 페이지 진입**
코드 서빙 목록에서 배포할 코드 서빙 행을 더블클릭해 상세 페이지로 들어갑니다.
### **2. 리비전 추가**
우상단 **\[+ 리비전 추가]** 버튼을 누르면 「리비전 추가」 창이 열립니다.
다음 항목을 상황에 맞게 입력하시면 됩니다.
* **도커 이미지 \***: 리비전을 실행할 도커 이미지
* **인스턴스 타입 \***: CPU · 메모리 사양
* **GPU 할당량**: GPU가 필요하면 할당량과 개수를 선택
* **복제본 \***: 동시에 띄울 컨테이너 수 (정수)
* **브랜치 \***: 배포할 커밋이 있는 브랜치 (검색·선택)
* **커밋 해시 \***: 배포할 커밋. 돋보기 아이콘으로 커밋 변경 내용을 미리 볼 수 있습니다.
창 아래 **환경 설정** 영역에서는 리비전의 실행 설정을 함께 정합니다. 「리비전을 만든 뒤에도 「환경 설정」 탭에서 바꿀 수 있습니다. 배포 중·결재 대기 중에는 바꿀 수 없습니다.」라는 안내가 함께 표시됩니다.
* **빌드 커맨드 · 시작 커맨드**: 비워 두면 언어별 기본값을 씁니다.
* **환경 변수**: 리비전에 넣을 환경 변수입니다.
* **NFS 루트 마운트**: 처음 값은 「미사용」입니다. 앱이 `/nfs-root` 경로의 파일을 읽거나 써야 하면 「사용」으로 켜세요. 자세한 내용은 [코드 서빙 생성](/default/v1.9.6/basic-tutorials/guides/development/code_serving/create_code_serving.md)의 「NFS 루트 마운트」를 참고하세요.
> 예전에 만든 코드 서빙은 코드 서빙에 저장돼 있던 커맨드 · 환경 변수가 미리 채워질 수 있습니다. NFS 루트 마운트는 같은 코드 서빙의 기존 리비전이 「사용」이어도 항상 「미사용」으로 시작합니다.
설정 예시입니다. 작성을 완료하셨으면 \[생성]을 누르고 "리비전을 생성하시겠습니까?"에 확인하면 리비전이 만들어집니다. 만들어진 리비전은 \[리비전 목록] 탭에서 확인할 수 있습니다.
> 리비전을 만든 것만으로는 배포되지 않습니다. 다음 단계에서 리비전 상세의 \[배포]로 배포를 신청해야 합니다.
### **3. 배포 신청과 결재**
\[리비전 목록] 탭에서 리비전 행을 더블클릭해 **리비전 상세**로 들어간 뒤 우상단 **\[배포]** 를 누릅니다. "배포 신청 하시겠습니까?"에 확인하면 "배포 신청이 완료 되었습니다" 안내와 함께 리비전이 승인 대기 상태가 됩니다.
* 승인 대기 중에는 \[배포] 자리에 **\[배포 취소]** 가 표시되어 신청을 거둘 수 있습니다.
* 배포된 리비전은 \[중지]로 배포 중지 결재를 신청합니다("해당 리비전의 배포 중지 결재를 신청하시겠습니까?"). 중지 승인 대기 중에는 \[중지 취소]가 표시됩니다.
결재는 결재 권한을 가진 사용자가 메뉴에서 **운영 > 결재** 로 들어가 처리합니다. 리소스 필터에서 「코드 서빙」을 고르면 코드 서빙 결재만 모아 볼 수 있습니다.
목록에서 배포를 승인하거나 반려할 수 있습니다. 반려되면 리비전 상세 \[기본 정보]에 반려 사유가 표시됩니다.
* 배포를 신청하면 그때의 빌드 · 시작 커맨드, 환경 변수, NFS 루트 마운트 값이 저장되고, 승인되면 그 값으로 배포됩니다. 승인 대기 중에는 환경 설정을 바꿀 수 없으니, 바꾸려면 \[배포 취소] 뒤 수정하고 다시 신청하세요.
* 결재 권한자는 결재 목록에서 행을 눌러 리비전 상세로 들어가, \[기본 정보] 탭에서 NFS 루트 마운트 사용 여부를 확인할 수 있습니다.
#### 배포 이력 상세
신청 때 저장된 값은 코드 서빙 상세 \[기본 정보] 탭 아래 **코드 서빙 운영 이력** > \[배포] 탭에서 볼 수 있습니다. 행의 「상세」 돋보기를 누르면 「코드 서빙 배포 이력 상세」 창이 열립니다.
* 도커 이미지 · 인스턴스 타입 · 신청 시 복제본 · GPU 할당량 · 커밋 정보와 함께 **빌드 커맨드 · 시작 커맨드 · 환경 변수 · NFS 루트 마운트** 가 신청 시점 값으로 표시됩니다.
* 숨긴(암호화된) 환경 변수 값은 「값을 숨겼습니다」로 표시됩니다.
* v1.9.6 이전에 신청한 이력은 커맨드 · NFS 루트 마운트가 「-」로 표시됩니다.
### **4. 커밋 정보 확인**
배포한 이후에는 실수로 브랜치를 삭제하시더라도 커밋 정보를 확인할 수 있습니다.
코드 스페이스에서 다음과 같이 입력하면 됩니다.
#### a. 코드 서빙 정보 확인
```python
import requests, textwrap
# === 사용자가 바꿀 값 2개 ===
BEARER_TOKEN_RAW = """
{AccessToken값}
""" # AccessToken 값을 넣으면 됩니다.
CODE_ID = 7 # git 저장소 주소를 보시면 llmops/7 이런 식으로 숫자가 있는데 숫자를 넣으면 됩니다.
# 줄바꿈/공백 제거
BEARER_TOKEN = "".join(BEARER_TOKEN_RAW.split())
BASE = "http://llmops-admin-api-service.llmops.svc.cluster.local:8080/api/admin"
url = f"{BASE}/serving/code/{CODE_ID}"
headers = {"Accept": "application/json", "Authorization": f"Bearer {BEARER_TOKEN}"}
response = requests.get(url, headers=headers, timeout=15)
print("GET", url)
print("status:", response.status_code)
print(textwrap.shorten(response.text, width=2000, placeholder=" ..."))
```
**출력 예시**
코드 서빙 리소스와 기본 메타데이터를 조회할 수 있습니다.
#### b. 배포 정보 확인
```python
import requests, textwrap
# 토큰/대상 코드서빙 ID 설정
BEARER_TOKEN_RAW = """
{accessToken 값}
""" # AccessToken 값을 넣으면 됩니다.
CODE_ID = 7 # git 저장소 주소를 보시면 llmops/7 이런 식으로 숫자가 있는데 숫자를 넣으면 됩니다.
BEARER_TOKEN = "".join(BEARER_TOKEN_RAW.split())
BASE = "http://llmops-admin-api-service.llmops.svc.cluster.local:8080/api/admin"
url = f"{BASE}/serving/code/{CODE_ID}/deployments"
headers = {"Accept": "application/json", "Authorization": f"Bearer {BEARER_TOKEN}"}
response = requests.get(url, headers=headers, timeout=15)
print("GET", url)
print("status:", response.status_code)
print(textwrap.shorten(response.text, width=2500, placeholder=" ..."))
```
**출력 예시**
배포 정보를 확인하실 수 있습니다.
#### c. 커밋 정보 확인
```python
import requests, textwrap
# 토큰/대상 코드서빙 ID 설정
BEARER_TOKEN_RAW = """
{accessToken }
""" # AccessToken 값을 넣으면 됩니다.
CODE_ID = 7 # git 저장소 주소를 보시면 llmops/7 이런 식으로 숫자가 있는데 숫자를 넣으면 됩니다.
BEARER_TOKEN = "".join(BEARER_TOKEN_RAW.split())
BASE = "http://llmops-admin-api-service.llmops.svc.cluster.local:8080/api/admin"
url = f"{BASE}/serving/code/{CODE_ID}/commits"
headers = {"Accept": "application/json", "Authorization": f"Bearer {BEARER_TOKEN}"}
# branch 를 비우면 저장소 기본 브랜치. 페이지네이션: pg(페이지 번호), pgSize(페이지당 건수)
params = {"branch": "main", "pg": 1, "pgSize": 10}
response = requests.get(url, headers=headers, params=params, timeout=15)
print("GET", url)
print("params:", params)
print("status:", response.status_code)
print(textwrap.shorten(response.text, width=2500, placeholder=" ..."))
```
**출력 예시**
위 사진과 같이 커밋 정보를 확인할 수 있습니다.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://genos-docs.gitbook.io/default/v1.9.6/basic-tutorials/guides/development/code_serving/deploy_code_serving.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
