Naru

운영

naru-admin, 환경 변수 이름, 키 교체, JDBC 드라이버와 Kerberos, 데이터베이스, pack runner 격리의 한계를 다뤄요.

naru-admin

naru-admin은 저장소의 packages/cli예요. 두 곳에서 돌릴 수 있어요.

  • 이미지 안에서: 이미지에 naru-admin이 들어 있어요(복구 명령 naru-recover와 함께). docker compose exec -e NARU_URL=http://127.0.0.1:8080 -e NARU_TOKEN=… naru naru-admin --help
  • 관리 PC의 저장소 체크아웃에서: 나루에 닿는 PC에서 pnpm install 뒤에 Node만으로 돌아요.
bash
pnpm install
alias naru-admin="node $PWD/packages/cli/bin/naru-admin.js"   # 저장소 루트에서 한 번
naru-admin login --url https://naru.corp.example --token <관리자 naru_pat_…>   # 또는 NARU_URL, NARU_TOKEN
명령 하는 일
systems list | get | apply <yaml> | test <id> | delete <id> 시스템 등록·수정(slug+env 기준), 연결 확인
systems secret <id> <이름> 비밀값(표준 입력)
systems accounts <id> <csv> 사람 → 레거시 계정 대응표(key,accountId, key는 accounts.key: 기본 email)
toolsets list | apply <yaml> | delete <slug> toolset
packs list | releases <pack> | deploy <pack> <dev|prod> <releaseId> 배포와 롤백
plugins list | approve <id> 코드 plugin 승인
users list | add --email … --name … [--role developer] [--employee-no …] 사람
tokens list | issue --kind svc|dev|pat … | revoke <id> 토큰(--user는 사용자 id usr_…)
trusts list | add | update | remove Mothership·갈피 trust
audit [--since …] | --after <커서> --jsonl 감사 기록 보기, SIEM 내보내기

환경 변수 이름

제품군 이름 나루의 예전 이름 뜻
PUBLIC_URL, PORT(기본 8080), DATA_DIR 같음 주소, 포트, 데이터 폴더
SECRETS_KEY NARU_SECRETS_KEYS 비밀값 봉인 키(쉼표로 여러 개)
ADMIN_EMAILS NARU_ADMIN_EMAIL 관리자
SMTP_URL, MAIL_FROM 같음 메일
APP_LANG NARU_LANG 기본 언어
LOGIN_METHODS (없었음) email, oidc, email,oidc
OIDC_* NARU_OIDC_* 사내 계정(SSO)

나루만의 설정은 NARU_로 시작해요: NARU_DCR, NARU_FUNCTION_TIMEOUT_MS(60000), NARU_AUDIT_RETENTION_DAYS(730), NARU_DRIVERS_DIR, NARU_PLUGINS_DIR, NARU_KRB5_CONF, NARU_DEV, NARU_ALLOW_LOOPBACK.

키 교체

SECRETS_KEY=new,old처럼 새 키를 앞에 두면 새 값은 새 키로 봉인되고 옛 값도 열려요. 모든 값을 다시 저장한 뒤 옛 키를 빼요. 키를 잃으면 봉인된 값(레거시 비밀번호, 개인 자격, 로그인 상태)을 열 수 없어요.

JDBC 드라이버와 Kerberos

  • Tibero(tibero7-jdbc.jar), Altibase, CUBRID, DB2 드라이버는 각 벤더에서 받아 NARU_DRIVERS_DIR(compose의 deploy/drivers)에 둬요. 나루에는 들어 있지 않아요.
  • Oracle은 Thin 모드로 Node에서 바로 붙어요(Instant Client 필요 없음). SQL Server, PostgreSQL, MySQL도 Node 드라이버예요.
  • Kerberos는 NARU_KRB5_CONF로 krb5.conf를 지정하고, 서비스 계정 keytab을 비밀값으로 넣어요: base64 -w0 svc.keytab | naru-admin systems secret <id> keytab.
  • sidecar는 첫 JDBC·Kerberos 호출 때 뜨고, 죽으면 다시 띄워요. 포트를 열지 않아요(표준 입출력).
JDBC 시스템 (Tibero, onbehalf)
slug: hr
env: prod
name: 인사 (Tibero)
driver: jdbc
endpoint:
  url: "jdbc:tibero:thin:@db.corp:8629:HR"
  driverClass: com.tmax.tibero.jdbc.TbDriver
  probe: "SELECT 1 FROM DUAL"
transport: { readOnly: true }
mode: onbehalf
serviceAccount: naru_ro
accounts: { from: employeeNo }
auth:
  - plugin: db-password
  - plugin: onbehalf
    config: { jdbcStatement: "BEGIN DBMS_SESSION.SET_IDENTIFIER(?); END;" }

데이터베이스

기본은 DATA_DIR의 SQLite(naru.sqlite)예요. DATABASE_URL을 두면 PostgreSQL(16, 17, 18 지원, 새 설치는 18 권장)을 쓰고, pack 번들과 파일은 그래도 /data에 남아요. 두 모드 모두 앱은 한 인스턴스로 운영해요. 전환과 백업은 저장소의 docs/database.md에 있어요.

pack runner 격리의 한계

pack 코드는 release마다 따로 된 Node 프로세스에서 돌고, 시스템은 IPC로 서버에 부탁해서만 불러요. 이것은 검토된 코드에 대한 다층 방어이고, 같은 pack을 쓰는 사람끼리의 격리 경계는 아니에요(모듈 상태를 공유해요). pack 코드도 사내 코드처럼 검토해요.

Esc