mirror of
https://github.com/ansible-collections/kubernetes.core.git
synced 2026-03-26 21:33:02 +00:00
237 lines
7.9 KiB
Python
237 lines
7.9 KiB
Python
#!/usr/bin/python
|
|
# -*- coding: utf-8 -*-
|
|
|
|
# (c) 2019, Fabian von Feilitzsch <@fabianvf>
|
|
# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
|
|
|
|
from __future__ import absolute_import, division, print_function
|
|
|
|
__metaclass__ = type
|
|
|
|
|
|
ANSIBLE_METADATA = {'metadata_version': '1.1',
|
|
'status': ['preview'],
|
|
'supported_by': 'community'}
|
|
|
|
DOCUMENTATION = '''
|
|
module: k8s_log
|
|
|
|
short_description: Fetch logs from Kubernetes resources
|
|
|
|
author:
|
|
- "Fabian von Feilitzsch (@fabianvf)"
|
|
|
|
description:
|
|
- Use the OpenShift Python client to perform read operations on K8s log endpoints.
|
|
- Authenticate using either a config file, certificates, password or token.
|
|
- Supports check mode.
|
|
- Analogous to `kubectl logs` or `oc logs`
|
|
extends_documentation_fragment:
|
|
- community.kubernetes.k8s_auth_options
|
|
options:
|
|
api_version:
|
|
description:
|
|
- Use to specify the API version. in conjunction with I(kind), I(name), and I(namespace) to identify a
|
|
specific object.
|
|
- If using I(label_selector), cannot be overridden
|
|
default: v1
|
|
aliases:
|
|
- api
|
|
- version
|
|
type: str
|
|
kind:
|
|
description:
|
|
- Use to specify an object model. Use in conjunction with I(api_version), I(name), and I(namespace) to identify a
|
|
specific object.
|
|
- If using I(label_selector), cannot be overridden
|
|
required: no
|
|
default: Pod
|
|
type: str
|
|
namespace:
|
|
description:
|
|
- Use to specify an object namespace. Use in conjunction with I(api_version), I(kind), and I(name)
|
|
to identify a specfic object.
|
|
type: str
|
|
name:
|
|
description:
|
|
- Use to specify an object name. Use in conjunction with I(api_version), I(kind) and I(namespace) to identify a
|
|
specific object.
|
|
- Only one of I(name) or I(label_selector) may be provided
|
|
type: str
|
|
label_selectors:
|
|
description:
|
|
- List of label selectors to use to filter results
|
|
- Only one of I(name) or I(label_selector) may be provided
|
|
type: list
|
|
elements: str
|
|
container:
|
|
description:
|
|
- Use to specify the container within a pod to grab the log from.
|
|
- If there is only one container, this will default to that container.
|
|
- If there is more than one container, this option is required.
|
|
required: no
|
|
type: str
|
|
|
|
requirements:
|
|
- "python >= 2.7"
|
|
- "openshift >= 0.6"
|
|
- "PyYAML >= 3.11"
|
|
'''
|
|
|
|
EXAMPLES = '''
|
|
- name: Get a log from a Pod
|
|
k8s_log:
|
|
name: example-1
|
|
namespace: testing
|
|
register: log
|
|
|
|
# This will get the log from the first Pod found matching the selector
|
|
- name: Log a Pod matching a label selector
|
|
k8s_log:
|
|
namespace: testing
|
|
label_selectors:
|
|
- app=example
|
|
register: log
|
|
|
|
# This will get the log from a single Pod managed by this Deployment
|
|
- name: Get a log from a Deployment
|
|
k8s_log:
|
|
api_version: apps/v1
|
|
kind: Deployment
|
|
namespace: testing
|
|
name: example
|
|
register: log
|
|
|
|
# This will get the log from a single Pod managed by this DeploymentConfig
|
|
- name: Get a log from a DeploymentConfig
|
|
k8s_log:
|
|
api_version: apps.openshift.io/v1
|
|
kind: DeploymentConfig
|
|
namespace: testing
|
|
name: example
|
|
register: log
|
|
'''
|
|
|
|
RETURN = '''
|
|
log:
|
|
type: str
|
|
description:
|
|
- The text log of the object
|
|
returned: success
|
|
log_lines:
|
|
type: list
|
|
description:
|
|
- The log of the object, split on newlines
|
|
returned: success
|
|
'''
|
|
|
|
|
|
import copy
|
|
from ansible_collections.community.kubernetes.plugins.module_utils.common import KubernetesAnsibleModule
|
|
from ansible_collections.community.kubernetes.plugins.module_utils.common import AUTH_ARG_SPEC
|
|
|
|
|
|
class KubernetesLogModule(KubernetesAnsibleModule):
|
|
|
|
def __init__(self, *args, **kwargs):
|
|
KubernetesAnsibleModule.__init__(self, *args,
|
|
supports_check_mode=True,
|
|
**kwargs)
|
|
|
|
@property
|
|
def argspec(self):
|
|
args = copy.deepcopy(AUTH_ARG_SPEC)
|
|
args.update(
|
|
dict(
|
|
kind=dict(default='Pod'),
|
|
api_version=dict(default='v1', aliases=['api', 'version']),
|
|
name=dict(),
|
|
namespace=dict(),
|
|
container=dict(),
|
|
label_selectors=dict(type='list', elements='str', default=[]),
|
|
)
|
|
)
|
|
return args
|
|
|
|
def execute_module(self):
|
|
name = self.params.get('name')
|
|
label_selector = ','.join(self.params.get('label_selectors', {}))
|
|
if name and label_selector:
|
|
self.fail(msg='Only one of name or label_selectors can be provided')
|
|
|
|
self.client = self.get_api_client()
|
|
resource = self.find_resource(self.params['kind'], self.params['api_version'], fail=True)
|
|
v1_pods = self.find_resource('Pod', 'v1', fail=True)
|
|
|
|
if 'log' not in resource.subresources:
|
|
if not self.params.get('name'):
|
|
self.fail(msg='name must be provided for resources that do not support the log subresource')
|
|
instance = resource.get(name=self.params['name'], namespace=self.params.get('namespace'))
|
|
label_selector = ','.join(self.extract_selectors(instance))
|
|
resource = v1_pods
|
|
|
|
if label_selector:
|
|
instances = v1_pods.get(namespace=self.params['namespace'], label_selector=label_selector)
|
|
if not instances.items:
|
|
self.fail(msg='No pods in namespace {0} matched selector {1}'.format(self.params['namespace'], label_selector))
|
|
# This matches the behavior of kubectl when logging pods via a selector
|
|
name = instances.items[0].metadata.name
|
|
resource = v1_pods
|
|
|
|
kwargs = {}
|
|
if self.params.get('container'):
|
|
kwargs['query_params'] = dict(container=self.params['container'])
|
|
|
|
log = resource.log.get(
|
|
name=name,
|
|
namespace=self.params.get('namespace'),
|
|
**kwargs
|
|
)
|
|
|
|
self.exit_json(changed=False, log=log, log_lines=log.split('\n'))
|
|
|
|
def extract_selectors(self, instance):
|
|
# Parses selectors on an object based on the specifications documented here:
|
|
# https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#label-selectors
|
|
selectors = []
|
|
if not instance.spec.selector:
|
|
self.fail(msg='{0} {1} does not support the log subresource directly, and no Pod selector was found on the object'.format(
|
|
'/'.join(instance.group, instance.apiVersion), instance.kind))
|
|
|
|
if not (instance.spec.selector.matchLabels or instance.spec.selector.matchExpressions):
|
|
# A few resources (like DeploymentConfigs) just use a simple key:value style instead of supporting expressions
|
|
for k, v in dict(instance.spec.selector).items():
|
|
selectors.append('{0}={1}'.format(k, v))
|
|
return selectors
|
|
|
|
if instance.spec.selector.matchLabels:
|
|
for k, v in dict(instance.spec.selector.matchLabels).items():
|
|
selectors.append('{0}={1}'.format(k, v))
|
|
|
|
if instance.spec.selector.matchExpressions:
|
|
for expression in instance.spec.selector.matchExpressions:
|
|
operator = expression.operator
|
|
|
|
if operator == 'Exists':
|
|
selectors.append(expression.key)
|
|
elif operator == 'DoesNotExist':
|
|
selectors.append('!{0}'.format(expression.key))
|
|
elif operator in ['In', 'NotIn']:
|
|
selectors.append('{key} {operator} {values}'.format(
|
|
key=expression.key,
|
|
operator=operator.lower(),
|
|
values='({0})'.format(', '.join(expression.values))
|
|
))
|
|
else:
|
|
self.fail(msg='The k8s_log module does not support the {0} matchExpression operator'.format(operator.lower()))
|
|
|
|
return selectors
|
|
|
|
|
|
def main():
|
|
KubernetesLogModule().execute_module()
|
|
|
|
|
|
if __name__ == '__main__':
|
|
main()
|