Q: SIP 캐리어와 벤더가 Routr와의 상호운용성을 인증하고 상호운용성 테스트 녹음 파일을 찾으려면 어떻게 해야 하나요?

파트너 interop 레코딩은 `interop/ /` 아래에 저장됩니다 (예: WhatsApp Business Calling의 경우 `interop/whatsapp/`). 각 디렉터리에는 날짜가 표시된 `.jsonl` SIP 트레이스, `manifest.yaml`, `RESULTS.md`의 통과/실패 체크리스트 결과가 들어 있으며, 인증 프로세스는 `interop/README.md`에 문서화되어 있습니다. SEET 컴플라이언스 픽스처는 `etc/corpus/`에 보관됩니다. interop을 검증하려면 `npm run compat -- --sip-connect`를 실행하세요. 이 명령은 dispatcher/connect/location 체인을 하나 시작하고, 먼저 `etc/corpus/manifest.yaml`을 재생한 다음 `rctl trace compat --fail-on error`를 통해 모든 `interop/*/manifest.yaml`을 알파벳 순서로 재생하며, 각 매니페스트 앞에 `== ` 줄을 출력합니다. 모든 매니페스트는 공유 `etc/corpus/resources` 디렉터리에서 재생 리소스를 참조합니다. 종료 코드 0은 clean 상태를 의미하고, 4는 drift를 의미합니다. 매니페스트 하나가 실패하더라도 모든 매니페스트가 계속 실행되며, 스크립트는 첫 번째 0이 아닌 종료 코드로 종료됩니다. error 수준의 발견 사항은 실행을 실패로 처리하고, warning은 출력만 됩니다. `draft: true`로 표시된 레코딩(예: 2026-10-25 WhatsApp 트레이스)은 검토가 완료된 후에만 증거로 인정됩니다.

Question 1

Bitnami PostgreSQL 및 Redis 이미지가 더 이상 존재하지 않아 Routr Helm 설치가 실패하는 문제를 해결하는 방법

Accepted Answer

