skoneka.anxs-postgresql

ANXS - PostgreSQL

Potrzebna pomoc! Jeśli chcesz i możesz pomóc w utrzymaniu tej roli Ansible, otwórz zgłoszenie na GitHubie. Wiele osób korzysta z tej roli i (oczywiście) potrzebujemy wsparcia! 💖

Rola Ansible, która instaluje i konfiguruje PostgreSQL, rozszerzenia, bazy danych oraz użytkowników.

Instalacja

To zostało przetestowane na Ansible 2.4.0 i nowszych.

Aby zainstalować:

ansible-galaxy install ANXS.postgresql

Zależności

ANXS.monit (Galaxy/GH), jeśli chcesz ochronę monit (w tym przypadku powinieneś ustawić monit_protection: true)

Tabela kompatybilności

Dystrybucja / PostgreSQL	<= 9.2	9.3	9.4	9.5	9.6	10	11
Ubuntu 14.04	:no_entry:	:white_check_mark:	:white_check_mark:	:white_check_mark:	:white_check_mark:	:white_check_mark:	:grey_question:
Ubuntu 16.04	:no_entry:	:white_check_mark:	:white_check_mark:	:white_check_mark:	:white_check_mark:	:white_check_mark:	:grey_question:
Debian 8.x	:no_entry:	:white_check_mark:	:white_check_mark:	:white_check_mark:	:white_check_mark:	:white_check_mark:	:grey_question:
Debian 9.x	:no_entry:	:white_check_mark:	:white_check_mark:	:white_check_mark:	:white_check_mark:	:white_check_mark:	:grey_question:
CentOS 6.x	:no_entry:	:white_check_mark:	:white_check_mark:	:white_check_mark:	:white_check_mark:	:white_check_mark:	:grey_question:
CentOS 7.x	:no_entry:	:white_check_mark:	:white_check_mark:	:white_check_mark:	:white_check_mark:	:white_check_mark:	:grey_question:
Fedora latest	:no_entry:	:no_entry:	:white_check_mark:	:white_check_mark:	:white_check_mark:	:white_check_mark:	:grey_question:

:white_check_mark: - testowane, działa dobrze
:grey_question: - może działać w przyszłości (pomóż, jeśli możesz)
:interrobang: - może działa, nie testowane
:no_entry: - PostgreSQL zakończył wsparcie

Zmienne

# Podstawowe ustawienia
postgresql_version: 9.6
postgresql_encoding: "UTF-8"
postgresql_locale: "en_US.UTF-8"
postgresql_ctype: "en_US.UTF-8"

postgresql_admin_user: "postgres"
postgresql_default_auth_method: "trust"

postgresql_service_enabled: false # czy usługa powinna być włączona, domyślnie to true

postgresql_cluster_name: "main"
postgresql_cluster_reset: false

# Lista baz danych do utworzenia (opcjonalna)
# Uwaga: dla większej elastyczności z rozszerzeniami użyj ustawienia postgresql_database_extensions.
postgresql_databases:
  - name: foobar
    owner: baz          # opcjonalne; określ właściciela bazy danych
    hstore: yes         # flaga, aby zainstalować rozszerzenie hstore w tej bazie (tak/nie)
    uuid_ossp: yes      # flaga, aby zainstalować rozszerzenie uuid-ossp w tej bazie (tak/nie)
    citext: yes         # flaga, aby zainstalować rozszerzenie citext w tej bazie (tak/nie)
    encoding: "UTF-8"   # nadpisuje globalną zmienną {{ postgresql_encoding }} dla bazy danych
    lc_collate: "en_GB.UTF-8"   # nadpisuje globalną zmienną {{ postgresql_locale }} dla bazy danych
    lc_ctype: "en_GB.UTF-8"     # nadpisuje globalną zmienną {{ postgresql_ctype }} dla bazy danych

# Lista rozszerzeń baz danych do utworzenia (opcjonalna)
postgresql_database_extensions:
  - db: foobar
    extensions:
      - hstore
      - citext

# Lista użytkowników do utworzenia (opcjonalna)
postgresql_users:
  - name: baz
    pass: pass
    encrypted: no       # oznacza, czy hasło jest już zaszyfrowane.

# Lista schematów do utworzenia (opcjonalna)
postgresql_schemas:
  - database: foobar           # nazwa bazy danych
    schema: acme               # nazwa schematu
    state: present

  - database: foobar           # nazwa bazy danych
    schema: acme_baz           # nazwa schematu
    owner: baz                 # nazwa właściciela
    state: present

# Lista przywilejów dla użytkowników do zastosowania (opcjonalna)
postgresql_user_privileges:
  - name: baz                   # nazwa użytkownika
    db: foobar                  # baza danych
    priv: "ALL"                 # format łańcucha uprawnień: przykład: INSERT,UPDATE/tablica:SELECT/innejtablicy:ALL
    role_attr_flags: "CREATEDB" # flagi atrybutów roli

Jest wiele innych opcji do ustawienia, które można znaleźć w defaults/main.yml

Testowanie

Ten projekt zawiera plik Vagrantfile, co jest szybkim i łatwym sposobem na testowanie zmian w roli, uruchom go za pomocą vagrant up.

Zobacz dokumentację vagranta dla instrukcji dotyczących konfiguracji vagranta.

Gdy Twoja maszyna wirtualna będzie włączona, możesz przeprowadzić ponowną konfigurację, używając vagrant provision, lub ansible-playbook tests/playbook.yml -i vagrant-inventory.

Jeśli chcesz pobawić się grą testową, zobacz tests/playbook.yml i zmień zmienne w tests/vars.yml.

Jeśli chcesz wnieść wkład, najpierw przetestuj swoje zmiany w środowisku vagrant (używając docelowej dystrybucji) i jeśli to możliwe, upewnij się, że Twoja zmiana jest zawarta w testach znajdujących się w .travis.yml.