Автодеплой на несколько доменов с разными хостингами: цели — matrix (url, префикс секретов, каталог на FTP)

Цель — домен со своим хостингом: секреты <prefix>_FTP_HOST/USER/PASS ищутся по имени (проверено пробой на раннере),
dir — каталог сайта на FTP ("" — корень). Цели независимы (fail-fast: false), проверка страницы — у каждой своя.
config.json и requisites.html живут на хостинге каждой цели (в репозитории — только config.json.example), деплой их
не трогает; без config.json проверка новой цели падает. README: как добавить домен.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

.gitea/workflows/deploy.yml

@@ -1,7 +1,8 @@
 name: deploy-preland
 
-# После коммита в main — заливка на хостинг преленда (beget, FTP с TLS) и проверка страницы.
+# После коммита в main — заливка преленда на хостинги всех целей (FTP с TLS) и проверка страницы каждой цели.
-# Реквизиты — секреты репозитория PRELAND_FTP_HOST, PRELAND_FTP_USER, PRELAND_FTP_PASS (порт 21).
+# Цель — домен со своим хостингом (список — matrix ниже): реквизиты — секреты репозитория <prefix>_FTP_HOST,
+# <prefix>_FTP_USER, <prefix>_FTP_PASS (порт 21). Цели независимы: сбой одного хостинга остальные не останавливает.
 # Заливаются файлы репозитория (git ls-files), кроме служебных (.gitea/, README.md, .gitignore) и тех, что живут
 # только на хостинге: config.json (в git его нет) и requisites.html (реквизиты заполняют на месте — пустой файл
 # из git их бы затёр). На хостинге ничего не удаляется: удалённое из репозитория убирать вручную.
@@ -13,14 +14,28 @@ on:
 
 jobs:
   deploy:
+    name: deploy ${{ matrix.name }}
     runs-on: ubuntu-latest
 
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          # name — имя цели, url — адрес преленда (для проверки), prefix — префикс секретов <prefix>_FTP_*,
+          # dir — каталог сайта на FTP ("" — корень FTP, как на beget). Новый домен — новая запись и три секрета;
+          # config.json (и requisites.html) создают на хостинге цели — без него проверка страницы не пройдёт.
+          - name: barbariskatest
+            url: https://preland.anton.barbariskatest.ru
+            prefix: PRELAND
+            dir: ""
+
     defaults:
       run:
         shell: sh
 
     env:
-      PRELAND_URL: https://preland.anton.barbariskatest.ru
+      PRELAND_URL: ${{ matrix.url }}
+      REMOTE_DIR: ${{ matrix.dir }}
 
     steps:
       - name: Install tools (Alpine)
@@ -31,12 +46,14 @@ jobs:
 
       - name: Upload over FTP (TLS)
         env:
-          FTP_HOST: ${{ secrets.PRELAND_FTP_HOST }}
+          FTP_HOST: ${{ secrets[format('{0}_FTP_HOST', matrix.prefix)] }}
-          FTP_USER: ${{ secrets.PRELAND_FTP_USER }}
+          FTP_USER: ${{ secrets[format('{0}_FTP_USER', matrix.prefix)] }}
-          FTP_PASS: ${{ secrets.PRELAND_FTP_PASS }}
+          FTP_PASS: ${{ secrets[format('{0}_FTP_PASS', matrix.prefix)] }}
         run: |
           set -eu
-          [ -n "$FTP_HOST" ] && [ -n "$FTP_USER" ] && [ -n "$FTP_PASS" ] || { echo "нет секретов PRELAND_FTP_*"; exit 1; }
+          [ -n "$FTP_HOST" ] && [ -n "$FTP_USER" ] && [ -n "$FTP_PASS" ] || { echo "нет секретов ${{ matrix.prefix }}_FTP_*"; exit 1; }
+          dir=$(printf '%s' "$REMOTE_DIR" | sed 's#^/*##; s#/*$##')
+          case "$dir" in *[!A-Za-z0-9._/-]*) echo "недопустимый dir: $dir"; exit 1 ;; esac
           umask 077
           netrc=$(mktemp); list=$(mktemp)
           trap 'rm -f "$netrc" "$list"' EXIT
@@ -45,7 +62,7 @@ jobs:
           # имя уходит в адрес ftp:// как есть — пробелы и прочее экранирование не поддерживаем
           if grep -q '[^A-Za-z0-9._/-]' files.txt; then echo "имена с недопустимыми символами:"; grep '[^A-Za-z0-9._/-]' files.txt; exit 1; fi
           # один curl на все файлы — одно соединение FTP+TLS вместо соединения на файл
