Teleport Beams에서 장기 실행 에이전트 관리
Teleport v18.11요약
Teleport Beams를 사용하면 복잡한 코딩 프로젝트와 같은 장기 실행 에이전트 워크로드를 안전하게 관리할 수 있습니다. 이 가이드에서는 작은 데모 프로젝트를 따라 하면서 Teleport beam에서 장기 실행 에이전트 워크로드를 관리하는 방법을 알아봅니다.
Teleport Beams를 사용하면 복잡한 코딩 프로젝트와 같은 장기 실행 에이전트 워크로드를 안전하게 관리할 수 있습니다.
각 beam에는 beamctl 도구가 함께 배포되며,
이 도구를 사용해 SSH 세션을 종료한 후에도 계속 실행되는 서비스를 관리할 수 있습니다.
이 가이드에서는 작은 데모 프로젝트를 따라 하면서 Teleport beam에서 장기 실행 에이전트 워크로드를 관리하는 방법을 알아봅니다.
작동 방식#
Teleport Beams는 에이전트 워크로드를 실행하기 위한 마이크로 VM 샌드박스이며 Teleport Cloud 인프라에서 호스팅됩니다.
beam-init은 Teleport beam의 init 시스템으로, PID 1로 실행되며 호스트에서 실행되는 다른 프로세스를 생성한다는 점에서 systemd와 비슷합니다.
beamctl은 beam-init이 생성한 프로세스를 관리하는 CLI이며, 로컬 Unix 소켓을 통해 beam-init과 통신합니다.
이러한 프로세스를 서비스라고 합니다.
디스크에서 서비스 정의 파일을 로드하는 systemd와 달리,
beam-init은 사용자가 명령줄에서 서비스를 실행하면서 새 서비스를 선언하도록 요구합니다.
이는 24시간 후에 만료되는 Teleport beam의 일시적인 특성과 일치합니다.
이 가이드에서는 다음 beamctl 명령을 실제로 사용해 봅니다.
| 명령 | 설명 |
|---|---|
beamctl start <command> |
서비스를 생성합니다. --name 플래그로 이름을 지정하지 않으면 임의의 서비스 이름(예: 2341e33f4f3c550f)이 할당됩니다. |
beamctl stop <service name> |
서비스 프로세스를 종료합니다. |
beamctl restart <service name> |
서비스 프로세스를 종료한 다음 원래 명령으로 다시 시작합니다. |
beamctl list |
모든 서비스와 상태를 나열합니다. |
beamctl logs <service name> |
서비스의 출력을 표시합니다. |
서비스 삭제
beamctl stop으로 beam-init 서비스를 종료하면, 기본적으로 beam-init은 해당 서비스를 관리 대상 서비스 목록에 유지합니다.
beam-init이 추적하는 서비스 목록에서 서비스를 제거하려면 다음 명령을 실행합니다.
$ beamctl stop --prune <service name>
그렇지 않으면 beam-init은 중지된 서비스라도 기존 서비스와 같은 이름으로 서비스를 시작하도록 허용하지 않습니다.
전체 명령 목록을 보려면 beam에서 다음을 실행합니다.
$ beamctl help
사전 요구사항#
이 가이드를 진행하려면 Teleport Beams 계정이 필요합니다. 무료 체험을 시작하십시오.
이 가이드에서 사용할 데모 프로젝트에서는 두 개의 연속 에이전트 워크로드를 실행하여 간단한 웹 애플리케이션을 빌드합니다.
- 에이전트 1: 테스트를 실행하고, 코드를 작성하고 최적화하여 테스트를 통과시킵니다.
- 에이전트 2: 테스트를 작성하고 테스트 가능한 함수 시그니처를 설계하지만, 구현은 에이전트 1에게 맡깁니다.
에이전트 2는 에이전트 1이 아직 다루지 않은 엣지 케이스를 처리하는 테스트를 작성합니다. 이를 통해 에이전트들이 테스트 주도 개발(TDD) 워크플로를 따르게 되며, 애플리케이션 코드를 작성하는 에이전트가 사소한 테스트를 추가하는 것을 방지합니다.
이 가이드에서 실행하는 데모는 에이전트 프롬프트에서 권한 확인을 건너뜁니다. Teleport beam의 에이전트는 beam을 시작한 사용자의 권한을 상속하므로, 이 가이드를 시작하기 전에 Teleport로 보호되는 리소스에 접근 권한이 없는 사용자로 Teleport에 인증하는 것을 권장합니다.
1/2단계. 데모 프로젝트 설정#
이 가이드에서 만들 데모 프로젝트는 사용자가 브라우저 버튼으로 모스 부호를 입력하면 이를 텍스트로 변환합니다.
다른 프로젝트 아이디어를 사용해도 좋습니다. 그렇게 하는 경우, 관련 워크플로를 이해할 수 있도록 먼저 나머지 가이드를 끝까지 읽어 보십시오.
에이전트가 작업을 수행할 공간이 생기도록 Teleport beam을 생성하고 프로젝트를 설정합니다.
-
beam을 생성하고 SSH 세션을 시작합니다.
$ tsh beams add -
beam에서 프로젝트 디렉터리를 설정합니다.
$ mkdir morsecode $ cd morsecode -
프로젝트를 설정합니다.
$ npm init -
패키지 이름을
morsecode로 지정하고npm의 모든 기본값을 수락합니다. -
NodeJS 프로젝트를 설정하는 데 사용할 Vite와 테스트용
vitest를 설치합니다.$ npm install -D vitest vite@~8.2.0 -
빈 디렉터리를 추가합니다.
$ mkdir tests src -
소스 파일이 변경되면 자동으로 다시 로드되는 개발 서버를 시작합니다.
$ beamctl start --name=server -- \ bash -c 'export HOME=/home/beams; \ cd /home/beams/morsecode; \ npx vite --host --port=8080;' Started service serverbeamctl start는 Teleport beam에서 실행되는 모든 프로세스를 관리하는beam-initinit 시스템이 관리하는 서비스를 시작합니다. 여기서는npm이 정상적으로 동작하도록 Vite 프로젝트를 생성한 디렉터리를 홈 디렉터리로 설정합니다.나중에 이 가이드에서 Teleport를 통해 접속할 수 있도록 서버는
8080포트에서 실행되어야 합니다. -
다음 텍스트를 beam의 SPEC.md라는 파일에 복사합니다.
# Morse code in your browser When the user taps a button, the app reads it as Morse code and converts text to a readout below the button. There is a collapsable Morse code key as a reference for the user. -
beam에 사전 설치된
claude(codex도 사전 설치되어 있음)로 테스트 에이전트를 시작합니다. 테스트 에이전트는 10초마다 애플리케이션을 구현하고 잠재적인 엣지 케이스를 다루기 위한 새 테스트를 추가합니다. 다음에 시작할 코딩 에이전트와 마찬가지로, 테스트 에이전트는 실행 횟수가 30회로 제한되며 약 5분 분량의 작업에 해당합니다.$ beamctl start --name=tester -- bash -c ' \ export HOME=/home/beams; \ export count=0; \ cd /home/beams/morsecode; \ while [ $count -lt 30 ]; do \ claude -p --dangerously-skip-permissions < /dev/null "\ Read SPEC.md and the existing test files under tests. Identify one \ behavior from the spec that is not covered by an existing test yet, \ e.g., a new function, or an additional edge case for a function \ you have already tested. If a test calls a function that does not exist \ yet, import it in the new test and assume it has a testable function \ signature, but do not create or modify anything in src. Another agent \ will define functions and get tests to pass. Do not modify or remove \ existing tests."; \ sleep 10; \ count=$((count+1)); \ done;' Started service tester -
코딩 에이전트를 시작합니다.
$ beamctl start --name=coder -- bash -c ' \ export HOME=/home/beams; \ export count=0; \ cd /home/beams/morsecode; \ while [ $count -lt 30 ]; do \ if ! npx vitest run --silent; then \ claude -p --dangerously-skip-permissions < /dev/null "\ Read SPEC.md and existing test files under tests. Get the tests to \ pass by editing files in src. Maintain a minimal Vite entrypoint at \ index.html to wire everything up."; \ fi; \ sleep 10; \ count=$((count+1)); \ done;' Started service coder -
모든 서비스가 예상대로 실행되고 있는지 확인합니다. 모두
running으로 표시되어야 합니다.$ beamctl list bootstrap (running PID=2) coder (running PID=168) server (running PID=5817) tester (running PID=136)서비스를 시작하는 데 문제가 있나요?
서비스가 올바르게 시작되지 않았다면 해당 로그를 확인합니다.
$ beamctl logs tester $ beamctl logs coder $ beamctl logs server서비스를 시작하기 위해 실행한 명령(예: 오타)에 문제가 있다면, 서비스를 정리(prune)하고 올바른 명령으로 다시 시작합니다.
$ beamctl stop --prune <service> $ beamctl start <correct command> -
세션을 종료합니다.
$ exit logout the connection was closed on the remote side at <timestamp>
세션을 종료한 후에도 beamctl로 생성한 에이전트는 계속 작업을 수행합니다.
2/2단계. 앱 확인#
몇 분이 지나면 에이전트가 데모 프로젝트에서 상당한 진척을 이루었을 것입니다.
-
접근할 수 있도록 생성한 beam을 찾습니다.
$ tsh beams ls -
애플리케이션을 게시합니다. 아래 명령은 데모 프로젝트를 Teleport로 보호되는 웹 앱으로 등록합니다.
beam-name을 beam의 이름으로 지정합니다.$ tsh beams publish beam-name -
안내에 따라 Teleport에 인증하고 앱에 접속합니다.
-
터미널에서 beam에 SSH로 접속합니다.
$ tsh beams ssh beam-name -
시작한 모든
beamctl서비스의 상태를 표시합니다.$ beamctl list bootstrap (running PID=2) coder (running PID=168) server (running PID=5817) tester (running PID=136) -
beamctl서비스의 로그를 확인합니다. 예를 들어 테스터가 추가한 테스트에 대해 설명하는 내용을 볼 수 있습니다.$ beamctl logs tester--follow플래그를 추가하면 서비스의 로그를 터미널로 스트리밍할 수 있습니다. -
서비스가 아직 실행 중이라면 다음 명령으로 해당 프로세스를 종료할 수 있습니다.
$ beamctl stop tester $ beamctl stop coder -
중지된 서비스가 있고 작업을 재개하려면 다음 명령을 실행하여 다시 시작할 수 있습니다. 예를 들면 다음과 같습니다.
$ beamctl restart coder $ beamctl restart tester $ beamctl restart server