zxkane/openhands-infra

openhands-infra은(는) 무엇을 하나요?

🚀 AWS에서 AI 코딩 에이전트를 자체 호스팅하세요 — ECS Fargate로 완전 서버리스. 유휴 비용 제로, 대화별 격리, Bedrock LLM. CDK로 몇 분 만에 배포.

개요

이 프로젝트는 AWS 인프라에서 OpenHands AI 코딩 에이전트를 실행하기 위한 CDK 애플리케이션입니다. ECS Fargate를 사용하여 완전 서버리스로 운영되며, 유휴 상태에서 비용이 발생하지 않습니다.

주요 기능

• 완전 서버리스: ECS Fargate + ALB 조합으로 컨테이너 실행, 관리 불필요
• 유휴 비용 제로: 사용하지 않을 때는 리소스가 자동으로 축소되어 비용이 들지 않음
• 대화별 격리: 각 세션이 독립적인 컨테이너에서 실행되어 보안과 안정성 향상
• Bedrock LLM: AWS Bedrock을 기본 LLM 제공자로 사용, 추가 API 키 불필요
• 빠른 배포: AWS CDK를 사용하여 몇 분 안에 전체 인프라 배포 가능

사전 요구 사항

• AWS 계정 및 적절한 IAM 권한
• AWS CLI 구성 (aws configure)
• Node.js 18 이상
• AWS CDK CLI 설치 (npm install -g aws-cdk)
• Docker (로컬 테스트 시 필요)

빠른 시작

git clone https://github.com/zxkane/openhands-infra.git
cd openhands-infra
npm install
cdk bootstrap
cdk deploy

환경 변수 설정

cdk.json 또는 .env 파일을 통해 다음 환경 변수를 설정할 수 있습니다:

변수명	설명	기본값
OPENHANDS_BEDROCK_MODEL	Bedrock LLM 모델 ID	anthropic.claude-v2
OPENHANDS_BEDROCK_REGION	Bedrock 서비스 리전	us-east-1
ECS_CPU	Fargate 태스크 CPU 할당	1024
ECS_MEMORY	Fargate 태스크 메모리 할당	2048

아키텍처

• ALB: Application Load Balancer로 트래픽 라우팅
• ECS Fargate: 서버리스 컨테이너 실행, 자동 스케일링
• Bedrock: LLM 추론 엔드포인트 (API 키 불필요)
• CloudWatch: 로깅 및 모니터링

보안

• VPC 내부에서만 트래픽 허용 (선택적으로 퍼블릭 ALB 설정 가능)
• IAM 역할을 통한 최소 권한 부여
• Bedrock은 IAM 인증 사용

라이선스

MIT License