-          while read -r f; do printf 'upload-file = "%s"\nurl = "ftp://%s/%s"\n' "$f" "$FTP_HOST" "$f"; done < files.txt > "$list"
+          while read -r f; do printf 'upload-file = "%s"\nurl = "ftp://%s/%s%s"\n' "$f" "$FTP_HOST" "${dir:+$dir/}" "$f"; done < files.txt > "$list"
           curl -sS --ssl-reqd --netrc-file "$netrc" --ftp-create-dirs --retry 3 --fail-early -K "$list"
           echo "залито файлов: $(wc -l < files.txt)"
 

README.md

@@ -123,18 +123,37 @@
 
 ## Автодеплой (Gitea Actions)
 
-`.gitea/workflows/deploy.yml`: после каждого коммита в `main` раннер заливает файлы репозитория на хостинг
+`.gitea/workflows/deploy.yml`: после каждого коммита в `main` раннер заливает файлы репозитория на хостинги **всех
-`https://preland.anton.barbariskatest.ru` по FTP с TLS и проверяет страницу.
+целей** по FTP с TLS и проверяет страницу каждой. Цель — домен со своим хостингом; список целей — `matrix` в workflow:
 
-- **Реквизиты** — секреты репозитория `PRELAND_FTP_HOST`, `PRELAND_FTP_USER`, `PRELAND_FTP_PASS` (Gitea → настройки
+```yaml
-  репозитория → Actions → секреты; порт 21). В коде их нет.
+- name: barbariskatest                       # имя цели (видно в списке прогонов: deploy barbariskatest)
-- **Не заливаются** служебные `.gitea/`, `README.md`, `.gitignore` и то, что живёт только на хостинге: `config.json`
+  url: https://preland.anton.barbariskatest.ru  # адрес преленда — для проверки после заливки
-  и `requisites.html`. Реквизиты заполняют на хостинге, а пустой файл из git их бы затёр. Удалённые из репозитория
+  prefix: PRELAND                            # секреты PRELAND_FTP_HOST, PRELAND_FTP_USER, PRELAND_FTP_PASS
-  файлы на хостинге не стираются — их убирают вручную.
+  dir: ""                                    # каталог сайта на FTP: "" — корень FTP (beget), иначе, например, public_html
-- **Проверка после заливки.** На странице должен быть адрес загрузки на сайте, а не на самом преленде (иначе нет
+```
-  `config.json` с `host`), и переход на `claim`. Иначе прогон падает.
+
-- **Другой домен.** Скопировать workflow, поменять `PRELAND_URL` и завести свои секреты.
+Цели выкатываются независимо (`fail-fast: false`): сбой одного хостинга не останавливает остальные.
-- **Откат** — `git revert` проблемного коммита в `main`: автодеплой зальёт прежнюю версию.
+
+**Новый домен на своём хостинге:**
+1. Домен и HTTPS — как в «Деплой на произвольный домен», шаг 1.
+2. Секреты `<ПРЕФИКС>_FTP_HOST`, `<ПРЕФИКС>_FTP_USER`, `<ПРЕФИКС>_FTP_PASS` (Gitea → настройки репозитория →
+   Actions → секреты; порт 21, FTP с TLS). В коде реквизитов нет.
+3. На хостинге, в каталоге сайта, — `config.json` из `config.json.example`: свой `host`, метки, `requisites`.
+   В репозитории только образец: `config.json` у каждого домена свой и живёт на его хостинге.
+4. Запись в `matrix` — коммит в `main`, автодеплой выкатит все цели. Пока на новом хостинге нет `config.json`,
+   его проверка падает: загрузка ушла бы на сам преленд.
+
+**Что заливается.** Файлы репозитория (`git ls-files`), кроме служебных (`.gitea/`, `README.md`, `.gitignore`)
+и живущих на хостинге `config.json` и `requisites.html`. На хостинге ничего не удаляется: файлы, убранные
+из репозитория, удалять вручную.
+
+**Проверка после заливки.** На странице цели должен быть адрес загрузки на сайте, а не на самом преленде (иначе нет
+`config.json` с `host`), и переход на `claim`. Иначе прогон этой цели падает.
+
+**Откат** — `git revert` проблемного коммита в `main`: автодеплой зальёт прежнюю версию на все цели.
+
+**SFTP.** Сейчас только FTP с TLS. Хостинг без FTP — поле `protocol` в цели и `lftp` вместо curl в шаге заливки.
 
 **Откат вручную.** Перед заменой файлов — копия изменяемых файлов (`index.php`, `components/*`) с хостинга; вернуть их той же
 загрузкой. Новый преленд требует на сайте `/api/images/public/claim` (api с 2026-10-05): со старым api переход