Ansible kubernetes.core.k8s: ejemplo de administración de objetos de Kubernetes (K8s)

Nota

Este complemento es parte del colección kubernetes.core (versión 1.1.1).

Para instalarlo use: ansible-galaxy collection install kubernetes.core.

Para usarlo en un libro de jugadas, especifique: kubernetes.core.k8s.

• Sinopsis
• Requisitos
• Parámetros
• Notas
• Ejemplos de
• Valores devueltos

Sinopsis

• Utilice el cliente OpenShift Python para realizar operaciones CRUD en objetos K8s.
• Pase la definición del objeto desde un archivo fuente o en línea. Vea ejemplos para leer archivos y usar plantillas Jinja o archivos cifrados en bóveda.
• Acceso a la gama completa de API de K8.
• Utilizar el kubernetes.core.k8s_info módulo para obtener una lista de elementos sobre un objeto de tipo kind
• Autentíquese mediante un archivo de configuración, certificados, contraseña o token.
• Admite el modo de verificación.

Nota

Este módulo tiene un correspondiente complemento de acción.

Requisitos

Los siguientes requisitos son necesarios en el host que ejecuta este módulo.

• pitón> = 2.7
• desplazamiento abierto> = 0,6
• PyYAML> = 3,11

Parámetros

Notas

Nota

• Si su biblioteca OpenShift Python no es 0.9.0 o más reciente y está tratando de eliminar un elemento de una matriz / diccionario asociativo, por ejemplo, una etiqueta o una anotación, deberá establecer explícitamente el valor del elemento que se eliminará. null. Simplemente eliminar la entrada en el diccionario no la eliminará de openshift o kubernetes.
• El cliente OpenShift Python envuelve el cliente Python de K8s, proporcionando acceso completo a todos los APIS y modelos disponibles en ambas plataformas. Para obtener detalles de la versión de API e información adicional, visite https://github.com/openshift/openshift-restclient-python
• Para evitar errores de validación del certificado SSL cuando validate_certs es Cierto, la cadena de certificados completa para el servidor API debe proporcionarse a través de ca_cert o en el archivo kubeconfig.

Ejemplos de

-name: Create a k8s namespace
  kubernetes.core.k8s:name: testing
    api_version: v1
    kind: Namespace
    state: present

-name: Create a Service object from an inline definition
  kubernetes.core.k8s:state: present
    definition:apiVersion: v1
      kind: Service
      metadata:name: web
        namespace: testing
        labels:app: galaxy
          service: web
      spec:selector:app: galaxy
          service: web
        ports:-protocol: TCP
          targetPort:8000name: port-8000-tcp
          port:8000-name: Remove an existing Service object
  kubernetes.core.k8s:state: absent
    api_version: v1
    kind: Service
    namespace: testing
    name: web

# Passing the object definition from a file-name: Create a Deployment by reading the definition from a local file
  kubernetes.core.k8s:state: present
    src: /testing/deployment.yml

-name:>-
    Read definition file from the Ansible controller file system.
    If the definition file has been encrypted with Ansible Vault it will automatically be decrypted.
  kubernetes.core.k8s:state: present
    definition:" from_yaml "-name: Read definition template file from the Ansible controller file system
  kubernetes.core.k8s:state: present
    template:'/testing/deployment.j2'-name: Read definition template file from the Ansible controller file system that uses custom start/end strings
  kubernetes.core.k8s:state: present
    template:path:'/testing/deployment.j2'variable_start_string:'[['variable_end_string:']]'-name: fail on validation errors
  kubernetes.core.k8s:state: present
    definition:" lookup('template', '/testing/deployment.yml') "validate:fail_on_error: yes

-name: warn on validation errors, check for unexpected properties
  kubernetes.core.k8s:state: present
    definition:" from_yaml "validate:fail_on_error: no
      strict: yes

Valores devueltos

Los valores de retorno comunes están documentados aquí, los siguientes son los campos exclusivos de este módulo:

Autores

• Chris Houseknecht (@chouseknecht)
• Fabian von Feilitzsch (@fabianvf)