community.digitalocean.digital_ocean_kubernetes модуль — Создание и удаление кластера Kubernetes DigitalOcean
Примечание
Этот модуль входит в коллекцию community.digitalocean (версия 1.27.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install community.digitalocean.
Для использования в книге задач укажите: community.digitalocean.digital_ocean_kubernetes.
Новое в community.digitalocean 1.3.0
Описание
- Создание и удаление кластера Kubernetes в DigitalOcean (и, по желанию, ожидание его запуска).
Параметры
Параметр | Комментарии |
|---|---|
auto_upgrade boolean | Логическое значение, указывающее, будет ли кластер автоматически обновляться до новых исправлений во время окна технического обслуживания. Варианты:
|
ha boolean | Логическое значение, указывающее, будет ли управляющая плоскость кластера настроена в высокодоступной конфигурации. Высокодоступные управляющие плоскости приводят к меньшему времени простоя. Варианты:
|
maintenance_policy dictionary | Объект, определяющий политику окна технического обслуживания для кластера Kubernetes (см. таблицу ниже). |
name string / обязательный | Наименование кластера Kubernetes, понятное для человека. |
node_pools list / элементы=dictionary | Объект, определяющий подробности рабочих узлов, доступных для кластера Kubernetes (см. таблицу ниже). По умолчанию: |
|
auto_scale boolean |
Логическое значение, указывающее, включена ли автоматическая масштабируемость для этого пула узлов. Варианты:
|
|
count integer |
Количество экземпляров Droplet в пуле узлов. |
|
labels dictionary |
Объект, содержащий набор меток Kubernetes. Ключи определяются пользователем. |
|
max_nodes integer |
Максимальное количество узлов, до которого может быть автоматически масштабирован этот пул узлов. Значение будет |
|
min_nodes integer |
Минимальное количество узлов, до которого может быть автоматически масштабирован этот пул узлов. Значение будет |
|
name string |
Наименование пула узлов, понятное для человека. |
|
size string |
Идентификатор-слово для типа Droplet, используемого в качестве рабочих узлов в пуле узлов. |
|
tags list / элементы=string |
Массив, содержащий метки, применённые к пулу узлов. Все пулы узлов автоматически помечены |
|
taints list / элементы=dictionary |
Массив пометок, которые необходимо применить ко всем узлам в пуле. Пометки автоматически применяются ко всем существующим узлам и любым последующим узлам, добавленным в пул. При удалении пометки она удаляется со всех узлов в пуле. |
oauth_token псевдонимы: API_TOKEN string / обязательный | Токен DigitalOcean OAuth; может быть указан в |
project_name псевдонимы: project string | Проект, которому необходимо назначить ресурс (название проекта, а не UUID). По умолчанию используется по умолчанию проект учётной записи (пустая строка). По умолчанию: |
region псевдонимы: region_id string | Идентификатор-слово региона, в котором будет создан кластер Kubernetes. По умолчанию: |
return_kubeconfig boolean | Управляет тем, будет ли возвращён Варианты:
|
state string | Обычное значение, Выбор:
|
surge_upgrade boolean | Булево значение, указывающее, включено/выключено ли масштабируемое обновление кластера. Масштабируемое обновление ускоряет и делает надёжными обновления кластера, запуская новые узлы до удаления устаревших. Выбор:
|
tags list / elements=string | Плоский массив имён тегов в виде строк, которые нужно применить к кластеру Kubernetes. Все кластеры будут автоматически помечены тегами “k8s” и “k8s:$K8S_CLUSTER_ID” помимо любых тегов, предоставленных пользователем. |
version string | Идентификатор-имя для версии Kubernetes, используемой для кластера. См. конечную точку /v2/kubernetes/options для доступных версий. По умолчанию: |
vpc_uuid string | Строка, определяющая UUID VPC, к которому будет назначен кластер Kubernetes. Если не указано, кластер будет назначен к VPC по умолчанию для вашей учётной записи в данном регионе. |
wait boolean | Подождать, пока кластер не заработает, прежде чем возвращаться. Выбор:
|
wait_timeout integer | Сколько времени подождать, прежде чем ожидание прекратится (в секундах), при создании кластера. По умолчанию: |
Примеры
- name: Create a new DigitalOcean Kubernetes cluster in New York 1
community.digitalocean.digital_ocean_kubernetes:
state: present
oauth_token: "{{ lookup('env', 'DO_API_TOKEN') }}"
name: hacktoberfest
region: nyc1
node_pools:
- name: hacktoberfest-workers
size: s-1vcpu-2gb
count: 3
return_kubeconfig: true
wait_timeout: 600
register: my_cluster
- name: Show the kubeconfig for the cluster we just created
debug:
msg: "{{ my_cluster.data.kubeconfig }}"
- name: Destroy (delete) an existing DigitalOcean Kubernetes cluster
community.digitalocean.digital_ocean_kubernetes:
state: absent
oauth_token: "{{ lookup('env', 'DO_API_TOKEN') }}"
name: hacktoberfest
- name: Create a new DigitalOcean Kubernetes cluster assigned to Project "test"
community.digitalocean.digital_ocean_kubernetes:
state: present
oauth_token: "{{ lookup('env', 'DO_API_TOKEN') }}"
name: hacktoberfest
region: nyc1
node_pools:
- name: hacktoberfest-workers
size: s-1vcpu-2gb
count: 3
return_kubeconfig: true
project: test
wait_timeout: 600
register: my_cluster
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие поля уникальны для данного модуля:
Ключ | Описание |
|---|---|
data dictionary | Кластер Kubernetes DigitalOcean (и необязательные Возвращаемое значение: changed Пример: |
Ссылки на коллекцию
© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/digitalocean/digital_ocean_kubernetes_module.html
