image
Akan.js
Docs
DocsConventionsReferencesCheatsheet
English
image
Akan.js
Akan.js v2 docs are now available.View the v1 docs
DocsConventionsReferencesCheatsheet
MIT 라이선스 하에 배포되었습니다.
Akan.js 공식 컨설팅 서비스Akansoft
Copyright © 2026 Akan.js 모든 권리 보유.
시스템 관리자bassman
일반
• 인증
• 스키마 설계
• 엣지 컴퓨팅
• 파일 관리
• Single Sign-On
• DataList & Enum
인터페이스
• CRUD
• Endpoint
• Form
관측성
• 로깅
• 의존성 주입
• 에러 처리
• 메트릭
성능
• 캐싱
• 이미지 최적화
• 지연 로딩
• 쿼리
• 큐
• 실시간
개발
• 문서화
• 스크립트
• 콘솔
• 도커
• 쿠버네티스
• PWA
일반
• 인증
• 스키마 설계
• 엣지 컴퓨팅
• 파일 관리
• Single Sign-On
• DataList & Enum
인터페이스
• CRUD
• Endpoint
• Form
관측성
• 로깅
• 의존성 주입
• 에러 처리
• 메트릭
성능
• 캐싱
• 이미지 최적화
• 지연 로딩
• 쿼리
• 큐
• 실시간
개발
• 문서화
• 스크립트
• 콘솔
• 도커
• 쿠버네티스
• PWA
Next
인증

Server Console

Akan server console은 초기화된 app runtime을 대상으로 interactive 점검과 작은 운영 명령을 실행할 때 사용합니다.
  • `akan console`은 local development용 entry입니다.
  • `console.js`는 `akan build`가 생성하며 production dist 안에서 `main.js` 옆에 포함됩니다.
  • 실행 중인 container나 pod 안에서 console 파일을 직접 만들지 마세요.

Local console

반복 가능한 script 파일을 만들지 않고 service를 점검하거나 작은 method, query를 실행하고 싶을 때 local console을 엽니다.
Local 실행

Container console

Docker나 Kubernetes에서는 build image 안에 이미 들어 있는 generated `console.js`를 실행합니다.
production 계열 환경에서는 exec 명령 자체에만 `AKAN_CONSOLE=1`을 설정하세요. Deployment env에 영구적으로 넣지 않는 것이 좋습니다.
Docker
Kubernetes

Lifecycle

  • Container console mode는 같은 container나 pod 안에서 별도의 no-listen server process를 시작합니다.
  • 실행 중인 app container와 env, secret, mounted volume, network, database access를 공유합니다.
  • 이미 실행 중인 `main.js` process나 그 in-memory state에 attach하지는 않습니다.
  • Console mode는 두 번째 process이므로 scheduler와 cron 작업이 실행되지 않게 유지해야 합니다.

Globals

Console은 작은 명령을 짧게 유지할 수 있도록 runtime helper와 generated app export를 제공합니다.
  • `server`, `env`: 현재 server instance와 environment.
  • `get`, `service`, `signal`, `adaptor`: runtime object lookup helper입니다.
  • `methods`, `debug`: public method와 runtime registration state를 점검합니다.
  • `srv`, `sig`, `db`, `cnst`: generated app export입니다.
예시

Safety

  • 데이터를 변경하기 전에 대상 environment를 출력하고 확인하세요.
  • Domain rule이 계속 실행되도록 직접 database를 쓰기보다 service method를 우선 사용하세요.
  • 파괴적인 작업은 console에 여러 명령을 직접 치기보다 dry-run이나 confirm이 있는 script로 작성하세요.
  • `AKAN_CONSOLE=1`은 영구 deployment configuration에 넣지 마세요.
Server Console
Local console
Container console
Lifecycle
Globals
Safety