Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 11 additions & 6 deletions .github/e2e.sh
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,12 @@ set -euo pipefail

REPO="${1:?uso: e2e.sh <diretorio-do-checkout>}"
PERSIST=/srv/plexden
PLEX_USER=plex
# O usuario da stack nao e mais fixo (era sempre 'plex'): agora e quem rodou o
# install.sh, e nos jobs de CI isso e' 'root' (o container ja roda como root,
# sem sudo). Le do /etc/plexden.conf que o provision.sh gravou, em vez de
# assumir um nome.
PLEX_USER=$(sed -n 's/^PLEXDEN_USER=//p' /etc/plexden.conf)
PLEX_HOME=$(getent passwd "$PLEX_USER" | cut -d: -f6)
QB=http://127.0.0.1:8081/api/v2
COOKIE=/tmp/qb.cookie
QB_USER=citest
Expand All @@ -35,7 +40,7 @@ diagnostico() {
curl -s --max-time 10 "$QB/app/webapiVersion" || true; echo
echo "--- [Preferences] do qBittorrent.conf ---"
grep -A15 '\[Preferences\]' \
"/home/$PLEX_USER/.config/qBittorrent/qBittorrent.conf" 2>/dev/null \
"$PLEX_HOME/.config/qBittorrent/qBittorrent.conf" 2>/dev/null \
| sed 's/\(Password_PBKDF2=\).*/\1<omitido>/' | head -15 || true
}
fail() { echo "FALHOU: $*" >&2; diagnostico >&2; exit 1; }
Expand All @@ -60,7 +65,7 @@ pkg_has plexmediaserver || fail "plexmediaserver nao instalado"
pkg_has qbittorrent-nox || fail "qbittorrent-nox nao instalado"
id "$PLEX_USER" >/dev/null
for f in /etc/init.d/plexmediaserver /usr/local/bin/plex-stack-start \
"/home/$PLEX_USER/bin/plex-start"; do
"$PLEX_HOME/bin/plex-start"; do
[ -x "$f" ] || fail "$f nao e executavel"
done
grep -qx "PLEXDEN_HOME=$PERSIST" /etc/plexden.conf || fail "/etc/plexden.conf errado"
Expand All @@ -71,7 +76,7 @@ for d in movies series config scripts cloudflared \
done
[ "$(stat -c %U "$PERSIST/movies")" = "$PLEX_USER" ] || fail "dono errado em movies/"
[ "$(stat -c %a "$PERSIST/cloudflared")" = 700 ] || fail "cloudflared/ deveria ser 700"
grep -q 'plexden postprocess' "/home/$PLEX_USER/.config/qBittorrent/qBittorrent.conf" \
grep -q 'plexden postprocess' "$PLEX_HOME/.config/qBittorrent/qBittorrent.conf" \
|| fail "AutoRun nao aponta para o plexden"
echo " ok"

Expand All @@ -96,9 +101,9 @@ log "credentials.env -> reprovisiona -> 'plexden qb' loga"
printf 'QB_USER=%s\nQB_PASS=%s\n' "$QB_USER" "$QB_PASS" > "$PERSIST/credentials.env"
bash "$PERSIST/provision.sh"
[ "$(stat -c %a "$PERSIST/credentials.env")" = 600 ] || fail "credentials.env sem 600"
grep -qx "QB_USER=$QB_USER" "/home/$PLEX_USER/.qbcreds" || fail ".qbcreds nao regenerado"
grep -qx "QB_USER=$QB_USER" "$PLEX_HOME/.qbcreds" || fail ".qbcreds nao regenerado"
grep -q 'WebUI\\Password_PBKDF2=' \
"/home/$PLEX_USER/.config/qBittorrent/qBittorrent.conf" || fail "senha nao sedeada"
"$PLEX_HOME/.config/qBittorrent/qBittorrent.conf" || fail "senha nao sedeada"
# o que importa: a senha sedeada realmente autentica
su - "$PLEX_USER" -c 'plexden qb list' || fail "'plexden qb list' nao autenticou"

