k8s – Управление объектами Kubernetes (K8s)

• Обзор
• Требования
• Параметры
• Примечания
• Примеры
• Возвращаемые значения
• Статус

Обзор

• Используйте клиент OpenShift Python для выполнения операций CRUD над объектами K8s.
• Передавайте определение объекта из файла или встройте его. Смотрите примеры для чтения файлов и использования шаблонов Jinja.
• Доступ ко всему спектру API K8s.
• Используйте модуль k8s_facts для получения списка элементов об объекте типа kind.
• Авторизуйтесь с помощью файла конфигурации, сертификатов, пароля или токена.
• Поддерживает режим проверки.

Псевдонимы: k8s_raw, openshift_raw

Требования

Ниже приведены требования, необходимые на хосте, на котором выполняется этот модуль.

• python >= 2.7
• openshift >= 0.6
• PyYAML >= 3.11

Параметры

Примечания

Примеры

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

- name: Create a Service object from an inline definition
  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: 8000
          name: port-8000-tcp
          port: 8000

- name: Create a Service object by reading the definition from a file
  k8s:
    state: present
    src: /testing/service.yml

- name: Remove an existing Service object
  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
  k8s:
    state: present
    src: /testing/deployment.yml

- name: Read definition file from the Ansible controller file system
  k8s:
    state: present
    definition: "{{ lookup('file', '/testing/deployment.yml') }}"

- name: Read definition file from the Ansible controller file system after Jinja templating
  k8s:
    state: present
    definition: "{{ lookup('template', '/testing/deployment.yml') }}"

Возвращаемые значения

Общие значения возвращаемых данных документированы здесь, следующие — поля, уникальные для этого модуля:

Состояние

• Данный модуль не гарантирует обратную совместимость интерфейса. [превью]
• Этот модуль поддерживается сообществом Ansible. [сообщество]

Авторы

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