oc — Управление ресурсами OpenShift
Новая версия 2.4.
УСТАРЕВШИЙ
| Удалено в Ansible: | |
|---|---|
| версия: 2.9 | |
| Почему: | Этот модуль использовал инструмент командной строки oc, в то время как openshift_raw работает с REST API. |
| Альтернатива: | Используйте openshift_raw вместо этого. |
Описание
- Этот модуль позволяет управлять ресурсами в кластере OpenShift. Хост инвентаризации может быть любым хостом с сетевым подключением к кластеру OpenShift; по умолчанию используется порт 8443/TCP.
- Этот модуль использует токен для аутентификации в OpenShift. Это может быть токен пользователя или сервисной учетной записи.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| host | Значение по умолчанию: "127.0.0.1" |
Имя хоста или адрес конечной точки API OpenShift. По умолчанию ожидается, что это текущий хост инвентаризации. |
| inline | Встроенное определение ресурса. Это взаимно исключающие параметры с name, namespace и kind.
псевдонимы: def, definition |
|
| kind обязательно |
Тип ресурса, для которого необходимо выполнить действие. |
|
| name | Имя ресурса, для которого необходимо выполнить действие. |
|
| namespace | Имя пространства имен ресурса, для которого необходимо выполнить действие. |
|
| port | Значение по умолчанию: 8443 |
Номер порта конечной точки API. |
| state обязательно |
|
Если state равен present, и ресурс не существует, он будет создан с использованием встроенного определения. Если state равен present, и ресурс существует, определение будет обновлено, опять же, с использованием встроенного определения. Если state равен absent, ресурс будет удалён, если он существует. |
| token обязательно |
Токен для аутентификации в кластере OpenShift. |
|
| validate_certs bool |
|
Если no, сертификаты SSL для целевого URL не будут проверены. Это следует использовать только на контролируемых вами сайтах, использующих самоподписанные сертификаты. |
Примеры
- name: Create project
oc:
state: present
inline:
kind: ProjectRequest
metadata:
name: ansibletestproject
displayName: Ansible Test Project
description: This project was created using Ansible
token: << redacted >>
- name: Delete a service
oc:
state: absent
name: myservice
namespace: mynamespace
kind: Service
token: << redacted >>
- name: Add project role Admin to a user
oc:
state: present
inline:
kind: RoleBinding
metadata:
name: admin
namespace: mynamespace
roleRef:
name: admin
userNames:
- "myuser"
token: << redacted >>
- name: Obtain an object definition
oc:
state: present
name: myroute
namespace: mynamespace
kind: Route
token: << redacted >>
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| method строка |
success | HTTP-метод, использованный для выполнения действия над ресурсом |
| result строка |
success | Ресурс, который был создан, изменён или иначе определён как существующий. В случае удаления — это ответ на запрос удаления. |
| url строка |
success | URL запрошенного ресурса. |
Статус
Этот модуль помечен как устаревший и будет удалён в версии 2.9. Дополнительная информация в разделе УСТАРЕВШИЙ.
Автор
- Kenneth D. Evensen (@kevensen)
Подсказка
Если вы заметите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/oc_module.html