openshift - Query the OpenShift API

• Synopsis
  • Requirements
• Parameters
• Notes
• Examples
• Return Values
• Status
  • Author

Synopsis

• Uses the OpenShift Python client to fetch a specific object by name, all matching objects within a namespace, or all matching objects for all namespaces.
• Provides access the full range of K8s APIs.
• Enables authentication via config file, certificates, password or token.

Requirements

The below requirements are needed on the local master node that executes this lookup.

• python >= 2.7
• openshift == 0.4.1
• PyYAML >= 3.11

Parameters

Notes

Examples

- name: Fetch a list of projects
  set_fact:
    projects: "{{ lookup('openshift', api_version='v1', kind='Project') }}"

- name: Fetch all deployments
  set_fact:
    deployments: "{{ lookup('openshift', kind='DeploymentConfig', namespace='testing') }}"

- name: Fetch all deployments in a namespace
  set_fact:
    deployments: "{{ lookup('openshift', kind='DeploymentConfig', namespace='testing') }}"

- name: Fetch a specific deployment by name
  set_fact:
    deployments: "{{ lookup('openshift', kind='DeploymentConfig', namespace='testing', resource_name='elastic') }}"

- name: Fetch with label selector
  set_fact:
    service: "{{ lookup('openshift', kind='Service', label_selector='app=galaxy') }}"

# Use parameters from a YAML config

- name: Load config from the Ansible controller filesystem
  set_fact:
    config: "{{ lookup('file', 'service.yml') | from_yaml }}"

- name: Using the config (loaded from a file in prior task), fetch the latest version of the object
  set_fact:
    service: "{{ lookup('openshift', resource_definition=config) }}"

- name: Use a config from the local filesystem
  set_fact:
    service: "{{ lookup('openshift', src='service.yml') }}"

Return Values

Common return values are documented here, the following are the fields unique to this lookup:

Status

Author

• UNKNOWN