oasis_roles.rhsm
Ta rola została wycofana: Proszę użyć wersji w kolekcji Ansible oasis_roles.system
RHSM
Ta rola rejestruje lub wyrejestrowuje system za pomocą subscription-manager
i może również włączać lub wyłączać dostępne w subskrypcji repozytoria.
Wymagania
Ansible 2.8 lub wyższy
Red Hat Enterprise Linux 7 lub równoważny
Ważne subskrypcje Red Hat
Zmienna roli
Obecnie obsługiwane są następujące zmienne:
Zarządzanie subskrypcjami
Zmienne w tej sekcji odpowiadają bezpośrednio argumentom dostępnym w module redhat_subscription.
rhsm_username
- użytkownik w access.redhat.com lub Satellite (dostawca RHSM)rhsm_password
- hasło w access.redhat.com lub Satellite (dostawca RHSM)rhsm_org_id
- identyfikator organizacji dostawcy RHSMrhsm_activationkey
- klucz aktywacyjny dostawcy RHSMrhsm_server_hostname
- hostname alternatywnego dostawcy RHSMrhsm_server_insecure
- wyłączenie weryfikacji certyfikatu podczas łączenia z dostawcą RHSM (bool, domyślnie fałsz)rhsm_baseurl
- alternatywny adres URL repozytoriów pakietów, jeśli nie używasz Red Hat CDNrhsm_server_proxy_hostname
- hostname serwera proxy HTTPrhsm_server_proxy_port
- port serwera proxy HTTPrhsm_server_proxy_user
- użytkownik serwera proxy HTTPrhsm_server_proxy_password
- hasło serwera proxy HTTPrhsm_auto_attach
- automatyczne korzystanie z dostępnych subskrypcji, jeśli rejestracja się powiedzie (bool, domyślnie fałsz, wymaga ansible >= 2.5)rhsm_environment
- rejestracja w konkretnej środowisku w docelowej organizacji (używane z Red Hat Satellite 6 lub Katello)rhsm_pool
- konkretny zestaw do wykorzystania (można używać regex jako wejścia). Używajrhsm_pool_ids
, gdy to możliwe, ponieważ działa znacznie szybciej. Wzajemnie wykluczające się zrhsm_pool_ids
rhsm_pool_ids
- lista identyfikatorów zestawów do wykorzystania, lub lista słowników z identyfikatorami zestawów jako klucze i ilością uprawnień do wykorzystania jako wartości. Wzajemnie wykluczające się zrhsm_pool
rhsm_consumer_type
- typ jednostki do rejestracji (domyślnie "system")rhsm_consumer_name
- nazwa systemu do rejestracji (domyślnie hostname systemu)rhsm_consumer_id
- istniejący identyfikator konsumenta do wznowienia poprzedniej rejestracjirhsm_force_register
- zarejestruj system, nawet jeśli jest już zarejestrowany (bool, domyślnie fałsz)rhsm_syspurpose
- słownik atrybutów do populacji plikusyspurpose.json
na systemach RHEL 8 (wymaga ansible>=2.9)rhsm_unregister
- wyrejestruj system, jeśli prawda. System zostanie wyrejestrowany. Rejestracja systemu nie zostanie podjęta, jeśli to jest prawda. (bool, domyślnie fałsz)
Zarządzanie repozytoriami
Uwaga:
Użycie zmiennych związanych z zarządzaniem repozytoriami może spowodować zgłoszenie błędu, jeśli system nie jest zarejestrowany. Zadania subskrypcyjne są wykonywane przed zadaniami zarządzania repozytoriami, aby zapewnić poprawny stan rejestracji przed przetwarzaniem tych zmiennych.
rhsm_release
- ustaw, która wersja systemu operacyjnego ma być używana. Pamiętaj, aby to zacytować dla wersji, które wyglądają jak zmienne float dla parsera YAML, np. ustaw wartość na coś w rodzaju"7.4"
, a nie7.4
. Wartości takie jak6Server
i7Server
nie muszą być cytowane.rhsm_release_unset
- wyłącz, która wersja systemu operacyjnego ma być używana (bool, domyślnie fałsz)rhsm_repositories
- określa, które repozytoria włączyć/wyłączyć, szczegóły poniżej
Jeśli zarówno rhsm_release
, jak i rhsm_release_unset
są ustawione, rhsm_release_unset
zostanie wykonane przed ustawieniem rhsm_release
,
co spowoduje, że ta rola nie będzie działać idempotentnie przy ustawianiu wersji.
Aby włączyć/wyłączyć konkretne repozytoria:
rhsm_repositories:
enabled:
- enabled-repository
disabled:
- disabled-repository
Lista repozytoriów w disabled
jest przetwarzana przed enabled
.
Aby idempotentnie włączyć tylko konkretne repozytoria i wyłączyć wszystkie inne,
możliwe jest ustawienie disabled
na '*'
:
rhsm_repositories:
disabled:
- '*'
enabled:
- enabled-repository-1
- enabled-repository-2
Zauważ, że wspierane jest użycie znaków wieloznacznych w nazwach repozytoriów, np.:
rhsm_repositories:
disabled:
- '*'
enabled:
- 'enabled-repository*'
Aby ustawić konkretną mniejszą wersję repozytoriów RHEL do użycia:
rhsm_release: "7.1"
Aby domyślnie używać najnowszej dostępnej mniejszej wersji repozytoriów:
rhsm_release_unset: true
Zależności
Wymaga systemu, który obsługuje instalację i używanie subscription-manager
, np. Red Hat Enterprise Linux.
Wymagana jest eskalacja uprawnień (sudo) do poprawnego działania tej roli.
Przykładowe playbooki
Ten przykład rejestruje system z nazwą użytkownika i hasłem, automatycznie podłącza, włącza trzy repozytoria RHEL 7, i wyraźnie ustawia wersję repozytoriów włączonych do "7Server".
- hosts: rhsm-servers
roles:
- role: rhsm
vars:
rhsm_username: twoja_nazwa_użytkownika
rhsm_password: twoje_hasło
rhsm_auto_attach: true
rhsm_repositories:
only:
- rhel-7-server-rpms
- rhel-7-server-optional-rpms
- rhel-7-server-extras-rpms
rhsm_release: 7Server
Ten przykład rejestruje system w Red Hat Satellite 6, używając identyfikatora organizacji i klucza aktywacyjnego, oraz podłącza do konkretnego zestawu po identyfikatorze.
- hosts: rhsm-servers
roles:
- role: rhsm
vars:
rhsm_org_id: twoj_identifikator_organizacji
rhsm_activationkey: klucz_aktywacyjny
rhsm_pool_ids:
- poolid
rhsm_server_hostname: twoje.hostname.satellite6
Certyfikaty CA dla hosta Satellite 6 lub Katello powinny być zainstalowane przed użyciem HTTPS jako dostawcy RHSM.
Zmiany
rhsm_repositories.only
przestarzałe
Przed wprowadzeniem parametru purge
w module rhsm_repository
w Ansible
2.8, aby umożliwić działanie idempotentne przy włączaniu określonych repozytoriów i
wyłączaniu wszystkich innych, następująca składnia była obsługiwana przez tę rolę, ale jest teraz
przestarzała:
rhsm_repositories:
only:
- enabled-repository-1
- enabled-repository-2
Wsparcie dla bardziej idiomatycznego użycia subscription-manager
zostało dodane do roli, więc ta operacja jest teraz
idempotentna:
rhsm_repositories:
disabled:
- '*'
enabled:
- enabled-repository-1
- enabled-repository-2
W rezultacie, aby istniała "jedna -- a najlepiej tylko jedna -- oczywista
sposób na to zrobić," klucz only
w słowniku rhsm_repositories
jest przestarzały, a
wsparcie dla niego może zostać usunięte w przyszłej wersji tej roli. Jest obecnie
utrzymywane w tej roli dla zachowania zgodności wstecznej.
Zauważ, że użycie only
wciąż jest wzajemnie wykluczające się z użyciem
enabled
lub disabled
w słowniku rhsm_repositories
.
Wymaga Ansible >= 2.8
Nowe funkcje w module rhsm_repository
Ansible są używane przez tę rolę.
Jeśli używasz starszej wersji Ansible, można użyć wersji 2.0.0 tej roli.
# przykład requirements.yaml do zainstalowania wersji 2.0.0
- name: oasis_roles.rhsm
version: 2.0.0
Licencja
Informacje o autorze
Sean Myers semyers@redhat.com
ansible-galaxy install oasis_roles.rhsm