cmueller/ansible
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity
ansible/docs/docsite/rst/scenario_guides/kubernetes_scenarios/k8s_intro.rst
Abhijeet Kasurde 02658d7bf8
k8s: Scenario guides (#72095) 
* Start Kubernetes Scenario guides for users
* K8S inventory scenario guide

Signed-off-by: Abhijeet Kasurde <akasurde@redhat.com>
2020-10-20 10:11:33 -04:00

2.1 KiB
Raw Blame History

Introduction to Ansible for Kubernetes

Introduction

Modules for interacting with the Kubernetes (K8s) and OpenShift API are under development, and can be used in preview mode. To use them, review the requirements, and then follow the installation and use instructions.

Requirements

To use the modules, you'll need the following:

  • Run Ansible from source. For assistance, view from_source.
  • OpenShift Rest 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 community.kubernetes

Authenticating with the API

By default the OpenShift Rest Client will look for ~/.kube/config, and if found, connect using the active context. You can override the location of the file using thekubeconfig 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, please file issues at Ansible Kubernetes collection. If you find a bug regarding OpenShift client, please file issues at OpenShift REST Client issues. If you find a bug regarding Kubectl binary, please file issues at Kubectl issue tracker