New in version 2.7.
The below requirements are needed on the host that executes this module.
Parameter | Choices/Defaults | Comments |
---|---|---|
api_key |
Token used to authenticate with the API. Can also be specified via K8S_AUTH_API_KEY environment variable.
|
|
api_version |
Default: v1
|
Use to specify the API version. in conjunction with kind, name, and namespace to identify a specific object.
aliases: api, version |
cert_file |
Path to a certificate used to authenticate with the API. Can also be specified via K8S_AUTH_CERT_FILE environment variable.
|
|
context |
The name of a context found in the config file. Can also be specified via K8S_AUTH_CONTEXT environment variable.
|
|
field_selectors |
List of field selectors to use to filter results
|
|
host |
Provide a URL for accessing the API. Can also be specified via K8S_AUTH_HOST environment variable.
|
|
key_file |
Path to a key file used to authenticate with the API. Can also be specified via K8S_AUTH_HOST environment variable.
|
|
kind
required |
Use to specify an object model. Use in conjunction with api_version, name, and namespace to identify a specific object.
|
|
kubeconfig |
Path to an existing Kubernetes config file. If not provided, and no other connection options are provided, the openshift client will attempt to load the default configuration file from ~/.kube/config.json. Can also be specified via K8S_AUTH_KUBECONFIG environment variable.
|
|
label_selectors |
List of label selectors to use to filter results
|
|
name |
Use to specify an object name. Use in conjunction with api_version, kind and namespace to identify a specific object.
|
|
namespace |
Use to specify an object namespace. Use in conjunction with api_version, kind, and name to identify a specfic object.
|
|
password |
Provide a password for authenticating with the API. Can also be specified via K8S_AUTH_PASSWORD environment variable.
|
|
ssl_ca_cert |
Path to a CA certificate used to authenticate with the API. Can also be specified via K8S_AUTH_SSL_CA_CERT environment variable.
|
|
username |
Provide a username for authenticating with the API. Can also be specified via K8S_AUTH_USERNAME environment variable.
|
|
verify_ssl
bool |
|
Whether or not to verify the API server's SSL certificates. Can also be specified via K8S_AUTH_VERIFY_SSL environment variable.
|
Note
- name: Get an existing Service object
k8s_facts:
api_version: v1
kind: Service
name: web
namespace: testing
register: web_service
- name: Get a list of all service objects
k8s_facts:
api_version: v1
kind: Service
namespace: testing
register: service_list
- name: Get a list of all pods from any namespace
k8s_facts:
kind: Pod
register: pod_list
- name: Search for all Pods labelled app=web
k8s_facts:
kind: Pod
label_selectors:
- app = web
- tier in (dev, test)
- name: Search for all running pods
k8s_facts:
kind: Pod
field_selectors:
- status.phase = running
Common return values are documented here, the following are the fields unique to this module:
Key | Returned | Description | |
---|---|---|---|
resources
complex
|
success |
The object(s) that exists
|
|
api_version
str
|
success |
The versioned schema of this representation of an object.
|
|
kind
str
|
success |
Represents the REST resource this object represents.
|
|
metadata
dict
|
success |
Standard object metadata. Includes name, namespace, annotations, labels, etc.
|
|
spec
dict
|
success |
Specific attributes of the object. Will vary based on the api_version and kind.
|
|
status
dict
|
success |
Current status details for the object.
|
This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.
Hint
If you notice any issues in this documentation you can edit this document to improve it.