Gateway
Gateway는 Anyy의 상주 런타임입니다. 실시간 세션, 도구, 채널, 일정, 백그라운드 작업, 전달을 소유하며 TUI, Dashboard, CLI, 메시징 클라이언트가 연결됩니다.
서비스 확인
anyy gateway status
결과는 결정된 프로필 홈, 서비스 호스트, 소켓, 프로세스 상태를 보여 줍니다. 두 버전을 모두 알 수 있으면 실행 중인 Gateway와 현재 CLI 간의 버전 불일치도 보고합니다.
제품 전반을 보려면 다음도 실행하세요.
anyy status
시작 및 중지
anyy gateway start
anyy gateway restart
anyy gateway stop
start는 지원되는 사용자 서비스가 없으면 설치하고 런타임에 접근할 수 있을 때까지 잠시 기다립니다. restart도 누락된 서비스 설치를 복구한 뒤 시작합니다.
Anyy는 호스트의 지원 서비스 관리자를 사용합니다. macOS의 launchd 사용자 서비스, 일반 Linux의 systemd 사용자 서비스, 설치된 환경에서 지원되는 procd 또는 s6 통합이 포함됩니다.
Gateway를 중지하면 채널 연결이 끊기고 실시간 오케스트레이션, 일정, 연결된 런타임 작업이 멈춥니다. 유지보수 전에 활성 작업/프로세스를 확인하세요. Gateway에 접근할 수 없어도 별도 Dashboard 프로세스나 브라우저 탭은 열려 있을 수 있습니다.
프로필 선택
각 상주 Gateway는 결정된 프로필 하나를 제공합니다.
anyy --profile work gateway status
프로필 선택은 홈을 결정하며 프로필마다 별도의 네이티브 사용자 서비스 자산을 만들지는 않습니다. macOS는 고정 com.anyy.anyy launchd 작업, systemd는 anyy.service를 사용합니다. 기존 자산이 다른 홈에 속하면 서비스 파일을 덮어쓰지 말고 소유권 검사를 해결해야 합니다. s6 통합에는 자체 프로필별 서비스 처리가 있습니다. 프로필을 참조하세요.
기본 소켓이 없으면 TUI가 임시 인프로세스 Gateway를 시작할 수 있습니다. 이 임시 런타임은 TUI 종료 시 정리됩니다. 이후에도 작업을 계속해야 하면 상주 서비스를 설치·시작하세요. 관리되지 않는 프로세스 두 개를 같은 프로필에 연결하지 마세요. 프로필 소유권은 상태를 바꾸는 오프라인 작업도 보호합니다.
다시 시작할 때
지원되는 대부분의 설정 및 Dashboard 변경은 수동 재시작 없이 실시간 상태를 조정합니다. channel_webhooks.enabled와 channel_webhooks.listen은 시작 시 리스너 설정이므로 재시작이 필요합니다. 계정 Reload만으로 적용되지 않습니다. 웹훅 설정을 참조하세요. 다음 경우 다시 시작하세요.
gateway status가 실행 Gateway와 현재 CLI의 버전 차이를 보고할 때.- 조치 메시지가 명시적으로 재시작을 요청할 때.
- 정상 다시 로드 후에도 설치된 서비스에 접근하지 못할 때.
- 오프라인 유지보수 절차를 마칠 때.
문제 해결
-
서비스를 확인합니다.
anyy gateway status -
제품 진단을 실행합니다.
anyy doctor -
결정된 프로필의 서비스를 다시 시작합니다.
anyy gateway restart -
소켓이나 서비스 관리자 파일을 수동 변경하기 전에
status와doctor를 다시 실행합니다.
| 증상 | 다음 조치 |
|---|---|
| 서비스가 설치되지 않음 | anyy gateway start |
| 실행 Gateway 버전이 CLI와 다름 | Anyy 업데이트 후 anyy gateway restart |
| Dashboard/TUI 연결 불가 | 같은 프로필과 소켓을 사용하는지 확인 |
| 오프라인 유지보수가 소유권 획득 불가 | 해당 프로필 Gateway 중지 후 재시도 |
진단 필드는 상태 및 Doctor를 참조하세요.