This file is indexed.

/usr/lib/python2.7/dist-packages/os_faults/drivers/nodes/node_list.py is in python-os-faults 0.1.17-0ubuntu1.1.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#   http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
# implied.
# See the License for the specific language governing permissions and
# limitations under the License.


from os_faults.api import node_collection
from os_faults.api import node_discover
from os_faults import utils


AUTH_SCHEMA = {
    'type': 'object',
    'properties': {
        'username': {'type': 'string'},
        'password': {'type': 'string'},
        'sudo': {'type': 'boolean'},
        'private_key_file': {'type': 'string'},
        'become': {'type': 'boolean'},
        'become_password': {'type': 'string'},
        'jump': {
            'type': 'object',
            'properties': {
                'host': {'type': 'string'},
                'username': {'type': 'string'},
                'private_key_file': {'type': 'string'},
            },
            'required': ['host'],
            'additionalProperties': False,
        },
    },
    'additionalProperties': False,
}


class NodeListDiscover(node_discover.NodeDiscover):
    """Node list.

    Allows specifying list of nodes in configuration.

    **Example configuration:**

    .. code-block:: yaml

        node_discover:
          driver: node_list
          args:
          - ip: 10.0.0.51
            mac: aa:bb:cc:dd:ee:01
            fqdn: node1.local
            libvirt_name: node1
          - ip: 192.168.1.50
            mac: aa:bb:cc:dd:ee:02
            fqdn: node2.local
            auth:
              username: user1
              password: secret1
              sudo: False
              jump:
                host: 10.0.0.52
                username: ubuntu
                private_key_file: /path/to/file
          - ip: 10.0.0.53
            mac: aa:bb:cc:dd:ee:03
            fqdn: node3.local
            become: true
            become_password: my_secret_password

    node parameters:

    - **ip** - ip/host of the node
    - **mac** - MAC address of the node (optional).
      MAC address is used for libvirt driver.
    - **fqdn** - FQDN of the node (optional).
      FQDN is used for filtering only.
    - **auth** - SSH related parameters (optional):
        - **username** - SSH username (optional)
        - **password** - SSH password (optional)
        - **private_key_file** - SSH key file (optional)
        - **become** - True if privilege escalation is used (optional)
        - **become_password** - privilege escalation password (optional)
        - **jump** - SSH proxy parameters (optional):
            - **host** - SSH proxy host
            - **username** - SSH proxy user
            - **private_key_file** - SSH proxy key file (optional)

    """

    NAME = 'node_list'
    DESCRIPTION = 'Reads hosts from configuration file'
    CONFIG_SCHEMA = {
        '$schema': 'http://json-schema.org/draft-04/schema#',
        'type': 'array',
        'items': {
            'type': 'object',
            'properties': {
                'ip': {'type': 'string'},
                'mac': {'type': 'string', 'pattern': utils.MACADDR_REGEXP},
                'fqdn': {'type': 'string'},
                'libvirt_name': {'type': 'string'},
                'auth': AUTH_SCHEMA,
            },
            'required': ['ip'],
            'additionalProperties': False,
        },
        'minItems': 1,
    }

    def __init__(self, conf):
        self.hosts = [node_collection.Host(**host) for host in conf]

    def discover_hosts(self):
        """Discover hosts

        :returns: list of Host instances
        """
        return self.hosts