From 92ffef9b376fe53988eb29a3b3739de5037b4783 Mon Sep 17 00:00:00 2001 From: fyui001 Date: Fri, 20 Nov 2026 10:48:33 +0900 Subject: [PATCH 1/4] =?UTF-8?q?Puppis=20=E3=82=92=20v0.4.0=20=E3=81=AB?= =?UTF-8?q?=E3=81=97=E3=80=81Pyxis=20=E3=82=92=200.7.0=20=E3=81=AB?= =?UTF-8?q?=E3=81=99=E3=82=8B=E3=80=82?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude --- README.md | 5 +++-- charts/pyxis/Chart.yaml | 6 +++--- charts/pyxis/values.yaml | 2 +- compose.yml | 2 +- 4 files changed, 8 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index 48bc5aa..009a160 100644 --- a/README.md +++ b/README.md @@ -73,7 +73,7 @@ docker compose logs app | grep 'Sign in as' ```bash git fetch --tags -git checkout v0.6.0 +git checkout v0.7.0 docker compose pull docker compose stop app docker compose up -d @@ -93,7 +93,7 @@ tar -C "$(grep ^CARINA_KEYS_DIR= .env | cut -d= -f2)" -cf keys-$(date +%Y%m%d).t ## Helm ```bash -helm install carina oci://ghcr.io/newworldorg/charts/pyxis --version 0.6.0 -n tv --create-namespace -f values.yaml +helm install carina oci://ghcr.io/newworldorg/charts/pyxis --version 0.7.0 -n tv --create-namespace -f values.yaml ``` 値の一覧と説明は `charts/pyxis/values.yaml` にあります。\ @@ -103,6 +103,7 @@ driver は特権コンテナなので、名前空間の Pod Security は `privil | Pyxis | Carina | Puppis | Vela | PostgreSQL | Caddy | | --- | --- | --- | --- | --- | --- | +| 0.7.0 | v2.1.0 | v0.4.0 | v1.4.0 | 18.6(Debian) | 2.11.7 | | 0.6.0 | v2.1.0 | v0.3.0 | v1.4.0 | 18.6(Debian) | 2.11.7 | | 0.5.0 | v2.0.0 | v0.2.0 | v1.3.0 | 18.6(Debian) | 2.11.7 | | 0.4.0 | v2.0.0 | v0.1.1 | v1.2.0 | 18.6(Debian) | 2.11.7 | diff --git a/charts/pyxis/Chart.yaml b/charts/pyxis/Chart.yaml index d45846f..2d9d241 100644 --- a/charts/pyxis/Chart.yaml +++ b/charts/pyxis/Chart.yaml @@ -2,8 +2,8 @@ apiVersion: v2 name: pyxis description: A recording server for Japanese digital broadcasting, with Puppis, Carina and Vela pinned to a verified set of image versions type: application -version: 0.6.0 -appVersion: 0.6.0 +version: 0.7.0 +appVersion: 0.7.0 kubeVersion: ">=1.25.0-0" home: https://github.com/NewWorldOrg/Pyxis sources: @@ -20,6 +20,6 @@ keywords: annotations: # このバージョンで固定するイメージの組み合わせ。compose.yml と values.yaml の image と同じ値にする images/carina-app: ghcr.io/newworldorg/carina:v2.1.0 - images/puppis-driver: ghcr.io/newworldorg/puppis:v0.3.0 + images/puppis-driver: ghcr.io/newworldorg/puppis:v0.4.0 images/vela: ghcr.io/newworldorg/vela:v1.4.0 images/postgres: postgres:18.6-trixie diff --git a/charts/pyxis/values.yaml b/charts/pyxis/values.yaml index 6772b24..a3c8719 100644 --- a/charts/pyxis/values.yaml +++ b/charts/pyxis/values.yaml @@ -16,7 +16,7 @@ driver: # driver のイメージ repository: ghcr.io/newworldorg/puppis # driver のイメージのタグ。compose.yml と同じバージョンにする - tag: v0.3.0 + tag: v0.4.0 # イメージの pull ポリシー pullPolicy: IfNotPresent # driver.json の内容をそのまま書く。socketGroupId はチャートが carina.gid の値を設定し、socketPath は既定 (/run/carina/driver.sock) のままにする diff --git a/compose.yml b/compose.yml index 7879236..7fd98c3 100644 --- a/compose.yml +++ b/compose.yml @@ -92,7 +92,7 @@ services: condition: service_started driver: - image: ghcr.io/newworldorg/puppis:v0.3.0 + image: ghcr.io/newworldorg/puppis:v0.4.0 logging: *logging # 停止を要求されたときは終了コード 0、それ以外は 70 で終了するので on-failure は使わない restart: unless-stopped From 0341b7425222d8d066de6d57ebd5c6c7b886745a Mon Sep 17 00:00:00 2001 From: fyui001 Date: Fri, 20 Nov 2026 10:49:07 +0900 Subject: [PATCH 2/4] =?UTF-8?q?compose=20=E3=81=AE=20driver=20=E3=81=AB?= =?UTF-8?q?=E5=90=8D=E5=89=8D=E4=BB=98=E3=81=8D=E3=83=9C=E3=83=AA=E3=83=A5?= =?UTF-8?q?=E3=83=BC=E3=83=A0=20driver-state=20=E3=81=A8=20PUPPIS=5FDRIVER?= =?UTF-8?q?=5FSTATE=20=E3=82=92=E8=B6=B3=E3=81=97=E3=80=81=E5=8F=97?= =?UTF-8?q?=E4=BF=A1=E3=81=AE=E8=A8=98=E9=8C=B2=E3=82=92=E5=86=8D=E8=B5=B7?= =?UTF-8?q?=E5=8B=95=E3=81=AE=E3=81=82=E3=81=A8=E3=82=82=E6=AE=8B=E3=81=99?= =?UTF-8?q?=E3=80=82?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude --- compose.yml | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/compose.yml b/compose.yml index 7fd98c3..55a1502 100644 --- a/compose.yml +++ b/compose.yml @@ -101,8 +101,11 @@ services: stop_grace_period: 7h environment: PUPPIS_DRIVER_CONFIG: /etc/puppis/driver.json + # driver がチューナーと局の組み合わせごとの受信の記録を保存するディレクトリ。指定しないと記録は再起動で消える + PUPPIS_DRIVER_STATE: /var/lib/puppis volumes: - ./driver/driver.json:/etc/puppis/driver.json:ro + - driver-state:/var/lib/puppis - driver-run:/run/carina - ${CARINA_RECORDINGS_DIR:?}:/srv/recordings healthcheck: @@ -160,6 +163,7 @@ networks: volumes: driver-run: + driver-state: thumbnails: captions: caddy-data: From 92ca43e3d7b99c4cacf5e8cf1f86a44462a637aa Mon Sep 17 00:00:00 2001 From: fyui001 Date: Fri, 20 Nov 2026 10:52:30 +0900 Subject: [PATCH 3/4] =?UTF-8?q?=E3=83=81=E3=83=A3=E3=83=BC=E3=83=88?= =?UTF-8?q?=E3=81=AE=20driver=20=E3=81=AB=20persistence.state=20=E3=81=AE?= =?UTF-8?q?=E3=83=9C=E3=83=AA=E3=83=A5=E3=83=BC=E3=83=A0=E3=81=A8=20PUPPIS?= =?UTF-8?q?=5FDRIVER=5FSTATE=20=E3=82=92=E8=B6=B3=E3=81=97=E3=80=81?= =?UTF-8?q?=E5=8F=97=E4=BF=A1=E3=81=AE=E8=A8=98=E9=8C=B2=E3=82=92=20Pod=20?= =?UTF-8?q?=E3=81=AE=E4=BD=9C=E3=82=8A=E7=9B=B4=E3=81=97=E3=81=AE=E3=81=82?= =?UTF-8?q?=E3=81=A8=E3=82=82=E6=AE=8B=E3=81=99=E3=80=82?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude --- .github/workflows/check.yml | 2 +- charts/pyxis/ci/driver-only-values.yaml | 2 +- charts/pyxis/ci/external-db-values.yaml | 4 ++- charts/pyxis/ci/ingressroute-gpu-values.yaml | 4 +++ charts/pyxis/ci/kind-sizes.yaml | 2 ++ charts/pyxis/templates/driver-deployment.yaml | 6 ++++ charts/pyxis/templates/pvc.yaml | 1 + charts/pyxis/values.schema.json | 5 ++-- charts/pyxis/values.yaml | 19 +++++++++++- scripts/check-rendering.sh | 30 ++++++++++++++++++- 10 files changed, 68 insertions(+), 7 deletions(-) diff --git a/.github/workflows/check.yml b/.github/workflows/check.yml index e9316fb..cc22818 100644 --- a/.github/workflows/check.yml +++ b/.github/workflows/check.yml @@ -141,5 +141,5 @@ jobs: -schema-location default \ -schema-location 'https://raw.githubusercontent.com/datreeio/CRDs-catalog/main/{{.Group}}/{{.ResourceKind}}_{{.ResourceAPIVersion}}.json' done - - name: No chart version in the Pod templates, the checksum on the driver only, Service names from the release name + - name: No chart version in the Pod templates, the checksum on the driver only, Service names from the release name, the state volume, the claims run: scripts/check-rendering.sh diff --git a/charts/pyxis/ci/driver-only-values.yaml b/charts/pyxis/ci/driver-only-values.yaml index f043006..7f31f41 100644 --- a/charts/pyxis/ci/driver-only-values.yaml +++ b/charts/pyxis/ci/driver-only-values.yaml @@ -1,4 +1,4 @@ -# driver だけを別の機械で動かす構成。ホストのネットワークでカードを貸し、app・Vela・データベース・Ingress は作らない +# driver だけを別の機械で動かす構成。ホストのネットワークでカードを貸し、app・Vela・データベース・Ingress は作らない。受信の記録のボリュームは既定の PVC のまま driver: hostNetwork: true config: diff --git a/charts/pyxis/ci/external-db-values.yaml b/charts/pyxis/ci/external-db-values.yaml index d46e650..f96d7ba 100644 --- a/charts/pyxis/ci/external-db-values.yaml +++ b/charts/pyxis/ci/external-db-values.yaml @@ -1,4 +1,4 @@ -# 外部のデータベースを使う構成。同梱のデータベースを作らず、接続文字列を Secret から読む。GPU は hostPath、サムネイルと字幕は emptyDir +# 外部のデータベースを使う構成。同梱のデータベースを作らず、接続文字列を Secret から読む。GPU は hostPath、サムネイルと字幕と受信の記録は emptyDir postgres: enabled: false externalDatabase: @@ -30,3 +30,5 @@ persistence: type: emptyDir captions: type: emptyDir + state: + type: emptyDir diff --git a/charts/pyxis/ci/ingressroute-gpu-values.yaml b/charts/pyxis/ci/ingressroute-gpu-values.yaml index 7e92e74..ef8922e 100644 --- a/charts/pyxis/ci/ingressroute-gpu-values.yaml +++ b/charts/pyxis/ci/ingressroute-gpu-values.yaml @@ -77,3 +77,7 @@ persistence: type: hostPath hostPath: path: /srv/pyxis/postgres + state: + type: hostPath + hostPath: + path: /srv/pyxis/driver-state diff --git a/charts/pyxis/ci/kind-sizes.yaml b/charts/pyxis/ci/kind-sizes.yaml index 27e4a70..965fa3e 100644 --- a/charts/pyxis/ci/kind-sizes.yaml +++ b/charts/pyxis/ci/kind-sizes.yaml @@ -12,3 +12,5 @@ persistence: size: 64Mi db: size: 1Gi + state: + size: 64Mi diff --git a/charts/pyxis/templates/driver-deployment.yaml b/charts/pyxis/templates/driver-deployment.yaml index 0b15f21..8b51398 100644 --- a/charts/pyxis/templates/driver-deployment.yaml +++ b/charts/pyxis/templates/driver-deployment.yaml @@ -35,6 +35,8 @@ spec: env: - name: PUPPIS_DRIVER_CONFIG value: /etc/puppis/driver.json + - name: PUPPIS_DRIVER_STATE + value: /var/lib/puppis securityContext: privileged: true volumeMounts: @@ -46,6 +48,8 @@ spec: mountPath: /run/carina - name: recordings mountPath: /srv/recordings + - name: state + mountPath: /var/lib/puppis {{- if $driver.pcscd.enabled }} - name: pcscd mountPath: /run/pcscd @@ -75,6 +79,8 @@ spec: type: DirectoryOrCreate - name: recordings {{- include "pyxis.volumeSource" (dict "root" . "name" "recordings") | trim | nindent 10 }} + - name: state + {{- include "pyxis.volumeSource" (dict "root" . "name" "state") | trim | nindent 10 }} {{- if $driver.pcscd.enabled }} - name: pcscd hostPath: diff --git a/charts/pyxis/templates/pvc.yaml b/charts/pyxis/templates/pvc.yaml index 4e9f39b..7847188 100644 --- a/charts/pyxis/templates/pvc.yaml +++ b/charts/pyxis/templates/pvc.yaml @@ -5,6 +5,7 @@ "captions" .Values.app.enabled "keys" .Values.app.enabled "db" .Values.postgres.enabled + "state" .Values.driver.enabled }} {{- range $name, $needed := $needs }} {{- $spec := index $.Values.persistence $name }} diff --git a/charts/pyxis/values.schema.json b/charts/pyxis/values.schema.json index ee7a03c..2b68b6a 100644 --- a/charts/pyxis/values.schema.json +++ b/charts/pyxis/values.schema.json @@ -221,14 +221,15 @@ "persistence": { "type": "object", "additionalProperties": false, - "required": ["recordings", "encodes", "thumbnails", "captions", "keys", "db"], + "required": ["recordings", "encodes", "thumbnails", "captions", "keys", "db", "state"], "properties": { "recordings": { "$ref": "#/$defs/storage" }, "encodes": { "$ref": "#/$defs/storage" }, "thumbnails": { "$ref": "#/$defs/storageOrEmptyDir" }, "captions": { "$ref": "#/$defs/storageOrEmptyDir" }, "keys": { "$ref": "#/$defs/storage" }, - "db": { "$ref": "#/$defs/storage" } + "db": { "$ref": "#/$defs/storage" }, + "state": { "$ref": "#/$defs/storageOrEmptyDir" } } } }, diff --git a/charts/pyxis/values.yaml b/charts/pyxis/values.yaml index a3c8719..427d05c 100644 --- a/charts/pyxis/values.yaml +++ b/charts/pyxis/values.yaml @@ -170,7 +170,7 @@ route: # IngressRoute の tls。{} なら Traefik の既定の証明書、null なら http tls: {} -# ボリュームごとに type を pvc、existingClaim、hostPath から選ぶ。thumbnails と captions は emptyDir も選べる +# ボリュームごとに type を pvc、existingClaim、hostPath から選ぶ。thumbnails、captions、state は emptyDir も選べる persistence: recordings: # 録画。driver が書き込み、app は読み取り専用でマウントする @@ -274,3 +274,20 @@ persistence: path: "" # hostPath のときの type type: Directory + state: + # チューナーと局の組み合わせごとの受信の記録。driver が書き込む。emptyDir なら Pod と一緒に消え、driver が測り直す + type: pvc + # pvc のときのサイズ + size: 100Mi + # pvc のときの storageClassName。空なら既定、"-" なら無し + storageClass: "" + # pvc のときの accessModes + accessModes: + - ReadWriteOnce + # existingClaim のときの PVC の名前 + existingClaim: "" + hostPath: + # hostPath のときのホスト側のパス + path: "" + # hostPath のときの type + type: Directory diff --git a/scripts/check-rendering.sh b/scripts/check-rendering.sh index 29c9e73..a378bcf 100755 --- a/scripts/check-rendering.sh +++ b/scripts/check-rendering.sh @@ -1,7 +1,9 @@ #!/usr/bin/env bash # チャートのレンダリング結果が満たすべき条件を、ci/default-values.yaml でレンダリングした結果に対して確かめる。 # Pod のテンプレートにチャートのバージョン (helm.sh/chart) を入れない。ConfigMap の checksum は driver の Pod にだけ付ける。 -# リリース名 carina でレンダリングすると Service が carina-app・carina-db・carina-vela になる +# リリース名 carina でレンダリングすると Service が carina-app・carina-db・carina-vela になる。 +# driver の PUPPIS_DRIVER_STATE は state のボリュームのマウント先と同じパスを指す。 +# Pod が参照する PVC は、ci/default-values.yaml でも driver だけの ci/driver-only-values.yaml でも、すべてチャートが作る set -euo pipefail cd "$(dirname "$0")/.." @@ -58,5 +60,31 @@ if [ "$services" != 'carina-app carina-db carina-vela ' ]; then status=1 fi +# PUPPIS_DRIVER_STATE がボリュームの無いパスを指すと、driver は受信の記録を保存できず、エラーにもならない +state_env=$(printf '%s\n' "$rendered" | awk '/^ *- name: PUPPIS_DRIVER_STATE$/ { getline; print $2 }') +state_mount=$(printf '%s\n' "$rendered" | awk '/^ *- name: state$/ { getline; if ($1 == "mountPath:") print $2 }') +if [ -z "$state_env" ] || [ "$state_env" != "$state_mount" ]; then + echo "driver の PUPPIS_DRIVER_STATE (${state_env:-無し}) が state のボリュームのマウント先 (${state_mount:-無し}) と違う" >&2 + status=1 +fi + +claims_not_made() { + awk ' + /^---/ { kind = ""; name = "" } + /^kind: / { kind = $2 } + /^ name: / && name == "" { name = $2; if (kind == "PersistentVolumeClaim") made[name] = 1 } + /^ *claimName: / { wanted[$2] = 1 } + END { for (claim in wanted) if (!(claim in made)) print claim } + ' | sort | tr '\n' ' ' +} +driver_only=$(helm template carina charts/pyxis -f charts/pyxis/ci/driver-only-values.yaml) +for output in "$rendered" "$driver_only"; do + missing=$(printf '%s\n' "$output" | claims_not_made) + if [ -n "$missing" ]; then + echo "Pod が参照する PVC をチャートが作っていない: $missing" >&2 + status=1 + fi +done + [ "$status" = 0 ] && echo 'レンダリング結果は条件をすべて満たしている' exit "$status" From 87d65b6fe0c5c21b469e08898b9769d80f04188f Mon Sep 17 00:00:00 2001 From: fyui001 Date: Fri, 20 Nov 2026 10:52:54 +0900 Subject: [PATCH 4/4] =?UTF-8?q?README=20=E3=81=A8=20USB=20=E3=83=81?= =?UTF-8?q?=E3=83=A5=E3=83=BC=E3=83=8A=E3=83=BC=E3=81=AE=E3=82=B5=E3=83=B3?= =?UTF-8?q?=E3=83=97=E3=83=AB=E3=81=AB=20PIX-DT295=20=E3=81=A8=E5=8F=97?= =?UTF-8?q?=E4=BF=A1=E3=81=AE=E8=A8=98=E9=8C=B2=E3=81=AE=E3=83=9C=E3=83=AA?= =?UTF-8?q?=E3=83=A5=E3=83=BC=E3=83=A0=E3=82=92=E6=9B=B8=E3=81=8F=E3=80=82?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude --- README.md | 14 ++++++++++---- examples/tuner-usb.yml | 2 +- 2 files changed, 11 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 009a160..f2b851d 100644 --- a/README.md +++ b/README.md @@ -12,8 +12,8 @@ B-CAS カードを 1 枚しか持っていなくても、別の機械のチュ - Docker 25 以上と Docker Compose v2。CPU は amd64 - 録画用のディスク。地上波の録画は 1 時間あたり約 7 GB -- チューナー。Linux DVB で `/dev/dvb/adapterN` として見える PCIe・USB のカード、または USB チューナーの CECH-ZD1 -- B-CAS カードとカードリーダー。ホストで pcscd を動かしておきます +- チューナー。Linux DVB で `/dev/dvb/adapterN` として見える PCIe・USB のカード、または USB チューナーの CECH-ZD1 か PIX-DT295 +- B-CAS カードとカードリーダー。ホストで pcscd を動かしておきます。PIX-DT295 は本体のスロットに挿したカードを使います - Intel の GPU か NVIDIA の GPU(任意)。NVIDIA は NVIDIA Container Toolkit とドライバ 530.41.03 以上が要ります。H.265 と AV1 のエンコード、ライブと再生の変換に使います チューナーとカードが無い機械でも、擬似チューナーで画面を開くところまでは試せます。 @@ -29,7 +29,9 @@ mkdir -p /srv/tv/{db,recordings,encodes,keys} `.env` にデータベースのパスワードと、データを置く 4 つのディレクトリを書きます。\ 次に `driver/driver.json` をチューナーに合わせます。\ -DVB と USB のサンプルが `driver/examples/` にあります。 +DVB と USB のサンプルが `driver/examples/` にあります。\ +USB のサンプルは CECH-ZD1 と PIX-DT295 のどちらにも使えます。\ +PIX-DT295 は 1 台で地上波か衛星のどちらか一方を受信するので、`kind` に `terrestrial` か `satellite` を書きます。 ```bash cp driver/examples/driver-dvb.json driver/driver.json @@ -69,6 +71,9 @@ docker compose logs app | grep 'Sign in as' 番組表の収集間隔や品質の閾値などの細かい設定は Carina の README にあります。\ 変えるときは `compose.override.yml` を置き、`app` の `environment` に書きます。 +driver は、チューナーと局の組み合わせごとの受信の記録をボリューム `driver-state` に保存します。\ +同じ局を受信できるチューナーが複数空いているときは、記録の良いチューナーを使います。 + ## 更新 ```bash @@ -97,7 +102,8 @@ helm install carina oci://ghcr.io/newworldorg/charts/pyxis --version 0.7.0 -n tv ``` 値の一覧と説明は `charts/pyxis/values.yaml` にあります。\ -driver は特権コンテナなので、名前空間の Pod Security は `privileged` にしてください。 +driver は特権コンテナなので、名前空間の Pod Security は `privileged` にしてください。\ +driver の受信の記録は `persistence.state` のボリュームに保存し、既定は 100Mi の PVC です。 ## バージョン diff --git a/examples/tuner-usb.yml b/examples/tuner-usb.yml index 92dcaf2..795cb5d 100644 --- a/examples/tuner-usb.yml +++ b/examples/tuner-usb.yml @@ -1,4 +1,4 @@ -# USB の地上デジタルチューナー (CECH-ZD1) を driver に渡す。 +# USB チューナー (CECH-ZD1 と PIX-DT295) を driver に渡す。 # 挿し直すとデバイスノードの番号が変わる。devices で渡すとコンテナを作成したときのデバイスノードしか見えないので、 # /dev/bus/usb をマウントし、USB デバイス (メジャー番号 189) へのアクセスを device cgroup で許可する services: