v25.05 - Docker configuration update

[fracz]

WAŻNA AKTUALIZACJA KONFIGURACJI DOCKERA w SUPLA

Przygotowaliśmy dużą aktualizację naszej konfiguracji dockerowej, która niesie ze sobą kilka istotnych zmian oraz planowane zakończenie wsparcia dla starszych wersji oprogramowania i architektur.

Najważniejsze informacje (TL;DR):

Po sierpniu 2025 przestajemy wspierać MySQL v5 oraz wymagamy Docker v24+ i Docker Compose v2.25+

Z końcem grudnia 2025 przestajemy wspierać architektury ARMv6 oraz ARMv7 (x32)

Zaplanuj aktualizację swojego środowiska do końca wakacji.

Zmiany w szczegółach:

Od wersji v25.05 oznaczyliśmy jako przestarzałe wsparcie dla MySQL v5 oraz oddzielnych plików docker-compose.ARCHITEKTURA.yml. Przy próbie uruchomienia stosu z taką konfiguracją otrzymacie w terminalu odpowiednie ostrzeżenia.

Używamy teraz wieloplatformowych buildów, które automatycznie wykrywają architekturę i ściągają odpowiednie obrazy.

Zalecane architektury to x86_64 / amd64 oraz arm64 / aarch64 (np. 64-bitowy Raspberry Pi OS).

Od 2026 roku nie będziemy wydawać kontenerów SUPLA dla ARMv7.

Zmieniamy również zalecane proxy na Nginx Proxy Manager.

Nowe instalacje na systemach x32 zakończą się błędem z sugestią przejścia od razu na docelową architekturę.

Jak się przygotować / zaktualizować?

Udostępniliśmy kompletną instrukcję aktualizacji oraz migracji danych, która krok po kroku przeprowadzi Cię przez cały proces.

Docker stack upgrade 2025

Zachęcamy do jak najszybszej aktualizacji, szczególnie jeśli korzystasz ze starszych systemów.

Czy mogę nic nie robić?

Narazie tak. Przy aktualizacji jak zawsze Twoja SUPLA powinna nadal działać i mieć się dobrze. Jedyna różnica, którą zobaczysz, to ostrzeżenia pojawiające się przy restartowaniu lub aktualizacji. Dobrze jednak będzie, jeśli zaplanujesz aktualizację swojej infrastruktury do końca wakacji. Unikniesz tym samym późniejszych problemów.

W razie pytań – piszcie śmiało w tym wątku! Będę na bieżąco uzupełniać FAQ o napotkane problemy i powtarzające się pytania.

[fracz]

FAQ

Komendy mysql i mysqldump nie są rozpoznawane. Jak pracować z backupami?

W nowej konfiguracji używamy MariaDB, dlatego komendy to odpowiednio mariadb oraz mariadb-dump. Jeśli znalazłeś / znalazłaś instrukcje bezpośredniej pracy z bazą danych SUPLI, musisz dostosować nazwy tych komend.

Baza danych nie uruchamia się, a w logach jest błąd Can't initialize timers

Masz Dockera starszego niż v20.10. Zaktualizuj Dockera przed aktualizacją bazy danych. link

Urządzenia się podłączyły, telefony też, a SUPLA Cloud nie działa i się restartuje

Najprawdopodobniej przy uruchomieniu nowej infrastruktury w pliku .env instała konfiguracja pierwszego użytkownika (FIRST_USER_EMAIL). Usuń nowe kontenery i powtórz instalację bez uzupełniania zmiennych dotyczących nowego użytkownika.

[lukfud]

No i pojawił się pierwszy problem

Po przywróceniu bazy Cloud się restartuje z takim oto błędem:

Code: Select all

In EntityNotFoundException.php line 33:                                
Entity of type 'SuplaBundle\Entity\Main\IODevice' for IDs id(9) was not found

[fracz]

Potrzebuję więcej kontekstu. Kiedy ten problem się pojawia? Przy starcie aplikacji czy już przy jej używaniu? Czy były jakieś problemy przy tworzeniu lub odtwarzaniu backupu?

[lukfud]

Potrzebuję więcej kontekstu. Kiedy ten problem się pojawia? Przy starcie aplikacji czy już przy jej używaniu? Czy były jakieś problemy przy tworzeniu lub odtwarzaniu backupu?

Problem pojawił się od razu po przywróceniu bazy (przeszło bez błędów) i restarcie kontenerów. Baza i serwer wstały, a Cloud się restartuje cały czas.
Urządzenia się łączą i działają, aplikacja także.

Code: Select all

Database connection has been established.

 [OK] Metadata storage synchronized                                             


 [OK] Already at the latest version                                             
      ("SuplaBundle\Migrations\Migration\Version20250104154701")                


 [OK] The "async" transport was set up successfully.                            


Creating SQL procedures and views
=================================

Number of scripts to execute: 32

Procedures
----------

✅ supla_add_channel.sql
✅ supla_add_client.sql
✅ supla_add_em_current_log_item.sql
✅ supla_add_em_power_active_log_item.sql
✅ supla_add_em_voltage_aberration_log_item.sql
✅ supla_add_em_voltage_log_item.sql
✅ supla_add_iodevice.sql
✅ supla_calculate_channel_checksum.sql
✅ supla_current_weekday_hour.sql
✅ supla_is_now_active.sql
✅ supla_mark_gate_closed.sql
✅ supla_mark_gate_open.sql
✅ supla_mqtt_broker_auth.sql
✅ supla_set_channel_caption.sql
✅ supla_set_channel_group_caption.sql
✅ supla_set_channel_json_config.sql
✅ supla_set_closing_attempt.sql
✅ supla_set_device_json_config.sql
✅ supla_set_location_caption.sql
✅ supla_set_scene_caption.sql
✅ supla_update_channel_conflict_details.sql
✅ supla_update_channel_flags.sql
✅ supla_update_channel_functions.sql
✅ supla_update_channel_state.sql
✅ supla_update_client.sql
✅ supla_update_device_pairing_result.sql
✅ supla_update_iodevice.sql
✅ supla_update_push_notification_client_token.sql
✅ supla_update_subdevice.sql

Views
-----

✅ supla_v_accessid_active.sql
✅ supla_v_auto_gate_closing.sql
✅ supla_v_client_channel.sql


In EntityNotFoundException.php line 33:
                                                                               
  Entity of type 'SuplaBundle\Entity\Main\IODevice' for IDs id(9) was not fou  
  nd                                                                           
                                                                               

supla:initialize:move-dependent-channels-to-the-same-location [-h|--help] [-q|--quiet] [-v|vv|vvv|--verbose] [-V|--version] [--ansi] [--no-ansi] [-n|--no-interaction] [-e|--env ENV] [--no-debug] [--] <command>

[fracz]

Wyjaśniamy na priv

[lukfud]

Udało się

Błędem było przywrócenie bazy (bez jej usuwania) po tym jak wszystkie urządzenia zdążyły się ponownie zarejestrować na czystej instalacji i zrobił się mały bałagan.

@fracz poprawił nieco instrukcję, aby taka sytuacja nikomu się już nie przydarzyła.

[kris.sg]

To ja jeszcze dopytam, czy w nowym env wpisy:

Code: Select all

DB_PASSWORD=
SECRET=

kopiuję ze starego env ?

[fracz]

Nie. Powinny zostać te które się wygenerują. Dopisałem do instrukcji.

[winek1986]

Migracja przeszła bez problemu.

Code: Select all

x86_64 Debian GNU/Linux 12 (bookworm)