Expand Down
44 changes: 10 additions & 34 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -44,23 +44,12 @@ jobs:
include:
- image: debian:stable-slim
pkg: apt-get
plexpkg: plexmediaserver
tier: 1
- image: fedora:latest
pkg: dnf
plexpkg: plexmediaserver
tier: 1
- image: almalinux:9
pkg: dnf
plexpkg: plexmediaserver
tier: 2
- image: opensuse/leap:latest
pkg: zypper
plexpkg: plexmediaserver
tier: 1
- image: archlinux:latest
pkg: pacman
plexpkg: plex-media-server
tier: 2
container:
image: ${{ matrix.image }}
Expand All @@ -72,14 +61,6 @@ jobs:
apt-get install -y -qq python3 git
elif command -v dnf >/dev/null 2>&1; then
dnf install -y -q python3 git
elif command -v zypper >/dev/null 2>&1; then
# sem o refresh, os metadados da imagem ficam atras dos mirrors e a
# instalacao morre com 404 em pacote que ja rodou de versao
zypper -n --gpg-auto-import-keys refresh
zypper -n install python3 git
elif command -v pacman >/dev/null 2>&1; then
pacman -Sy --noconfirm --needed archlinux-keyring
pacman -S --noconfirm --needed python git
fi

- uses: actions/checkout@v5
Expand All @@ -90,9 +71,7 @@ jobs:
echo "$out"
echo "$out" | grep -q "gerenciador detectado: ${{ matrix.pkg }}"
echo "$out" | grep -q "plexden: sintaxe Python OK"
# no Arch o pacote e plex-media-server: checar o nome errado fazia o
# provision repetir "instale pelo AUR" com o Plex ja instalado
echo "$out" | grep -q "pacote do plex: ${{ matrix.plexpkg }}"
echo "$out" | grep -q "pacote do plex: plexmediaserver"
# o tier anunciado ao usuario precisa dizer a verdade sobre ESTA
# distro: 1 so onde o e2e instala de fato, 2 onde e' so dry-run
echo "$out" | grep -q "Tier ${{ matrix.tier }} —"
Expand All @@ -109,7 +88,7 @@ jobs:
# sistema.
#
# Duas imagens: o Debian estavel e o Ubuntu LTS. O Ubuntu nao esta ai so por
# ser derivado popular — ele empacota uma serie 4.x do qBittorrent, e as tres
# ser derivado popular — ele empacota uma serie 4.x do qBittorrent, e as
# outras imagens do CI trazem 5.x. Sem ele, o ramo pause/resume do gate de
# versao da Web API nunca seria exercitado: so o stop/start do qB 5.
e2e-deb:
Expand Down Expand Up @@ -143,7 +122,6 @@ jobs:
- name: install.sh completo (instala e sobe a stack)
env:
PLEXDEN_HOME: /srv/plexden
PLEXDEN_USER: plex
run: PLEXDEN_RAW="file://$PWD" bash install.sh

