oradb_facts: add attribute oradb_facts_ignore_unreachable to oracle_databases

Author: Rendanic

changelogs/fragments/oradb_facts.yml

@@ -0,0 +1,3 @@
+---
+minor_changes:
+  - "oradb_facts: add attribute oradb_facts_ignore_unreachable to oracle_databases (oravirt#417)"

roles/oradb_facts/tasks/db_facts.yml

@@ -1,40 +1,63 @@
 ---
 # @todo bug: parameter user, password and sysdba needs a refactoring
-- name: Gather Facts from Database
-  opitzconsulting.ansible_oracle.oracle_facts:
-    hostname: "{{ oracle_hostname }}"
-    port: "{{ _listener_port_cdb }}"
-    service_name: "{{ _db_service_name }}"
-    user: "{{ db_user }}"
-    password: "{{ _db_password_cdb }}"
-    mode: sysdba
-  environment: "{{ _oracle_env }}"
-  register: dbfactsreg
-  vars:
-    # set db_user for _db_password_cdb
-    db_user: "{{ oradb_facts_db_user }}"
+- name: Gather Facts
+  block:
+    - name: Gather Facts from Database (rescue failures in later task)
+      opitzconsulting.ansible_oracle.oracle_facts:
+        hostname: "{{ oracle_hostname }}"
+        port: "{{ _listener_port_cdb }}"
+        service_name: "{{ _db_service_name }}"
+        user: "{{ db_user }}"
+        password: "{{ _db_password_cdb }}"
+        mode: sysdba
+      environment: "{{ _oracle_env }}"
+      register: dbfactsreg
+      vars:
+        # set db_user for _db_password_cdb
+        db_user: "{{ oradb_facts_db_user }}"
 
+    # 2nd execution of oracle_facts will overwrite data of last execution.
+    # => Store facts from oracle_facts in structure
+    - name: Write facts to oracledb.db_unique_name
+      ansible.builtin.set_fact:
+        cacheable: true
+        oracledb_facts: "{{ oracledb_facts | default({}) | combine(_db_facts | items2dict) }}"
+      when:
+        - dbfactsreg.ansible_facts['version'] is defined
+      vars:
+        _db_facts:
+          - key: "{{ odb['oracle_db_unique_name'] | default(odb['oracle_db_name']) }}"
+            value:
+              state: present
+              version: "{{ ansible_facts['version'] }}"
+              database: "{{ ansible_facts['database'] }}"
+              instance: "{{ ansible_facts['instance'] }}"
+              pdb: "{{ ansible_facts['pdb'] }}"
+              parameter: "{{ ansible_facts['parameter'] }}"
+              rac: "{{ ansible_facts['rac'] }}"
+              redolog: "{{ ansible_facts['redolog'] }}"
+              tablespace: "{{ ansible_facts['tablespace'] }}"
+              temp_tablespace: "{{ ansible_facts['temp_tablespace'] }}"
+              userenv: "{{ ansible_facts['userenv'] }}"
+              option: "{{ ansible_facts['option'] }}"
 
-# 2nd execution of oracle_factswill overwrite data of last execution.
-# => Store facts from oracle_facts in structure
-- name: Write facts to oracledb.db_unique_name
-  ansible.builtin.set_fact:
-    cacheable: true
-    oracledb_facts: "{{ oracledb_facts | default({}) | combine(_db_facts | items2dict) }}"
-  when:
-    - dbfactsreg.ansible_facts['version'] is defined
-  vars:
-    _db_facts:
-      - key: "{{ odb['oracle_db_unique_name'] | default(odb['oracle_db_name']) }}"
-        value:
-          version: "{{ dbfactsreg.ansible_facts['version'] }}"
-          database: "{{ dbfactsreg.ansible_facts['database'] }}"
-          instance: "{{ dbfactsreg.ansible_facts['instance'] }}"
-          pdb: "{{ dbfactsreg.ansible_facts['pdb'] }}"
-          parameter: "{{ dbfactsreg.ansible_facts['parameter'] }}"
-          rac: "{{ dbfactsreg.ansible_facts['rac'] }}"
-          redolog: "{{ dbfactsreg.ansible_facts['redolog'] }}"
-          tablespace: "{{ dbfactsreg.ansible_facts['tablespace'] }}"
-          temp_tablespace: "{{ dbfactsreg.ansible_facts['temp_tablespace'] }}"
-          userenv: "{{ dbfactsreg.ansible_facts['userenv'] }}"
-          option: "{{ dbfactsreg.ansible_facts['option'] }}"
+  rescue:
+    # default is
+    # => Fail execution of Playbook
+    - name: Fail execution of oradb_facts
+      ansible.builtin.fail:
+        msg: >-
+          Set oradb_facts_ignore_unreachable=false in oracle_databases
+          to disable this fail task.
+      when:
+        - not _odb_loop_helper.oradb_facts_ignore_unreachable | default(false)
+
+    - name: Write empty facts to oracledb.db_unique_name (rescue from failure above)
+      ansible.builtin.set_fact:
+        cacheable: true
+        oracledb_facts: "{{ oracledb_facts | default({}) | combine(_db_facts | items2dict) }}"
+      vars:
+        _db_facts:
+          - key: "{{ odb['oracle_db_unique_name'] | default(odb['oracle_db_name']) }}"
+            value:
+              state: unreachable

roles/orasw_meta_internal/README.md

@@ -22,6 +22,7 @@ This will create issues and problems in `ansible-oracle` and is not supported.
   - [_opdb_home](#_opdb_home)
   - [_opdb_loop_helper](#_opdb_loop_helper)
   - [_oracle_db_instance_name](#_oracle_db_instance_name)
+  - [_oracle_db_unique_name](#_oracle_db_unique_name)
   - [_oracle_ee_opiton_dict](#_oracle_ee_opiton_dict)
   - [_oracle_env](#_oracle_env)
   - [_oracle_env_pdb](#_oracle_env_pdb)
@@ -211,6 +212,18 @@ Do not set it in inventory!
 _oracle_db_instance_name: _internal_used_
 ```
 
+### _oracle_db_unique_name
+
+The variable is internal used only.
+
+Do not set it in inventory!
+
+#### Default value
+
+```YAML
+_oracle_db_unique_name: _internal_used_
+```
+
 ### _oracle_ee_opiton_dict
 
 This is an internal variable in `ansible-oracle`.

roles/orasw_meta_internal/defaults/main.yml

@@ -120,6 +120,20 @@ _oracle_db_instance_name: >-
     {%- endfor -%}
   {%- endif -%}
 
+# @var _oracle_db_unique_name:description: >
+# The variable is internal used only.
+#
+# Do not set it in inventory!
+# @end
+# @var _oracle_db_unique_name: $ "_internal_used_"
+_oracle_db_unique_name: >-
+  {%- if _odb_loop_helper.oracle_db_name is defined -%}
+    {{- _odb_loop_helper.oracle_db_unique_name
+      | default(_odb_loop_helper.oracle_db_name) -}}
+  {%- elif _opdb_loop_helper.cdb is defined -%}
+    {{- _db_unique_name_for_pdb -}}
+  {%- endif -%}
+
 # @var _listener_port_cdb:description: >
 # The variable is internal used only.
 #