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만으로 돌아요.
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 호출 때 뜨고, 죽으면 다시 띄워요. 포트를 열지 않아요(표준 입출력).
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 코드도 사내 코드처럼 검토해요.