nephosolutions.postgresql

NephoSolutions - Rola Ansible PostgreSQL

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

Instalacja

Testowano na Ansible 2.4.0 i nowszych.

Aby zainstalować:

ansible-galaxy install ANXS.postgresql

Przykładowy playbook

Przykład, jak użyć tej roli:

    - hosts: postgresql-server
      become: yes
      roles:
         - { role: anxs.postgresql }

Zależności

ANXS.monit (Galaxy/GH), jeśli chcesz ochronę monit (w takim przypadku należy ustawić monit_protection: true)

Matryca kompatybilności

Dystrybucja / PostgreSQL	<= 9.3	9.4	9.5	9.6	10	11	12
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:
CentOS 8.x	:no_entry:	:grey_question:	:grey_question:	:grey_question:	:grey_question:	:grey_question:	:grey_question:
Fedora latest	:no_entry:	:x:	:x:	:x:	:x:	:x:	:x:

:white_check_mark: - testowane, działa dobrze
:warning: - Nie do użycia w produkcji
:grey_question: - będzie działać w przyszłości (pomóż, jeśli możesz)
:interrobang: - może działać, nie testowane
:no_entry: - PostgreSQL osiągnął koniec wsparcia

Zmienne

# Ustawienia podstawowe
postgresql_version: 11
postgresql_encoding: "UTF-8"
postgresql_locale: "en_US.UTF-8"
postgresql_ctype: "en_US.UTF-8"

postgresql_admin_user: "postgres"
postgresql_default_auth_method: "peer"

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

postgresql_cluster_name: "main"
postgresql_cluster_reset: false

# Lista baz danych do utworzenia (opcjonalnie)
# Uwaga: aby uzyskać więcej 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 do zainstalowania rozszerzenia hstore na tej bazie danych (tak/nie)
    uuid_ossp: yes      # flaga do zainstalowania rozszerzenia uuid-ossp na tej bazie danych (tak/nie)
    citext: yes         # flaga do zainstalowania rozszerzenia citext na tej bazie danych (tak/nie)
    encoding: "UTF-8"   # nadpisz globalną zmienną {{ postgresql_encoding }} dla każdej bazy danych
    lc_collate: "en_GB.UTF-8"   # nadpisz globalną zmienną {{ postgresql_locale }} dla każdej bazy danych
    lc_ctype: "en_GB.UTF-8"     # nadpisz globalną zmienną {{ postgresql_ctype }} dla każdej bazy danych

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

# Lista użytkowników do utworzenia (opcjonalnie)
postgresql_users:
  - name: baz
    pass: pass
    encrypted: yes  # jeśli hasło ma być zaszyfrowane, postgresql >= 10 akceptuje tylko zaszyfrowane hasła

# Lista schematów do utworzenia (opcjonalnie)
postgresql_database_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 uprawnień użytkowników do zastosowania (opcjonalnie)
postgresql_user_privileges:
  - name: baz                   # nazwa użytkownika
    db: foobar                  # baza danych
    priv: "ALL"                 # format ciągu uprawnień: przykład: INSERT,UPDATE/table:SELECT/anothertable:ALL
    role_attr_flags: "CREATEDB" # flagi atrybutów roli

Jest wiele innych ustawień, które możesz znaleźć w defaults/main.yml.

Testowanie

Ten projekt zawiera plik Vagrantfile, co jest szybkim i łatwym sposobem testowania zmian w roli - uruchom go poleceniem vagrant up.

Zobacz dokumentację vagrant aby dowiedzieć się, jak skonfigurować Vagrant.

Gdy Twoja maszyna wirtualna jest uruchomiona, możesz ją ponownie skonfigurować, używając vagrant provision lub ansible-playbook tests/playbook.yml -i vagrant-inventory.

Jeśli chcesz bawić się testowym playbookiem, sprawdź tests/playbook.yml i zmień zmienne w tests/vars.yml.

Jeśli chcesz się przyczynić, najpierw przetestuj swoje zmiany w środowisku Vagrant (używając docelowej dystrybucji) oraz, jeśli to możliwe, upewnij się, że Twoje zmiany są zawarte w testach znajdujących się w .travis.yml.