Scripts

`akan script`는 seed data, migration, 점검, 작은 유지보수 수정 같은 일회성 개발/운영 작업에 사용합니다.

Script는 일반 web page를 열지 않고 app server container를 시작합니다.
App이 이미 연결해 둔 service, signal, adaptor를 재사용할 수 있습니다.
각 script는 작게 유지하고 작업이 끝나면 지우기 쉽게 만드세요.
Interactive 점검이나 작은 운영 명령에는 `akan console`을 사용하세요.

명령어

Script는 `apps/myapp/script` 아래에 둡니다. 파일명이 command target이 됩니다.

Script 실행

Server lifecycle

Server를 시작하고 작업한 뒤 `finally`에서 반드시 종료하세요. 그래야 database connection, timer, adaptor가 올바르게 정리됩니다.

apps/myapp/script/hello.ts

Service 사용

대부분의 유지보수 작업은 service를 호출하는 방식이 좋습니다. Service는 domain rule, database access, 다른 의존성을 이미 알고 있습니다.

데이터 조회와 수정

Lookup helper

`server.get(ArticleService)`: class 기반 조회로 type이 잘 잡힙니다.
`server.getService("article")`: refName 기반 service 조회입니다.
`server.getSignal("article")`: signal logic을 호출하고 싶을 때 사용합니다.
`server.getAdaptor("storage")`: infrastructure 작업에서 adaptor를 조회할 때 사용합니다.

꿀팁

데이터를 변경하기 전에 대상 environment를 출력하세요.
파괴적인 script에는 confirm flag나 dry-run mode를 추가하세요.
Domain rule이 한곳에 남도록 직접 database를 쓰기보다 service method를 우선 사용하세요.

Server lifecycle