community.okd.oc connection – Execute tasks in pods running on OpenShift.

Note

This connection plugin is part of the community.okd collection (version 4.0.1).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install community.okd. You need further requirements to be able to use this connection plugin, see Requirements for details.

To use it in a playbook, specify: community.okd.oc.

Synopsis

  • Use the oc exec command to run tasks in, or put/fetch files to, pods running on the OpenShift container platform.

Requirements

The below requirements are needed on the local controller node that executes this connection.

  • oc (go binary)

Parameters

Parameter

Comments

ca_cert

aliases: oc_ssl_ca_cert

string

Path to a CA certificate used to authenticate with the API.

Default: ""

Configuration:

  • Environment variable: K8S_AUTH_SSL_CA_CERT

  • Variable: ansible_oc_ssl_ca_cert

  • Variable: ansible_oc_ca_cert

client_cert

aliases: oc_cert_file

string

Path to a certificate used to authenticate with the API.

Default: ""

Configuration:

  • Environment variable: K8S_AUTH_CERT_FILE

  • Variable: ansible_oc_cert_file

  • Variable: ansible_oc_client_cert

client_key

aliases: oc_key_file

string

Path to a key file used to authenticate with the API.

Default: ""

Configuration:

  • Environment variable: K8S_AUTH_KEY_FILE

  • Variable: ansible_oc_key_file

  • Variable: ansible_oc_client_key

oc_container

string

Container name. Required when a pod contains more than one container.

Default: ""

Configuration:

oc_context

string

The name of a context found in the K8s config file.

Default: ""

Configuration:

oc_extra_args

string

Extra arguments to pass to the oc command line.

Default: ""

Configuration:

oc_host

string

URL for accessing the API.

Default: ""

Configuration:

oc_kubeconfig

string

Path to a oc config file. Defaults to ~/.kube/config

Default: ""

Configuration:

  • Environment variable: K8S_AUTH_KUBECONFIG

  • Variable: ansible_oc_kubeconfig

  • Variable: ansible_oc_config

oc_local_env_vars

dictionary

added in community.okd 4.0.0

Local environment variable to be passed locally to the oc command line.

Please be aware that this passes information directly on the command line and it could expose sensitive data.

Default: {}

Configuration:

  • Variable: ansible_oc_local_env_vars

oc_namespace

string

The namespace of the pod

Default: ""

Configuration:

oc_pod

string

Pod name. Required when the host name does not match pod name.

Default: ""

Configuration:

  • Environment variable: K8S_AUTH_POD

  • Variable: ansible_oc_pod

oc_token

string

API authentication bearer token.

Configuration:

validate_certs

aliases: oc_verify_ssl

string

Whether or not to verify the API server’s SSL certificate. Defaults to true.

Default: ""

Configuration:

  • Environment variable: K8S_AUTH_VERIFY_SSL

  • Variable: ansible_oc_verify_ssl

  • Variable: ansible_oc_validate_certs

Authors

  • xuxinkun (@xuxinkun)

Hint

Configuration entries for each entry type have a low to high priority order. For example, a variable that is lower in the list will override a variable that is higher up.