fix(deploy): preserve host preland config

This commit is contained in:
Panfilov Konstantin committed 2026-10-17 19:17:56 +03:00
1 parent 67379241aa
commit ed1e476cc6
7 files changed
+169 -21

No files matched your search

+80 -7
View File
@@ -6,7 +6,8 @@ name: deploy-preland
# <prefix>_FTP_USER, <prefix>_FTP_PASS (порт 21). Цели независимы: сбой одного хостинга остальные не останавливает.
# Заливаются файлы репозитория (git ls-files), кроме служебных (.gitea/, README.md, AGENTS.md, CLAUDE.md, .gitignore) и тех, что живут
# только на хостинге: requisites.html (реквизиты заполняют на месте — пустой файл из git их бы затёр).
# Рабочий config.json единственный и версионируется: он должен попадать в каждую доставку.
# Рабочий config.json настраивается владельцем на каждом хостинге. Деплой не
# перезаписывает его: он добавляет только отсутствующие обязательные UTM-ключи.
# Единственное контролируемое удаление — завершённая миграция legacy images/demo* после
# smoke новых корневых наборов /1, /2. Прочие файлы на хостинге не удаляются.
@@ -44,11 +45,35 @@ jobs:
steps:
- name: Install tools (Alpine)
run: apk add --no-cache git curl
run: apk add --no-cache git curl php83-cli
- name: Checkout repository
uses: actions/checkout@v4
- name: Preserve host config and add focus if absent
env:
FTP_HOST: ${{ secrets[format('{0}_FTP_HOST', matrix.prefix)] }}
FTP_USER: ${{ secrets[format('{0}_FTP_USER', matrix.prefix)] }}
FTP_PASS: ${{ secrets[format('{0}_FTP_PASS', matrix.prefix)] }}
run: |
set -eu
[ -n "$FTP_HOST" ] && [ -n "$FTP_USER" ] && [ -n "$FTP_PASS" ] || { echo "нет секретов ${{ matrix.prefix }}_FTP_*"; exit 1; }
dir=$(printf '%s' "$REMOTE_DIR" | sed 's#^/*##; s#/*$##')
umask 077
netrc=$(mktemp); config=$(mktemp)
trap 'rm -f "$netrc" "$config"' EXIT
printf 'machine %s login %s password %s\n' "$FTP_HOST" "$FTP_USER" "$FTP_PASS" > "$netrc"
curl -sS --ssl-reqd --netrc-file "$netrc" --fail --retry 3 \
"ftp://$FTP_HOST/${dir:+$dir/}config.json" -o "$config"
changed=0
php bin/ensure-focus-config.php "$config" || changed=$?
case "$changed" in
0) ;;
10) curl -sS --ssl-reqd --netrc-file "$netrc" --ftp-create-dirs --retry 3 --fail \
-T "$config" "ftp://$FTP_HOST/${dir:+$dir/}config.json" ;;
*) exit "$changed" ;;
esac
- name: Upload over FTP (TLS)
env:
FTP_HOST: ${{ secrets[format('{0}_FTP_HOST', matrix.prefix)] }}
@@ -63,7 +88,7 @@ jobs:
netrc=$(mktemp); list=$(mktemp)
trap 'rm -f "$netrc" "$list"' EXIT
printf 'machine %s login %s password %s\n' "$FTP_HOST" "$FTP_USER" "$FTP_PASS" > "$netrc"
git ls-files | grep -vE '^(\.gitea/|README\.md$|AGENTS\.md$|CLAUDE\.md$|\.gitignore$|requisites\.html$)' > files.txt
git ls-files | grep -vE '^(\.gitea/|README\.md$|AGENTS\.md$|CLAUDE\.md$|\.gitignore$|requisites\.html$|config\.json$)' > files.txt
# имя уходит в адрес 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 вместо соединения на файл
@@ -100,11 +125,35 @@ jobs:
REMOTE_DIR: domains/zoomstage.online
steps:
- name: Install tools
run: apt-get update && DEBIAN_FRONTEND=noninteractive apt-get install -y --no-install-recommends ca-certificates git curl openssh-client sshpass
run: apt-get update && DEBIAN_FRONTEND=noninteractive apt-get install -y --no-install-recommends ca-certificates git curl openssh-client sshpass php-cli
- name: Checkout staging branch
run: git clone --depth 1 --branch staging http://git.dira89kv.beget.tech:3000/anton/preland.git .
- name: Preserve host config and add focus if absent
env:
SFTP_HOST: ${{ secrets.ZOOMPIXEL_SFTP_HOST }}
SFTP_USER: ${{ secrets.ZOOMPIXEL_SFTP_USER }}
SFTP_PASS: ${{ secrets.ZOOMPIXEL_SFTP_PASS }}
SFTP_KNOWN_HOSTS: ${{ secrets.ZOOMPIXEL_SFTP_KNOWN_HOSTS }}
run: |
set -eu
[ -n "$SFTP_HOST" ] && [ -n "$SFTP_USER" ] && [ -n "$SFTP_PASS" ] && [ -n "$SFTP_KNOWN_HOSTS" ] || { echo "не заданы секреты ZOOMPIXEL_SFTP_*"; exit 1; }
umask 077
known_hosts=$(mktemp); batch=$(mktemp); config=$(mktemp)
trap 'rm -f "$known_hosts" "$batch" "$config"' EXIT
printf '%s\n' "$SFTP_KNOWN_HOSTS" > "$known_hosts"
printf '%s\n' "get -p $REMOTE_DIR/config.json $config" > "$batch"
SSHPASS="$SFTP_PASS" sshpass -e sftp -oBatchMode=no -oStrictHostKeyChecking=yes -oUserKnownHostsFile="$known_hosts" "$SFTP_USER@$SFTP_HOST" < "$batch"
changed=0
php bin/ensure-focus-config.php "$config" || changed=$?
case "$changed" in
0) ;;
10) printf '%s\n' "put -p $config $REMOTE_DIR/config.json" > "$batch"
SSHPASS="$SFTP_PASS" sshpass -e sftp -oBatchMode=no -oStrictHostKeyChecking=yes -oUserKnownHostsFile="$known_hosts" "$SFTP_USER@$SFTP_HOST" < "$batch" ;;
*) exit "$changed" ;;
esac
- name: Upload over SFTP
env:
SFTP_HOST: ${{ secrets.ZOOMPIXEL_SFTP_HOST }}
@@ -121,7 +170,7 @@ jobs:
dirs=$(mktemp)
trap 'rm -f "$known_hosts" "$batch" "$files" "$dirs"' EXIT
printf '%s\n' "$SFTP_KNOWN_HOSTS" > "$known_hosts"
git ls-files | grep -vE '^(\.gitea/|README\.md$|AGENTS\.md$|CLAUDE\.md$|\.gitignore$|requisites\.html$)' > "$files"
git ls-files | grep -vE '^(\.gitea/|README\.md$|AGENTS\.md$|CLAUDE\.md$|\.gitignore$|requisites\.html$|config\.json$)' > "$files"
if grep -q '[^A-Za-z0-9._/-]' "$files"; then echo "имена с недопустимыми символами:"; grep '[^A-Za-z0-9._/-]' "$files"; exit 1; fi
printf '%s\n' "-mkdir $REMOTE_DIR" > "$batch"
while read -r file; do
@@ -198,11 +247,35 @@ jobs:
REMOTE_DIR: ${{ matrix.dir }}
steps:
- name: Install tools
run: apt-get update && DEBIAN_FRONTEND=noninteractive apt-get install -y --no-install-recommends ca-certificates git curl openssh-client sshpass
run: apt-get update && DEBIAN_FRONTEND=noninteractive apt-get install -y --no-install-recommends ca-certificates git curl openssh-client sshpass php-cli
- name: Checkout production branch
run: git clone --depth 1 --branch main http://git.dira89kv.beget.tech:3000/anton/preland.git .
- name: Preserve host config and add focus if absent
env:
SFTP_HOST: ${{ secrets.ZOOMPIXEL_SFTP_HOST }}
SFTP_USER: ${{ secrets.ZOOMPIXEL_SFTP_USER }}
SFTP_PASS: ${{ secrets.ZOOMPIXEL_SFTP_PASS }}
SFTP_KNOWN_HOSTS: ${{ secrets.ZOOMPIXEL_SFTP_KNOWN_HOSTS }}
run: |
set -eu
[ -n "$SFTP_HOST" ] && [ -n "$SFTP_USER" ] && [ -n "$SFTP_PASS" ] && [ -n "$SFTP_KNOWN_HOSTS" ] || { echo "не заданы секреты ZOOMPIXEL_SFTP_*"; exit 1; }
umask 077
known_hosts=$(mktemp); batch=$(mktemp); config=$(mktemp)
trap 'rm -f "$known_hosts" "$batch" "$config"' EXIT
printf '%s\n' "$SFTP_KNOWN_HOSTS" > "$known_hosts"
printf '%s\n' "get -p $REMOTE_DIR/config.json $config" > "$batch"
SSHPASS="$SFTP_PASS" sshpass -e sftp -oBatchMode=no -oStrictHostKeyChecking=yes -oUserKnownHostsFile="$known_hosts" "$SFTP_USER@$SFTP_HOST" < "$batch"
changed=0
php bin/ensure-focus-config.php "$config" || changed=$?
case "$changed" in
0) ;;
10) printf '%s\n' "put -p $config $REMOTE_DIR/config.json" > "$batch"
SSHPASS="$SFTP_PASS" sshpass -e sftp -oBatchMode=no -oStrictHostKeyChecking=yes -oUserKnownHostsFile="$known_hosts" "$SFTP_USER@$SFTP_HOST" < "$batch" ;;
*) exit "$changed" ;;
esac
- name: Upload over SFTP
env:
SFTP_HOST: ${{ secrets.ZOOMPIXEL_SFTP_HOST }}
@@ -219,7 +292,7 @@ jobs:
dirs=$(mktemp)
trap 'rm -f "$known_hosts" "$batch" "$files" "$dirs"' EXIT
printf '%s\n' "$SFTP_KNOWN_HOSTS" > "$known_hosts"
git ls-files | grep -vE '^(\.gitea/|README\.md$|AGENTS\.md$|CLAUDE\.md$|\.gitignore$|requisites\.html$)' > "$files"
git ls-files | grep -vE '^(\.gitea/|README\.md$|AGENTS\.md$|CLAUDE\.md$|\.gitignore$|requisites\.html$|config\.json$)' > "$files"
if grep -q '[^A-Za-z0-9._/-]' "$files"; then echo "имена с недопустимыми символами:"; grep '[^A-Za-z0-9._/-]' "$files"; exit 1; fi
printf '%s\n' "-mkdir $REMOTE_DIR" > "$batch"
while read -r file; do
+7 -4
View File
@@ -21,10 +21,13 @@
переход напрямую на `/public/upscale` не заменяет передачу владельца через claim.
- `host` задаёт сайт назначения; HTTPS необходим для `crypto.randomUUID()`.
Не обходить серверные правила доступа к загрузке и результату обработки.
- Рабочий `config.json` единственный для всех прилендов: это точная проверенная
конфигурация `zoomstage.online`, и каждый FTP/SFTP-deploy обязан доставлять её на
stage и production. `requisites.html` по-прежнему живёт только на хостинге и не
перезаписывается. Не создавать target-specific конфиги или `config.json.example`.
- Рабочий `config.json` на каждом хостинге настраивает владелец. Деплой не имеет
права перезаписывать его значений. При появлении новой обязательной UTM workflow
получает текущий хостовый конфиг и добавляет только отсутствующий ключ через
`bin/ensure-focus-config.php`; имеющиеся значения, включая уже настроенный
`focus`, остаются байт-в-байт прежними. `requisites.html` также живёт только на
хостинге и не перезаписывается. Не создавать target-specific конфиги или
`config.json.example`.
- Коммит в `main` запускает FTP-автодеплой на все цели workflow; откат через `git revert`
также запускает выкат. Коммит, push и изменения хостинга — только по прямому поручению.
- Проверки кода и браузера проводить в Docker без установки ПО на хост.
+1 -1
View File
@@ -65,7 +65,7 @@ Preland всегда формирует полный resolved-набор сво
| `requisites.html` | реквизиты для подвала (HTML), если в `config.json` нет `requisites`. Без обоих — **заглушка «ИП Иванов Иван Иванович»** из `template.php` |
| `images/`, `fonts/`, `favicon/`, `*.css` | статика; `style.min.css` встраивается в страницу |
| `.htaccess` | только сроки кэширования статики (Apache) |
| `config.json` | единственный версионируемый рабочий конфиг всех прилендов: точная проверенная конфигурация stage `zoomstage.online`; каждый deploy доставляет его на целевой хост |
| `config.json` | схема и стартовое значение конфигурации. Рабочий конфиг на каждом хостинге настраивает владелец; deploy не перезаписывает его значения и добавляет только отсутствующие обязательные UTM-ключи |
### `config.json`
+68
View File
@@ -0,0 +1,68 @@
<?php
/**
* Точечно добавляет новую UTM focus в рабочий конфиг приленда на хостинге.
*
* Значения уже существующих полей конфигурации намеренно не нормализуются и
* не переписываются: владелец настраивает их непосредственно на стенде или
* production. Скрипт возвращает 0, когда focus уже существует, и 10, когда
* ключ добавлен и config.json требуется загрузить обратно.
*
* @usage php bin/ensure-focus-config.php /path/to/config.json
*/
declare(strict_types=1);
if ($argc !== 2) {
fwrite(STDERR, "Использование: php bin/ensure-focus-config.php /path/to/config.json\n");
exit(2);
}
$path = $argv[1];
$raw = @file_get_contents($path);
if ($raw === false) {
fwrite(STDERR, "Не удалось прочитать config.json.\n");
exit(2);
}
try {
$config = json_decode($raw, true, 512, JSON_THROW_ON_ERROR);
} catch (JsonException $exception) {
fwrite(STDERR, "config.json содержит некорректный JSON: {$exception->getMessage()}\n");
exit(2);
}
if (!is_array($config) || !isset($config['utm']) || !is_array($config['utm'])) {
fwrite(STDERR, "В config.json отсутствует объект utm.\n");
exit(2);
}
if (array_key_exists('focus', $config['utm'])) {
fwrite(STDOUT, "focus уже настроен: конфиг не изменён.\n");
exit(0);
}
$config['utm']['focus'] = [
'weights' => [
'center' => 0,
'face' => 1,
],
'default' => 'face',
];
try {
$encoded = json_encode(
$config,
JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES | JSON_THROW_ON_ERROR
) . "\n";
} catch (JsonException $exception) {
fwrite(STDERR, "Не удалось сериализовать config.json: {$exception->getMessage()}\n");
exit(2);
}
if (file_put_contents($path, $encoded, LOCK_EX) === false) {
fwrite(STDERR, "Не удалось записать обновлённый config.json.\n");
exit(2);
}
fwrite(STDOUT, "Добавлен только utm.focus (face включён по умолчанию).\n");
exit(10);
+3 -3
View File
@@ -60,10 +60,10 @@
},
"focus": {
"weights": {
"center": 1,
"face": 0
"center": 0,
"face": 1
},
"default": "center"
"default": "face"
}
}
}
+1 -1
View File
@@ -38,7 +38,7 @@ $expected = [
'bchoice' => 'a',
'chb' => 'b',
'tp' => '1',
'focus' => 'center',
'focus' => 'face',
'utm_source' => 'stage-ad',
'subid' => 'click-42',
];
+9 -5
View File
@@ -2,8 +2,9 @@
/**
* Регрессия единственного рабочего конфига приленда.
*
* Stage-конфиг — единственный канонический конфиг каждого приленда. Он должен
* быть в репозитории и попадать во все FTP/SFTP-доставки без исключений.
* Репозиторный config.json задаёт схему и стартовые значения. Рабочий конфиг
* владельца на хостинге не перезаписывается: delivery добавляет только
* отсутствующие обязательные UTM-ключи.
*/
declare(strict_types=1);
@@ -25,7 +26,7 @@ if (!is_array($config)) {
'bchoice' => ['a' => 1, 'b' => 0, 'default' => 'a'],
'chb' => ['a' => 1, 'b' => 0, 'default' => 'b'],
'tp' => ['1' => 0, '2' => 1, 'default' => '1'],
'focus' => ['center' => 1, 'face' => 0, 'default' => 'center'],
'focus' => ['center' => 0, 'face' => 1, 'default' => 'face'],
];
if (($config['host'] ?? null) !== $expected['host']) {
@@ -58,8 +59,11 @@ foreach ([
'deploy-zoomstage' => $stageBlock,
'deploy-zoompixel-production' => $productionBlock,
] as $delivery => $block) {
if ($block === '' || str_contains($block, 'config\\.json$')) {
$failures[] = "{$delivery} обязан доставлять единый версионируемый config.json.";
if ($block === ''
|| !str_contains($block, 'config\\.json$')
|| !str_contains($block, 'ensure-focus-config.php')
|| !str_contains($block, 'Preserve host config and add focus if absent')) {
$failures[] = "{$delivery} обязан сохранять хостовый config.json и добавлять только отсутствующий focus.";
}
}