Bitnami가 컨테이너 이미지를 `bitnamilegacy` 리포지토리로 이동했으므로(bitnami/charts#35164 참조), Routr Helm 차트에서 참조하는 기본 `bitnami/postgresql` 및 `bitnami/redis` 이미지를 더 이상 가져올 수 없습니다. 설치 시 이미지 리포지토리를 재정의하세요:

```bash
helm repo add routr https://routr.io/charts
helm repo update
helm install sipnet routr/routr-connect --namespace sipnet \
  --set postgresql.image.repository=bitnamilegacy/postgresql \
  --set redis.image.repository=bitnamilegacy/redis
```

이렇게 하면 PostgreSQL과 Redis 종속성이 모두 레거시 Bitnami 레지스트리를 가리키게 되어 차트가 성공적으로 배포됩니다.

Question 2

환경 변수 대신 구성 파일(one.yaml)을 사용하여 routr-one을 구성하려면 어떻게 해야 하나요?

Accepted Answer

컨테이너의 `/etc/routr/one.yaml`에 YAML 파일을 마운트하세요(또는 `ROUTR_ONE_CONFIG`가 다른 경로를 가리키도록 하세요). 이미지에 포함된 `/etc/routr/one.example.yaml` 예제에서 시작하세요(레포지토리에는 `config/one.example.yaml`로도 있습니다. 문서 사이트에 해당 파일이 나열될 때까지 이 파일을 참고하세요). `spec.*` 키로 구성하세요. 예를 들어 외부 Postgres의 경우 `spec.database.url`과 `spec.database.startInternal`을 사용합니다. `${VAR}` 참조는 컨테이너의 환경 변수를 읽습니다(따라서 `${POSTGRES_PASSWORD}`에는 `-e POSTGRES_PASSWORD`를 전달하세요). `secret://file/`는 컨테이너 내부 파일에서 시크릿을 읽습니다. 파일을 보호하세요: `sudo chown 5000:5000 one.yaml && chmod 600 one.yaml`을 실행하고 절대 커밋하지 마세요. Kubernetes에서는 `subPath: one.yaml`을 사용해 Secret에서 `/etc/routr/one.yaml`에 마운트하세요. `/etc/routr` 디렉터리 전체에 Secret을 마운트하면 `log4j2.yaml`, `rtprelay.yaml`, `certs/`와 예제가 가려집니다. 중요한 주의 사항: `ENV_MAP`(`mods/one/src/config/env_map.ts`, 예: `DATABASE_URL`, `PKCS12_PASSWORD`)에 매핑된 환경 변수는 `${...}` 참조에서 절대 사용하지 마세요. 이미지가 기본값(`PKCS12_PASSWORD=changeme`, 내부 `DATABASE_URL`)을 ENV에 내장하고 있어서, `-e` 플래그를 제거하면 `url: ${DATABASE_URL}`이 아무 경고 없이 조용히 내부 데이터베이스로 되돌아갑니다. `${ROUTR_DB_URL}`이나 `${ROUTR_KEYSTORE_PASSWORD}` 같은 새 이름을 사용하세요. 매핑된 환경 변수는 빠른 테스트에는 여전히 사용할 수 있지만 deprecation 경고를 로깅합니다. 파일 기반 구성은 PR #461이 포함된 routr-one 릴리스에서 지원됩니다(`gh release list` / `git tag --contains `로 확인하세요. ENV_MAP은 v2.28.0부터 main에 있습니다).

Question 3

Fonoster routr-one Docker 이미지가 마운트된 /etc/routr/one.yaml 설정 파일을 무시하는 이유는 무엇인가요?

Accepted Answer

영향을 받는 routr-one 이미지에서는 컨테이너 CMD가 환경 변수만으로 Postgres, 마이그레이션, keystore 및 EdgePort를 시작했으므로, 마운트된 `/etc/routr/one.yaml`은 `spec.recording` 외에는 아무런 효과가 없었습니다. 해결 방법: 시작 시 `print_env`를 실행하여 파일의 모든 키가 적용되도록 하는 수정 사항이 포함된 이미지(v2.30.0+)를 사용하십시오. UID 5000이 읽을 수 있도록 파일을 마운트하십시오: `docker run -d -v $PWD/one.yaml:/etc/routr/one.yaml:ro -e POSTGRES_PASSWORD=… -e KEYSTORE_PASSWORD=… fonoster/routr-one:latest`. 파일이 없는 경우 동작은 변경되지 않으며 모든 환경 변수가 계속 작동합니다. 이전 이미지에서의 우회 방법: 파일 대신 key-to-env-var 테이블의 `-e` 환경 변수를 통해 모든 것을 구성하십시오. 롤백 주의 사항: 이전 태그(예: 2.27.0)로 되돌리면 파일이 다시 읽히지 않게 되므로, 파일로만 구성된 설정은 내부 데이터베이스와 기본 `changeme` keystore 비밀번호로 폴백됩니다. 먼저 이에 해당하는 환경 변수를 복원하십시오.

Question 4

Routr One이 'pg_ctl: directory is not a database cluster directory' 오류로 실패하는 이유는 무엇인가요?

Accepted Answer

/var/lib/postgresql/data에 있는 Postgres 데이터 디렉터리가 초기화되지 않았습니다. 데이터베이스 클러스터를 생성하려면 'initdb -D /var/lib/postgresql/data'를 실행하거나, 첫 시작 시 자동으로 초기화되는 공식 Postgres Docker 이미지(예: postgres:15)를 사용하고 있는지 확인하십시오. Routr One의 경우, docker-compose.yml에 데이터 영속성을 위한 named volume을 사용하는 Postgres 서비스를 포함하고 디렉터리 권한을 확인하십시오.

Question 5

SIP 캐리어와 벤더가 Routr와의 상호운용성을 인증하고 상호운용성 테스트 녹음 파일을 찾으려면 어떻게 해야 하나요?

Accepted Answer

파트너 interop 레코딩은 `interop//` 아래에 저장됩니다 (예: WhatsApp Business Calling의 경우 `interop/whatsapp/`). 각 디렉터리에는 날짜가 표시된 `.jsonl` SIP 트레이스, `manifest.yaml`, `RESULTS.md`의 통과/실패 체크리스트 결과가 들어 있으며, 인증 프로세스는 `interop/README.md`에 문서화되어 있습니다. SEET 컴플라이언스 픽스처는 `etc/corpus/`에 보관됩니다. interop을 검증하려면 `npm run compat -- --sip-connect`를 실행하세요. 이 명령은 dispatcher/connect/location 체인을 하나 시작하고, 먼저 `etc/corpus/manifest.yaml`을 재생한 다음 `rctl trace compat --fail-on error`를 통해 모든 `interop/*/manifest.yaml`을 알파벳 순서로 재생하며, 각 매니페스트 앞에 `== ` 줄을 출력합니다. 모든 매니페스트는 공유 `etc/corpus/resources` 디렉터리에서 재생 리소스를 참조합니다. 종료 코드 0은 clean 상태를 의미하고, 4는 drift를 의미합니다. 매니페스트 하나가 실패하더라도 모든 매니페스트가 계속 실행되며, 스크립트는 첫 번째 0이 아닌 종료 코드로 종료됩니다. error 수준의 발견 사항은 실행을 실패로 처리하고, warning은 출력만 됩니다. `draft: true`로 표시된 레코딩(예: 2026-10-25 WhatsApp 트레이스)은 검토가 완료된 후에만 증거로 인정됩니다.

Routr

주요 기능

할 수 없는 것

사용 사례

태그

시작하기

유사한 프로젝트