chhanz's Tech Blog

KiroCrew 설치와 사용 KiroCrew 설치 및 사용 방법 KiroCrew 란? KiroCrew(Kiro Crew)는 로컬 또는 원격 장비에서 상주하며 동작하는 오픈소스 AI 에이전트입니다. Gateway 라고 불리는 장기 실행 프로세스가 하나 떠 있고, 이 Gateway 에 데스크톱 앱, 웹 대시보드, CLI 로 접속하거나 Slack, Telegram, Discord, Teams 같은 메신저 채널을 연결해서 같은 에이전트를 여러 경로로 사용하는 구조입니다. 예약 작업(cron), 서브에이전트 병렬 실행, 지식 베이스 같은 기능이 Gateway 안에 함께 들어 있습니다. LLM 호출은 kiro-cli 를 통해 이루어지며, KiroCrew 는 ACP(Agent Client...

AgentCore 웹 검색 연동 [AWS] Bedrock AgentCore Web Search를 MCP로 연동 최근 AWS에서 Amazon Bedrock AgentCore에 웹 검색 기능을 추가했다는 소식을 접하고, 실제로 AI 에이전트에 연결하여 테스트를 해보았습니다. 관련하여 게이트웨이를 직접 구성하고 MCP 클라이언트에 붙이는 과정까지 한 번에 정리된 내용이 많지 않아, 이번 포스팅에서는 AgentCore Web Search를 게이트웨이로 노출하고 MCP 도구로 연동하는 방법에 대해 기록하도록 하겠습니다. Bedrock AgentCore Web Search 란? Amazon Bedrock AgentCore는 AI 에이전트를 운영하기 위한 관리형 서비스입니다. 이번에 추가된 Web Search는 에이전트가 외부 웹을 검색할 수...

Client VPN 한 번에 구축 AWS Client VPN 구축 자동화 도구 AWS Client VPN을 구성하다 보면 인증서 발급, ACM import, 엔드포인트 생성, 서브넷 연결, 인가 규칙, 그리고 접속용 .ovpn 파일 생성까지 손이 많이 가는 작업을 매번 반복하게 됩니다. 저의 경우에도 테스트 환경을 만들고 지우는 일이 잦아, 이 과정을 명령 한 줄로 처리할 수 있도록 도구를 만들어 보았습니다. 이번 포스팅에서는 직접 만든 fast-aws-clientvpn 도구의 구조와 사용 방법에 대해 기록하도록 하겠습니다. 저장소: https://github.com/chhanz/fast-aws-clientvpn 설계 방향 이 도구는 두 가지 역할을 명확히 나눕니다....

AL2023 스크린샷 개요 EC2 인스턴스 운영 중 SSH 접속이 되지 않거나 상태 검사 가 실패 되는 경우, 인스턴스 내부 로그를 확인 할 수 없기 때문에 원인 파악이 쉽지 않습니다. 저의 경우 이런 상황 에서는 EC2 콘솔 인스턴스 진단 탭의 인스턴스 스크린샷 과 시스템 로그 기능을 통해 현재 콘솔 상태를 확인 하고 문제를 파악하는데 이 기능들은 온프레미스 VM과 달리 제한된 환경인 EC2 에서는 매우 도움이 되는 기능입니다. 그런데 Amazon Linux 2023 (이하 AL2023) 기본 AMI 에서 인스턴스 스크린샷...

AI 에이전트 이관 경험 Hermes Agent 란? Hermes Agent는 Nous Research에서 MIT 라이선스로 공개한 AI 에이전트 프레임워크입니다. 기존에 사용하던 OpenClaw의 후속 프로젝트로, Skills 중심 아키텍처와 세션 간 기억(FTS5 검색) 기능을 지원합니다. 이번 포스팅에서는 OpenClaw에서 Hermes Agent로 마이그레이션한 경험에 대해 기록하도록 하겠습니다. 마이그레이션 배경 OpenClaw를 약 6개월간 운영하면서 아래 두 가지 한계를 느꼈습니다. 스킬이 정적이다 - 새로운 워크플로우가 필요하면 매번 직접 스킬을 만들어 등록해야 합니다. 에이전트가 스스로 학습한 내용을 기록하는 기능이 없습니다. 세션 간 기억이 얕다 - USER.md / MEMORY.md...

S3 Files로 S3 버킷을 NFS 파일 시스템으로 마운트하는 방법 개요 Amazon S3 버킷을 NFS 파일 시스템으로 마운트하여 일반 파일 명령어(ls, cp, cat 등)로 접근할 수 있는 Amazon S3 Files 기능이 2026년 4월에 출시되었습니다. 이번 포스트에서는 S3 Files 의 개념과 EC2 에서 마운트하는 방법을 기록하도록 하겠습니다. S3 Files 란? S3 Files 는 S3 버킷을 NFS v4.1/v4.2 파일 시스템으로 마운트할 수 있게 해주는 기능입니다. 내부적으로 Amazon EFS 기반의 고성능 스토리지를 활용하며, 활성 데이터에 대해 약 ~1ms 수준의 지연시간을 제공합니다. 데이터는 S3 를 떠나지 않으며, S3 API...

Traefik 기본 사용법 Traefik 기본 사용법 이번 포스팅에서는 Docker 환경에서 Traefik을 구성하고 사용하는 방법에 대해 기록하도록 하겠습니다. Traefik 이란? Traefik은 클라우드 네이티브 환경을 위한 리버스 프록시 / 로드 밸런서입니다. Nginx나 HAProxy와 같은 전통적인 프록시와 달리, 서비스를 자동으로 감지하고 라우팅 설정을 동적으로 업데이트하는 것이 특징입니다. 특히 Docker 환경에서 컨테이너에 레이블(Label)만 추가하면 자동으로 라우팅이 설정되어, 별도로 설정 파일을 관리할 필요가 없습니다. 테스트 환경 테스트 환경 : Amazon Linux 2023 Traefik : v3.3 핵심 개념 Traefik 은 4가지 핵심 컴포넌트로 구성됩니다....

Firecracker microVM with Amazon EC2 Nested Virtualization Firecracker 란? Firecracker는 AWS에서 개발한 오픈소스 VMM(Virtual Machine Monitor)입니다. KVM을 사용하여 경량 microVM을 생성하고 관리하며, AWS Lambda와 AWS Fargate의 기반 기술로 사용되고 있습니다. Firecracker는 64-bit Intel, AMD, Arm CPU를 지원하며, hardware virtualization 기능이 필요합니다. Fly.io, Kata Containers, firecracker-containerd 등 다양한 프로젝트에서 활용되고 있습니다. 이번 포스팅에서는 AWS EC2 Nested Virtualization 환경에서 Firecracker microVM을 설치하고 실행하는 방법에 대해 기록하도록 하겠습니다. EC2 Nested Virtualization 기존에는 EC2에서 KVM을 사용하기 위해 .metal 인스턴스...

Amazon Bedrock과 Claude Code 연동 이번 포스팅에서는 AWS EC2 인스턴스에서 Amazon Bedrock을 활용하여 Claude Code를 사용하는 방법에 대해 기록하도록 하겠습니다. Claude Code는 Anthropic에서 제공하는 AI 코딩 어시스턴트로, Amazon Bedrock을 통해 AWS 환경에서 안전하게 사용할 수 있습니다. 이를 통해 Anthropic 계정 없이도 AWS IAM 역할 기반 인증으로 Claude Code를 활용할 수 있습니다. 테스트 환경 테스트 환경: Amazon Linux 2023.10.20260202 AWS Region: ap-northeast-2 IAM 역할 생성 Amazon Bedrock을 사용하기 위해 EC2 인스턴스에 연결할 IAM 역할을 생성합니다. Trust...

opencode 란? opencode는 터미널에서 사용할 수 있는 AI 기반 코딩 어시스턴트입니다. 다양한 AI 프로바이더를 지원하며, Amazon Bedrock과 연동하여 AWS 환경에서 손쉽게 AI 코딩 어시스턴트를 활용할 수 있습니다. 이번 포스팅에서는 opencode를 설치하고 Amazon Bedrock과 연동하여 사용하는 방법에 대해 기록하도록 하겠습니다. 공식 사이트: https://opencode.ai/ 테스트 환경 테스트 환경: Amazon Linux 2023 AWS Region: ap-northeast-2 설치 아래와 같이 opencode를 설치합니다. $ curl -fsSL https://opencode.ai/install | bash Installing opencode version: 1.1.53 ■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■ 100% Successfully added opencode to $PATH in...