Getting Started with Kubernetes and OpenShift

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

    • Run Ansible from source. For assistance, view
    • OpenShift Rest Client installed on the host that will execute the modules

    The individual modules, as of this writing, are not part of the Ansible repository, but they can be accessed by installing the role, , and including it in a playbook.

    To install, run the following:

    1. ---
    2. remote_user: root
    3. roles:
    4. - role: ansible.kubernetes-modules

    Because the role is referenced, is able to access the modules, and use them to deploy an application.

    The modules are found in the library folder of the role. Each includes full documentation for parameters and the returned data structure. However, not all modules include examples, only those where testing data has been created.

    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 parameter.

    To disable SSL certificate verification, set to false.

    If you find a bug or have a suggestion regarding individual modules or the role, please file issues at .

    There is also a utility module, k8s_common.py, that is part of the Ansible repo. If you find a bug or have suggestions regarding it, please file issues at .