LangSmith Cloud 배포 만들기: UI와 CLI 두 갈래

LangSmith UI나 LangGraph CLI로 Cloud 배포를 만들 수 있습니다. LangSmith UI는 연결된 GitHub 저장소에서 배포하고, langgraph deploy CLI는 로컬 머신에서 빌드·푸시합니다. 더 짧은 설명이 필요하면 deployment quickstart를 참고하세요.

출처: Create a deployment 공식 문서

사전 준비

Plus 플랜 이상의 LangSmith 계정
langgraph dev로 로컬에서 도는 애플리케이션(로컬 개발/테스트 가이드 참고)

배포 만들기

LangSmith UI로 — GitHub 조직 소유자나 관리자가 LangChain의 hosted-langserve GitHub 앱을 한 번 승인해야 합니다. 승인 후에는 배포 권한이 있는 사용자라면 누구나 앱이 접근 가능한 저장소에서 배포를 만들 수 있습니다.

LangSmith UI에서 Deployments 선택.
우측 상단 + New Deployment 선택.
Import from GitHub 선택 후, 요청되면 GitHub 승인 흐름 완료.
저장소 선택.
배포 이름 입력.
배포할 Git Branch 선택.
LangGraph API 설정 파일의 전체 경로 입력(파일명 포함). 루트에 있으면 langgraph.json.
브랜치에 푸시 시 배포 자동 갱신 활성화 여부 선택.
배포 유형 선택:
- Serverless — 백그라운드·개발·테스트·미리보기 워크로드에 적합. scale-to-zero 가용성.
- Dedicated — 프로덕션 워크로드를 위한 항상 켜진 인프라, 고가용성, 자동 DB 백업.
Studio로 배포를 공유할지 선택.
환경변수·시크릿 추가.
Submit 선택. LangSmith가 배포 프로비저닝을 큐에 넣고 같은 이름의 트레이싱 프로젝트를 만듭니다.

GitHub 승인을 한 사용자가 조직·계정 소유자여야 합니다. 이후 배포 권한만 있는 다른 사용자는 GitHub 관리자 권한이 필요 없습니다.

LangGraph CLI로 — langgraph deploy는 베타이며 Docker가 필요합니다(Apple Silicon에선 Buildx도). 배포를 만들려면:

LangGraph CLI 설치:

uv tool install langgraph-cli

프로젝트 루트 .env에 API 키 추가:

LANGSMITH_API_KEY=lsv2_...

실행:

langgraph deploy

기본은 프로젝트 디렉터리 이름의 Serverless 배포입니다. 이름이나 유형을 바꾸려면 옵션으로:

langgraph deploy --name my-agent --deployment-type dedicated

LangSmith가 프로비저닝을 큐에 넣습니다. 환경변수는 LangSmith UI나 langgraph.json의 env 필드로 관리합니다.

구(previous) 과금제 조직은 2026년 10월 1일까지 --deployment-type prod/dev를 사용하세요(Manage billing 참고).

GitHub 저장소 접근 관리

hosted-langserve 앱을 승인한 뒤 접근 가능한 저장소를 설정합니다.

GitHub에서 Settings > Applications로 이동.
hosted-langserve를 찾아 Configure 선택.
Repository access에서 All repositories 또는 Only select repositories 선택.
후자를 골랐다면 필요한 저장소를 추가/제거.
Save 선택.

Create New Deployment 패널의 저장소 목록에 갱신된 접근이 반영됩니다.

참고

Revisions(개정)
Preview builds(미리보기 빌드)
Manage a deployment(배포 관리)

더 알아보기 (Learn more)

더 짧은 시작 경로는 같은 허브의 클라우드 배포 퀵스타트를 참고하세요.
로컬에서 langgraph dev/langgraph up으로 먼저 검증하는 법은 로컬 개발/테스트 가이드에서 이어집니다.