- name: Bateria de verificacao
Expand All @@ -153,16 +131,16 @@ jobs:
if: failure()
run: |
tail -n 60 /srv/plexden/config/*.log 2>/dev/null || true
ls -la /srv/plexden /home/plex 2>/dev/null || true
cat /home/plex/.config/qBittorrent/qBittorrent.conf 2>/dev/null || true
ls -la /srv/plexden /root 2>/dev/null || true
cat /root/.config/qBittorrent/qBittorrent.conf 2>/dev/null || true

# ------------------------------------------------------ e2e com systemd ---
# Mesmo teste nas familias que empacotam o Plex em .rpm. Aqui nao da para usar
# Mesma familia RPM, mas com o Plex empacotado em .rpm. Aqui nao da para usar
# 'container:' como no Debian: o .rpm do Plex tem um scriptlet %pre que aborta
# a instalacao com "Plex Media Server requires systemd" — o .deb nao faz isso.
# Entao o job constroi uma imagem com systemd e a roda privilegiada, para o
# PID 1 ser systemd de verdade. Sem isso, os ramos dnf e zypper do
# provision.sh sao impossiveis de exercitar.
# PID 1 ser systemd de verdade. Sem isso, o ramo dnf do provision.sh e
# impossivel de exercitar.
e2e-systemd:
runs-on: ubuntu-latest
timeout-minutes: 30
Expand All @@ -172,8 +150,6 @@ jobs:
include:
- image: fedora:latest
deps: dnf -y install systemd procps-ng && dnf clean all
- image: opensuse/leap:latest
deps: zypper -n --gpg-auto-import-keys refresh && zypper -n install systemd procps && zypper clean -a
steps:
- uses: actions/checkout@v5

Expand Down Expand Up @@ -203,7 +179,7 @@ jobs:
# /srv/plexden do container — igual ao que faz baixando da internet.
- name: install.sh completo (instala e sobe a stack)
run: |
docker exec -e PLEXDEN_HOME=/srv/plexden -e PLEXDEN_USER=plex \
docker exec -e PLEXDEN_HOME=/srv/plexden \
-e PLEXDEN_RAW=file:///repo plexden-e2e bash /repo/install.sh

- name: Bateria de verificacao
Expand All @@ -213,8 +189,8 @@ jobs:
if: failure()
run: |
docker exec plexden-e2e sh -c 'tail -n 60 /srv/plexden/config/*.log' 2>/dev/null || true
docker exec plexden-e2e ls -la /srv/plexden /home/plex 2>/dev/null || true
docker exec plexden-e2e cat /home/plex/.config/qBittorrent/qBittorrent.conf 2>/dev/null || true
docker exec plexden-e2e ls -la /srv/plexden /root 2>/dev/null || true
docker exec plexden-e2e cat /root/.config/qBittorrent/qBittorrent.conf 2>/dev/null || true

# ------------------------------------------------------ urls publicas ---
# O one-liner do README depende dessas URLs; os jobs e2e instalam do checkout
Expand Down
79 changes: 37 additions & 42 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,16 +26,20 @@ curl -fsSL https://raw.githubusercontent.com/pedrorodbit/plexden/main/install.sh
```

> **Sobre distros:** o instalador (e o `plexden update`) detecta sozinho o seu
> gerenciador de pacotes — `apt`, `dnf`/`yum`, `pacman` ou `zypper` — e segue a
> partir daí. O Plex tem repositório oficial nas famílias Debian e RPM; no Arch
> não há pacote oficial, então o instalador te aponta para o AUR e cuida do
> resto. Detalhes na tabela de [distros suportadas](#distros-suportadas).
> gerenciador de pacotes — `apt` ou `dnf`/`yum` — e segue a partir daí. O Plex
> tem repositório oficial em ambas as famílias. Detalhes na tabela de
> [distros suportadas](#distros-suportadas).

Prefere outro caminho ou outro usuário? É só passar por variável de ambiente:
O usuário que roda os serviços é sempre quem está executando a instalação —
quem chamou o `sudo`, ou o próprio `root` se você já está numa sessão root.
Não há mais como escolher outro usuário por variável de ambiente. Já o
caminho onde a stack vive, o instalador **pergunta durante a instalação**
(padrão `/srv/plexden`); prefere pular a pergunta? É só passar por variável
de ambiente:

```bash
curl -fsSL https://raw.githubusercontent.com/pedrorodbit/plexden/main/install.sh \
| sudo PLEXDEN_HOME=/srv/plex PLEXDEN_USER=media bash
| sudo PLEXDEN_HOME=/srv/plex bash
```

Antes de tocar em qualquer coisa, ele te diz duas coisas — e nenhuma delas
Expand Down Expand Up @@ -84,9 +88,7 @@ toda parte; o que muda é como o Plex chega.
| Família | Distros | Gerenciador | Plex | Suporte |
|---|---|---|---|---|
| Debian | Debian, Ubuntu, Mint e derivados | `apt` | pacote oficial | **Tier 1** |
| RPM (Red Hat) | Fedora, RHEL, Rocky, Alma, CentOS Stream | `dnf` / `yum` | pacote oficial | **Tier 1** |
| SUSE | openSUSE, SLES | `zypper` | pacote oficial | **Tier 1** |
| Arch | Arch, Manjaro | `pacman` | via **AUR** (manual) | **Tier 2** |
| RPM | Fedora, RHEL, Rocky, Alma, CentOS Stream | `dnf` / `yum` | pacote oficial | **Tier 1** |

### O que cada tier promete

Expand All @@ -95,9 +97,9 @@ esta diz com o que você pode contar:

| Tier | Promessa | Onde vale |
|---|---|---|
| **1** | instalação completa roda a cada push; regressão segura o merge | Debian estável, Ubuntu 24.04, Fedora, openSUSE Leap |
| **2** | só o dry-run roda a cada push; regressão vira issue, não bloqueia | Arch, AlmaLinux 9 |
| **3** | melhor esforço, sem teste nenhum; issue e PR são bem-vindos | as demais distros das famílias acima — Mint, Rocky, SLES, Manjaro… |
| **1** | instalação completa roda a cada push; regressão segura o merge | Debian estável, Ubuntu 24.04, Fedora |
| **2** | só o dry-run roda a cada push; regressão vira issue, não bloqueia | AlmaLinux 9 |
| **3** | melhor esforço, sem teste nenhum; issue e PR são bem-vindos | as demais distros das famílias acima — Mint, Rocky… |
| **—** | fora de alcance, e não por falta de vontade | Alpine e qualquer sistema musl, NixOS, Gentoo |

O tier vale para a **distro nomeada**, não para a família inteira. Mint herda o
Expand Down Expand Up @@ -127,34 +129,31 @@ vermelho. Os testes simulados não dependem dessa coincidência.
São duas profundidades de teste de instalação, e a diferença é o que separa o
Tier 1 do Tier 2:

- **Instalação completa** — exatamente quatro imagens: `debian:stable-slim`,
`ubuntu:24.04`, `fedora:latest` e `opensuse/leap:latest`. Cada push instala a
stack do zero num container: baixa tudo, sobe os serviços e confere que o Plex
responde em `:32400`, que a WebUI do qBittorrent responde em `:8081` e
autentica com a senha gerada, que `pause`/`resume` de fato mudam o estado do
torrent, que o `postprocess` cria hardlink de verdade na biblioteca e que o
`links --apply` remove o hardlink cuja fonte sumiu — sem tocar num arquivo
colocado na biblioteca por fora.
- **Instalação completa** — exatamente três imagens: `debian:stable-slim`,
`ubuntu:24.04` e `fedora:latest`. Cada push instala a stack do zero num
container: baixa tudo, sobe os serviços e confere que o Plex responde em
`:32400`, que a WebUI do qBittorrent responde em `:8081` e autentica com a
senha gerada, que `pause`/`resume` de fato mudam o estado do torrent, que o
`postprocess` cria hardlink de verdade na biblioteca e que o `links --apply`
remove o hardlink cuja fonte sumiu — sem tocar num arquivo colocado na
biblioteca por fora.

O Ubuntu está aí por um motivo além de ser derivado popular: ele empacota a
série **4.x** do qBittorrent, enquanto as outras três trazem a **5.x**. Como o
série **4.x** do qBittorrent, enquanto as outras trazem a **5.x**. Como o
qB 5 renomeou os endpoints de `pause`/`resume` para `stop`/`start`, é ele que
garante que o lado antigo desse desvio também é exercitado a cada push.
- **Dry-run** — o `provision.sh --check` roda em cinco imagens
(`debian:stable-slim`, `fedora:latest`, `almalinux:9`, `opensuse/leap:latest`,
`archlinux:latest`) e confere que o gerenciador certo foi detectado e que o
`plexden` compila sob o Python de lá. Para **Arch e AlmaLinux esse é o único
nível**: valida detecção e sintaxe, não a instalação em si — foi justamente uma
instalação de verdade que revelou que o openSUSE chama `procps` o que o Fedora
chama `procps-ng`.
- **Dry-run** — o `provision.sh --check` roda também em `almalinux:9` e
confere que o gerenciador certo foi detectado e que o `plexden` compila sob
o Python de lá. Para **AlmaLinux esse é o único nível**: valida detecção e
sintaxe, não a instalação em si.

Quatro ressalvas honestas:
Três ressalvas honestas:

- **Onde o Plex vem em `.rpm`, ele exige systemd.** Não é escolha nossa: o
pacote tem um scriptlet que aborta a instalação com *"Plex Media Server
requires systemd"*. O `.deb` não faz essa checagem — por isso a promessa de
rodar num sistema sem init vale para a família Debian, e não para RPM nem
SUSE. Num Fedora, RHEL ou openSUSE normal (que têm systemd) não muda nada.
rodar num sistema sem init vale para a família Debian, e não para RPM. Num
Fedora ou RHEL normal (que têm systemd) não muda nada.

- **O repositório do Plex nem sempre é aceito — e aí entra o pacote oficial.** O
instalador tenta o repositório primeiro, que é o caminho preferido (deixa o
Expand All @@ -168,16 +167,11 @@ Quatro ressalvas honestas:
| Debian stable | ❌ recusado → cai no pacote oficial |
| Ubuntu LTS | ✅ funciona |
| Fedora | ✅ funciona |
| openSUSE Leap | ✅ funciona |

Quando o repositório é recusado, o instalador **remove a entrada** — senão
todos os seus `apt update` passariam a dar erro daí em diante — e baixa o
pacote oficial direto. Só nesse caso o Plex deixa de ser atualizado pelo
`apt upgrade`; aí use o `plexden update`.
- **Arch** — o Plex não tem pacote oficial. O instalador prepara tudo e te manda
instalar pelo AUR (ex.: `yay -S plex-media-server`); depois é só rodar o
`provision.sh` de novo. O `plexden update`, no Arch, também aponta pro AUR em
vez de baixar `.deb`/`.rpm`.
- **Fedora/RHEL** — se o SELinux estiver em *enforcing*, ele pode barrar o Plex
de seguir os hardlinks da biblioteca ou de varrer pastas fora do lugar
esperado. Se a biblioteca aparecer vazia mesmo com os arquivos lá, olhe o
Expand Down Expand Up @@ -299,10 +293,10 @@ O que cada um faz:
real de 140 arquivos, a varredura identificou 93 pares e deixou 47 de fora.
- **`update`** — o que o repositório entrega costuma ficar atrás da versão mais
nova do Plex (e em algumas distros nem há repositório utilizável), então este
comando baixa o pacote oficial direto (`.deb` ou `.rpm`, conforme a família;
no Arch, aponta pro AUR), faz backup do banco e reinstala. Não exige servidor
reivindicado: sem token ele usa o canal público, e com token respeita o canal
da sua conta. Se a instalação do pacote falhar, ele sai com erro apontando o
comando baixa o pacote oficial direto (`.deb` ou `.rpm`, conforme a família),
faz backup do banco e reinstala. Não exige servidor reivindicado: sem token
ele usa o canal público, e com token respeita o canal da sua conta. Se a
instalação do pacote falhar, ele sai com erro apontando o
backup — em vez de deixar você com o Plex parado e um "Pronto" na tela.

## Problemas comuns
Expand Down Expand Up @@ -357,11 +351,12 @@ O `plexden` procura configuração nesta ordem: variável de ambiente →
| Variável | Default | Para quê |
|---|---|---|
| `PLEXDEN_HOME` | `/srv/plexden` | onde a stack vive (de preferência, um volume que persista) |
| `PLEXDEN_USER` | `plex` | usuário que roda os serviços |
| `PLEXDEN_USER` | *(atual)* | usuário que roda os serviços — sempre quem executou a instalação, não é escolhido à parte |
| `CF_TUNNEL_UUID` | *(auto)* | UUID do túnel; se em branco, ele acha sozinho pelo `*.json` em `cloudflared/` |

O `provision.sh` grava esses valores em `/etc/plexden.conf` — então, se você
rodar de novo mais tarde, ele lembra do que você escolheu.
rodar de novo mais tarde (para reprovisionar), ele lembra do que foi
resolvido na primeira instalação, mesmo que outro admin rode o comando depois.

## Como as peças se encaixam

Expand Down
Loading