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

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

Обзор

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

Псевдонимы: 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: Get an existing Service object
  k8s:
    api_version: v1
    kind: Service
    name: web
    namespace: testing
  register: web_service

- name: Get a list of all service objects
  k8s:
    api_version: v1
    kind: ServiceList
    namespace: testing
  register: service_list

- 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') | from_yaml }}"

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

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

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

Статус

Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость интерфейса.

Техническое обслуживание

Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. См. Поддержка модулей и обслуживание для получения дополнительной информации.

Список других модулей, которые также поддерживаются сообществом Ansible, см. на странице здесь.

Автор

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