Introduction to Ansible for Kubernetes
Introduction
The kubernetes.core collection offers several modules and plugins for orchestrating Kubernetes.
Requirements
To use the modules, you’ll need the following:
Ansible 2.9.17 or latest installed
Kubernetes Python client installed on the host that will execute the modules.
Installation
The Kubernetes modules are part of the Ansible Kubernetes collection.
To install the collection, run the following:
$ ansible-galaxy collection install kubernetes.core
Authenticating with the API
By default the Kubernetes Rest Client will look for ~/.kube/config
, and if found, connect using the active context. You can override the location of the file using the kubeconfig
parameter, and the context, using the context
parameter.
Basic authentication is also supported using the username
and password
options. You can override the URL using the host
parameter. Certificate authentication works through the ssl_ca_cert
, cert_file
, and key_file
parameters, and for token authentication, use the api_key
parameter.
To disable SSL certificate verification, set verify_ssl
to false.
Reporting an issue
If you find a bug or have a suggestion regarding modules or plugins, please file issues at Ansible Kubernetes collection.
If you find a bug regarding Kubernetes Python client, please file issues at Kubernetes Client issues.
If you find a bug regarding Kubectl binary, please file issues at Kubectl issue tracker
If you find a bug regarding Helm binary, please file issues at Helm issue tracker.