Baza danych PostgreSQL

Instalacja bazy danych PostgreSQL
Poradnik: Baza danych PostgreSQL

W tym poradniku przejdziemy przez szybki proces uruchomienia bazy danych PostgreSQL w kontenerze oraz skonfigurujemy trwałe przechowywanie danych, tak żeby nie zniknęły po restarcie usługi.

Karta usługi

Podstawowe informacje o usłudze:

Nazwa
PostgreSQL
Opis
Relacyjna baza danych PostgreSQL
Licencja
PostgreSQL is released under the PostgreSQL License, a liberal Open Source license, similar to the BSD or MIT licenses. https://www.postgresql.org/about/licence/

Plik konfiguracyjny docker compose usługi PostgreSQL

Plik docker-compose.yml to główny element każdego projektu opartego na Docker Compose. Jest to dokument zapisany w formacie YAML, który opisuje jak uruchamiać, konfigurować i łączyć ze sobą kontenery w ramach jednej aplikacji lub całego środowiska. To tutaj opisujesz, jakie obrazy mają zostać pobrane, jakie porty otwarte i jakie relacje zachodzą między poszczególnymi elementami systemu.

Pełny opis schematu pliku konfiguracyjnego docker-compose.yml.

Poniżej znajdziesz zawartość pliku docker-compose.yml dla usługi PostgreSQL:

YML
services:
  db:
    container_name: postgres # Stała nazwa kontenera
    image: docker.io/postgres:18.1 # Postgres w wersji 18.1 z oficjalnego repozytorium Docker Hub.
    shm_size: 256mb # Zwiększa rozmiar pamięci współdzielonej (Shared Memory).

    environment:
      POSTGRES_PASSWORD: haslo # Hasło dla głównego użytkownika bazy danych.
      POSTGRES_USER: uzytkownik # Nazwa głównego użytkownika (zamiast domyślnego "postgres").
      POSTGRES_DB: baza # Tworzy domyślną bazę danych o tej nazwie przy pierwszym uruchomieniu.

    ports:
      - "5432:5432" # Pozwala na dostęp do bazy z zewnątrz przez port 5432.

    volumes:
      - ./postgresql:/var/lib/postgresql # Mapuje folder "./postgresql" gdzie Postgres trzyma dane.

    restart: unless-stopped # Automatyczne uruchomienie po restarcie, chyba że zatrzymano ręcznie.

Konteneryzacja usługi

Opisywana aplikacja zostanie uruchomiona jako kontener Dockera. Jeśli chcesz zapoznać się z tematem konteneryzacji, zacznij od tego artykułu: Podstawy Konteneryzacji: Kontener i Proces Konteneryzacji.

Instalacja Docker i Docker Compose

Jeśli chcesz uruchomić pierwszą aplikację docker compose na swoim domowym serwerze to najpierw musisz zainstalować w systemie odpowiednie pakiety oprogramowania. Zapoznaj się z poradnikiem, gdzie opisana jest Instalacja silnika Docker oraz wtyczki Docker Compose bezpośrednio z poziomu terminala Instalacja Docker i Docker Compose

Zarządzanie Usługą (Docker Compose)

Do zarządzania usługą w kontenerze na serwerze domowym użyjesz komendy docker compose. Poniższe komendy wykonuje się w katalogu, w którym znajduje się plik docker-compose.yml.

Uruchomienie Usługi (Pierwsza Instalacja)

Aby uruchomić usługę i kontener w tle (detached mode) użyj polecenia poniżej:

Bash
docker compose up -d

Opis parametrów: * up: Tworzy i uruchamia kontenery. * -` (detached): Uruchamia kontenery w tle, zwalniając terminal.

Usunięcie Usługi

Aby zatrzymać i usunąć kontener, sieć oraz wszystkie powiązane zasoby (ale zachować zmapowane woluminy work i conf na hoście):

Bash
docker compose down

Aktualizacja Obrazu

Aby zaktualizować usługę do nowszej wersji (zakładając, że obraz został zaktualizowany przez twórców):

Pobierz najnowszy obraz

Bash
docker compose pull

Zatrzymaj i ponownie utwórz kontener (używając nowego obrazu):

Bash
docker compose up -d

Docker Compose automatycznie wykryje, że obraz jest nowszy i zastąpi stary kontener nowym, zachowując wszystkie Twoje dane konfiguracyjne dzięki zdefiniowanym woluminom

Wersja Postgresa: Używasz wersji 18.1. Pamiętaj, że przy dużych aktualizacjach Postgresa (np. z 18 na 19), same pliki bazy danych w volumes mogą wymagać migracji (nie wystarczy zmiana samej linii image).

Zestawienie najważniejszych poleceń

Zestawienie najważniejszych komend na potrzeby uruchamiania usług Docker Compose zdefiniowanych w plikach docker-compose.yml znajdziesz w przygotowanym poradniku Polecenia Docker Compose

Kategoria: Usługi | Autor: Rafał Wójcik
Utworzono: 2026-01-17 01:52 | Ostatnia edycja: 2026-04-07 15:58

Pytania & Komentarze

Brak komentarzy. Bądź pierwszy!

Dodaj nowy komentarz