{"id":431,"date":"2026-08-31T16:20:00","date_gmt":"2026-08-31T14:20:00","guid":{"rendered":"https:\/\/www.lukaswojcik.com\/?p=431"},"modified":"2026-08-31T14:47:11","modified_gmt":"2026-08-31T12:47:11","slug":"local-ci-cd-raspberry-pi-automating-docker-compose-pl","status":"publish","type":"post","link":"https:\/\/www.lukaswojcik.com\/blog\/pl\/raspberry-pi-pl\/local-ci-cd-raspberry-pi-automating-docker-compose-pl\/","title":{"rendered":"Lokalny CI\/CD dla Raspberry Pi: Automatyzacja wdro\u017ce\u0144 Docker Compose"},"content":{"rendered":"\r\n
Zarz\u0105dzanie skonteneryzowan\u0105 infrastruktur\u0105 na urz\u0105dzeniach typu edge, takich jak Raspberry Pi, cz\u0119sto wi\u0105\u017ce si\u0119 z konieczno\u015bci\u0105 powtarzalnego logowania przez SSH, r\u0119cznego pobierania obraz\u00f3w oraz bezpo\u015bredniego wywo\u0142ywania polece\u0144 Docker Compose. Wdro\u017cenie lokalnego potoku CI\/CD umo\u017cliwia pe\u0142n\u0105 automatyzacj\u0119 cyklu \u017cycia us\u0142ug \u2013 w tym Home Assistant, Nextcloud oraz skrypt\u00f3w w j\u0119zyku Python \u2013 z wykorzystaniem repozytori\u00f3w Git, nas\u0142uchiwaczy Webhook oraz lokalnych agent\u00f3w wdro\u017ceniowych.<\/p>\r\n\r\n\r\n\r\n
1. Architektura lokalnego GitOps na urz\u0105dzeniach Edge<\/h2>\r\n\r\n\r\n\r\n
Zastosowanie metodyki GitOps przenosi centralne \u017ar\u00f3d\u0142o prawdy dla ca\u0142ej konfiguracji infrastruktury ze zmian wprowadzanych lokalnie w systemie plik\u00f3w do centralnego repozytoria Git. Zamiast bezpo\u015bredniej edycji plik\u00f3w YAML na serwerze, wszystkie definicje wdro\u017ceniowe utrzymywane s\u0105 pod kontrol\u0105 wersji.<\/p>\r\n\r\n\r\n\r\n
\r\n
Deklaratywna konfiguracja:<\/strong> Wszystkie us\u0142ugi, definicje sieci oraz wolumeny trwa\u0142e s\u0105 precyzyjnie definiowane w plikach docker-compose.yml<\/code> przechowywanych w repozytorium kodu.<\/li>\r\n
Pe\u0142na historia zmian i wycofania (Rollback):<\/strong> System kontroli wersji zapewnia niemodyfikowalny rejestr modyfikacji, co umo\u017cliwia natychmiastowe przywr\u00f3cenie stabilnego stanu w przypadku wyst\u0105pienia b\u0142\u0119d\u00f3w po aktualizacji.<\/li>\r\n
Bezobs\u0142ugowe wdro\u017cenia:<\/strong> Serwer edge funkcjonuje jako automatyczny konsument stanu repozytorium, co eliminuje potrzeb\u0119 interaktywnego dost\u0119pu do pow\u0142oki systemowej podczas rutynowych aktualizacji.<\/li>\r\n<\/ul>\r\n\r\n\r\n\r\n\n\nUrz\u0105dzenie brzegowe jest konsumentem, nie celem: samo pobiera stan repozytorium i doprowadza sw\u00f3j stos do zgodno\u015bci. Kontrola HMAC jest bram\u0105 \u2014 niezweryfikowany webhook nigdy nie dociera do pobrania.<\/figcaption>\n<\/figure>\n\n
2. Automatyzacja wdro\u017ce\u0144 za pomoc\u0105 Webhook\u00f3w<\/h2>\r\n\r\n\r\n\r\n
W celu ca\u0142kowitego wyeliminowania r\u0119cznych polece\u0144 SSH, na platformie Raspberry Pi da si\u0119 uruchomi\u0107 lekkie serwery Webhook (np. adnanh\/webhook<\/code> lub dedykowane demony automatyzacji). Us\u0142ugi te nas\u0142uchuj\u0105 \u017c\u0105da\u0144 HTTP POST generowanych przez zdarzenia typu push w repozytorium kodu lub przez zewn\u0119trzne systemy CI\/CD.<\/p>\r\n\r\n\r\n\r\n
Przep\u0142yw pracy us\u0142ugi Webhook<\/h3>\r\n\r\n\r\n\r\n
\r\n
Weryfikacja \u017c\u0105da\u0144:<\/strong> Przychodz\u0105ce wywo\u0142ania s\u0105 kryptograficznie sprawdzane za pomoc\u0105 token\u00f3w HMAC w celu zapobiegania nieautoryzowanemu zdalnemu uruchamianiu zada\u0144.<\/li>\r\n
Automatyczna synchronizacja Git:<\/strong> Po pomy\u015blnej weryfikacji lokalna us\u0142uga inicjuje pobranie najnowszej wersji kodu z ga\u0142\u0119zi g\u0142\u00f3wnej repozytorium.<\/li>\r\n
Rekonwergencja stosu:<\/strong> Narz\u0119dzie automatyzuj\u0105ce wykonuje polecenie docker compose up -d --remove-orphans<\/code>, dzi\u0119ki czemu odtwarzane s\u0105 wy\u0142\u0105cznie zmienione obrazy kontener\u00f3w lub zmodyfikowane definicje us\u0142ug.<\/li>\r\n<\/ul>\r\n\r\n\r\n\r\n
3. Zarz\u0105dzanie cyklem \u017cycia kontener\u00f3w bez SSH<\/h2>\r\n\r\n\r\n\r\n
Architektury ci\u0105g\u0142ego wdra\u017cania w \u015brodowiskach self-hosted korzystaj\u0105 z wyspecjalizowanych agent\u00f3w lokalnych, kt\u00f3rzy monitoruj\u0105 rejestry obraz\u00f3w i realizuj\u0105 procesy aktualizacji w spos\u00f3b ca\u0142kowicie bezobs\u0142ugowy.<\/p>\r\n\r\n\r\n\r\n
\r\n
Automatyczne sprawdzanie rejestr\u00f3w:<\/strong> Narz\u0119dzia z rodziny Watchtower cyklicznie weryfikuj\u0105 skr\u00f3ty (digesty) obraz\u00f3w dla uruchomionych kontener\u00f3w i automatycznie restartuj\u0105 us\u0142ugi, gdy dost\u0119pna jest nowa wersja. Pierwotne repozytorium containrrr\/watchtower<\/code> zosta\u0142o zarchiwizowane w grudniu 2025 roku, a starszy projekt Ouroboros nie jest ju\u017c rozwijany; utrzymywane forki spo\u0142eczno\u015bciowe, takie jak nickfedor\/watchtower<\/code>, stanowi\u0105 bezpo\u015bredni zamiennik.<\/li>\r\n
Lokalne budowanie obraz\u00f3w:<\/strong> W przypadku w\u0142asnych skrypt\u00f3w Python lub mikrous\u0142ug lokalny mechanizm mo\u017ce budowa\u0107 pliki Dockerfile bezpo\u015brednio na architekturze ARM, unikaj\u0105c z\u0142o\u017cono\u015bci kompilacji skro\u015bnej.<\/li>\r\n
Kontrola stanu (Health Checks):<\/strong> Zastosowanie natywnych test\u00f3w sprawno\u015bci Docker Health Check gwarantuje natychmiastowe wykrycie b\u0142\u0119d\u00f3w uruchomienia nowych wersji bez konieczno\u015bci r\u0119cznego analizowania log\u00f3w.<\/li>\r\n<\/ul>\r\n\r\n\r\n\r\n
4. Bezpiecze\u0144stwo lokalnych potok\u00f3w CI\/CD<\/h2>\r\n\r\n\r\n\r\n
Udost\u0119pnianie zautomatyzowanych punkt\u00f3w ko\u0144cowych w sieci wymagaj\u0105 \u015bcis\u0142ego rygoru w zarz\u0105dzaniu uprawnieniami. Demony Webhook nigdy nie powinny pracowa\u0107 z uprawnieniami root; dost\u0119p do gniazda Dockera nale\u017cy kontrolowa\u0107 poprzez dedykowane uprawnienia grupowe lub serwery proxy w trybie tylko do odczytu. Ponadto umieszczenie us\u0142ug nas\u0142uchuj\u0105cych w wydzielonym podsieci VLAN do zarz\u0105dzania zapobiega dost\u0119powi z nieautoryzowanych urz\u0105dze\u0144 ko\u0144cowych.<\/p>\r\n\n\n
![\"Pionowy](\"https:\/\/www.lukaswojcik.com\/blog\/wp-content\/uploads\/diagrams\/raspberry-pi-lokalny-cicd-pipeline-pl.png\")
\n