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, определение | |
| kind - / обязательно | Тип ресурса, к которому нужно применить действие. | |
| name - | Имя ресурса, к которому нужно применить действие. | |
| namespace - | Пространство имён ресурса, к которому нужно применить действие. | |
| port - | По умолчанию: 8443 | Номер порта конечной точки API. |
| state - / обязательно |
| Если состояние — present, и ресурс не существует, он будет создан с помощью встроенного определения. Если состояние — present, и ресурс существует, определение будет обновлено, опять же с помощью встроенного определения. Если состояние — absent, ресурс будет удалён, если он существует. |
| token - / обязательно | Токен для аутентификации в кластере OpenShift. | |
| validate_certs boolean |
| Если 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.7/modules/oc_module.html