Jak zablokować UID/GID kontenera i właściciela woluminu przed aktualizacją aplikacji hostowanej samodzielnie

Eva Wong jest redaktorką techniczną i rezydentką majsterkowania w ZimaSpace. Jest geekiem od zawsze, z pasją do domowych laboratoriów i oprogramowania open source, a jej specjalnością jest przekładanie złożonych zagadnień technicznych na przystępne, praktyczne poradniki. Eva wierzy, że samodzielne hostowanie powinno sprawiać radość, a nie onieśmielać. Dzięki swoim samouczkom pomaga społeczności oswoić konfigurację sprzętu, od budowy pierwszego serwera NAS po opanowanie kontenerów Docker.

Aktualizacje samodzielnie hostowanych aplikacji rzadziej powodują powstawanie plików należących do roota, jeśli wdrożenie przypisuje stałego użytkownika na podstawie identyfikatora liczbowego i weryfikuje właścicieli plików w wolumenach przed zastąpieniem kontenera.

Celem działań zapobiegawczych jest zaprzestanie traktowania wewnętrznej nazwy użytkownika obrazu jako stałej tożsamości dla danych. Zapisz efektywne UID i GID używane do zapisu danych trwałych, przypisz je do katalogów na hoście lub nazwanych wolumenów, zachowaj wszelkie ustawienia PUID/PGID lub przestrzeni nazw użytkowników i przetestuj nowy obraz na małej ścieżce z prawem zapisu przed pełnym wdrożeniem. Dzięki temu aktualizacja obrazu nie zmieni po cichu numerycznego właściciela plików konfiguracji, przesłanych plików, baz danych ani metadanych multimediów.

Zapisz numeryczny UID i GID przed aktualizacją

Zapisz użytkownika procesu, grupę główną, grupy dodatkowe i numeryczne informacje o właścicielu przykładowych plików w każdym wolumenie z prawem zapisu. Zapisz skrót obrazu lub jego wersję obok tych danych bazowych dotyczących właścicieli plików.

Zalecenia Dockera dotyczące tworzenia obrazów wskazują, że jawne identyfikatory zapobiegają zmianom przy ponownej kompilacji, ponieważ użytkownicy obrazów przypisywani automatycznie mogą otrzymać różne numeryczne identyfikatory w kolejnych kompilacjach.

Zapisuj wartości liczbowe, a nie tylko nazwy, takie jak app lub media. Nowy obraz może ponownie użyć tej samej nazwy użytkownika, ale przypisać jej inny UID, a pliki na hoście przechowują numeryczne informacje o właścicielu.

Przypisz stałego użytkownika środowisku uruchomieniowemu we wdrożeniu

Jeśli obraz obsługuje bezpośrednie uruchamianie z konta nieuprzywilejowanego, określ jawnie odpowiedniego użytkownika i grupę w Compose lub konfiguracji środowiska uruchomieniowego. Jeśli obraz wymaga etapu inicjalizacji z uprawnieniami administratora, opisz, który późniejszy proces faktycznie zapisuje dane trwałe.

Specyfikacja obrazów Open Container definiuje User jako domyślną tożsamość w czasie działania, co oznacza, że zmiana obrazu może zmienić tożsamość procesu, chyba że wdrożenie celowo ją nadpisuje lub weryfikuje.

Nie przypisuj arbitralnie obrazom nieuprzywilejowanego UID, jeśli wymagają obsługiwanego modelu inicjalizacji. Konfiguracja powinna być zgodna z udokumentowanym projektem aplikacji, a jednocześnie zapewniać przewidywalnego właściciela tworzonych plików trwałych.

Dopasuj PUID i PGID do właścicieli plików na hoście

W przypadku obrazów udostępniających zmienne PUID i PGID przypisz im stałe wartości w pliku Compose lub konfiguracji środowiska śledzonej w systemie kontroli wersji i upewnij się, że katalogi wolumenów po stronie hosta należą do odpowiedniego konta usługi.

LinuxServer wyjaśnia, że PUID mapuje operacje zapisu w kontenerze, dzięki czemu pliki utworzone w podłączonych wolumenach pozostają dostępne do zarządzania poza kontenerem.

Przed aktualizacją porównaj skonfigurowane identyfikatory z wynikiem polecenia id na hoście i z właścicielami istniejących plików. Nie kopiuj bez zastanowienia przykładowej wartości, takiej jak 1000, na serwer, na którym ten identyfikator należy do innej osoby lub usługi.

Uwzględnij przestrzenie nazw użytkowników i mapowanie rootless

Docker lub Podman w trybie rootless mogą sprawić, że proces będzie wyglądał na uruchomiony jako root wewnątrz kontenera, mimo że jest mapowany na nierootowy UID hosta. Zapisz tryb przestrzeni nazw oraz konfigurację podrzędnych zakresów UID/GID, zanim zinterpretujesz zmiany właścicieli.

Opcje środowiska uruchomieniowego Podmana pokazują, że keep-id zachowuje mapowanie użytkownika, gdy kontener musi mieć przewidywalny dostęp do plików zamontowanych z hosta.

Nie „naprawiaj” właściciela wyglądającego na roota wewnątrz kontenera, dopóki nie sprawdzisz numerycznego identyfikatora po stronie hosta. Root w przestrzeni nazw i root na hoście nie zawsze oznaczają tę samą tożsamość.

Przetestuj nowy obraz na woluminie testowym przed wdrożeniem

Zanim zastąpisz kontener produkcyjny, uruchom nowy obraz z docelowym UID/GID i katalogiem tymczasowym o uprawnieniach odpowiadających produkcyjnym. Pozwól mechanizmowi inicjalizacji utworzyć jeden plik i jeden katalog, a następnie sprawdź ich właścicieli po stronie hosta.

Przewodnik Red Hat dotyczący debugowania woluminów w trybie rootless pokazuje, że własność po stronie hosta zależy od mapowania UID, a nazwa użytkownika widoczna wewnątrz kontenera nie jest wystarczającym potwierdzeniem.

Jeśli kontener testowy utworzy nieoczekiwane pliki należące do roota lub z remapowanymi identyfikatorami, zatrzymaj wdrożenie i porównaj użytkownika obrazu, punkt wejścia, przestrzeń nazw oraz ustawienia montowania. To znacznie bezpieczniejsze niż odkrycie zmiany po tym, jak migracja uruchamiana przy starcie rekurencyjnie obejmie całe drzewo zdjęć lub bazy danych.

Sprawdź grupy dodatkowe i ścieżki z prawem zapisu

Niektóre aplikacje wymagają głównego UID usługi oraz dostępu przez współdzieloną grupę multimediów, pobierania lub urządzeń. Zapisz identyfikatory tych grup i przetestuj wszystkie ścieżki z prawem zapisu, nie tylko katalog konfiguracji.

Kubernetes używa jawnych ustawień runAsUser i runAsGroup, które ilustrują tę samą zasadę własności w Linuksie, także poza prostym wdrożeniem Docker Compose.

Zasady aktualizacji można uznać za sprawdzone, gdy nowy obraz tworzy pliki z oczekiwanymi właścicielami po stronie hosta we wszystkich trwałych ścieżkach, a konfiguracja działa po jednokrotnym ponownym utworzeniu kontenera. Powiązany artykuł ZimaSpace o plikach należących do roota po aktualizacji obrazu opisuje procedurę naprawczą na wypadek, gdy wdrożenie spowodowało już, że dane należą do roota.

Wsparcie i porady

Więcej do przeczytania

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.