theforeman.foreman.compute_profile 模块 – 管理计算配置

注意

此模块是 theforeman.foreman 集合(版本 4.2.0)的一部分。

如果您正在使用 ansible 包,您可能已经安装了这个集合。它不包含在 ansible-core 中。要检查是否已安装,请运行 ansible-galaxy collection list

要安装它,请使用:ansible-galaxy collection install theforeman.foreman。您需要其他要求才能使用此模块,有关详细信息,请参阅 要求

要在 playbook 中使用它,请指定:theforeman.foreman.compute_profile

theforeman.foreman 1.0.0 中的新增功能

概要

  • 创建、更新和删除计算配置

别名:foreman_compute_profile

要求

以下要求需要在执行此模块的主机上满足。

  • requests

参数

参数

注释

compute_attributes

list / elements=dictionary

与此计算配置相关的计算属性。其中一些属性特定于底层计算资源类型

compute_resource

string

属性应针对的计算资源的名称

vm_attrs

别名:vm_attributes

dictionary

包含 vm_attrs 数据的哈希

name

string / required

计算配置名称

password

string / required

访问 Foreman 服务器的用户的密码。

如果任务中未指定该值,则将使用环境变量 FOREMAN_PASSWORD 的值代替。

server_url

string / required

Foreman 服务器的 URL。

如果任务中未指定该值,则将使用环境变量 FOREMAN_SERVER_URL 的值代替。

state

string

实体的状态

选项

  • "present" ← (默认)

  • "absent"

updated_name

string

新的计算配置名称

username

string / required

访问 Foreman 服务器的用户名。

如果任务中未指定该值,则将使用环境变量 FOREMAN_USERNAME 的值代替。

validate_certs

boolean

是否验证 Foreman 服务器的 TLS 证书。

如果任务中未指定该值,则将使用环境变量 FOREMAN_VALIDATE_CERTS 的值代替。

选项

  • false

  • true ← (默认)

属性

属性

支持

描述

check_mode

支持: 完全

可以在 check_mode 中运行并返回更改状态预测,而无需修改实体

diff_mode

支持: 完全

在 diff 模式下,将返回有关已更改的内容(或在 check_mode 中可能需要更改的内容)的详细信息

示例

- name: compute profile
  theforeman.foreman.compute_profile:
    name: example_compute_profile
    server_url: "https://foreman.example.com"
    username: "admin"
    password: "changeme"
    state: present

- name: another compute profile
  theforeman.foreman.compute_profile:
    name: another_example_compute_profile
    compute_attributes:
      - compute_resource: ovirt_compute_resource1
        vm_attrs:
          cluster: 'a96d44a4-f14a-1015-82c6-f80354acdf01'
          template: 'c88af4b7-a24a-453b-9ac2-bc647ca2ef99'
          instance_type: 'cb8927e7-a404-40fb-a6c1-06cbfc92e077'
    server_url: "https://foreman.example.com"
    username: "admin"
    password: "changeme"
    state: present

- name: compute profile2
  theforeman.foreman.compute_profile:
    name: example_compute_profile2
    compute_attributes:
      - compute_resource: ovirt_compute_resource01
        vm_attrs:
          cluster: a96d44a4-f14a-1015-82c6-f80354acdf01
          cores: 1
          sockets: 1
          memory: 1073741824
          ha: 0
          interfaces_attributes:
            0:
              name: ""
              network: 390666e1-dab3-4c99-9f96-006b2e2fd801
              interface: virtio
          volumes_attributes:
            0:
              size_gb: 16
              storage_domain: 19c50090-1ab4-4023-a63f-75ee1018ed5e
              preallocate: '1'
              wipe_after_delete: '0'
              interface: virtio_scsi
              bootable: 'true'
      - compute_resource: libvirt_compute_resource03
        vm_attrs:
          cpus: 1
          memory: 2147483648
          nics_attributes:
            0:
              type: bridge
              bridge: ""
              model: virtio
          volumes_attributes:
            0:
              pool_name: default
              capacity: 16G
              allocation: 16G
              format_type: raw
    server_url: "https://foreman.example.com"
    username: "admin"
    password: "changeme"
    state: present

- name: Remove compute profile
  theforeman.foreman.compute_profile:
    name: example_compute_profile2
    server_url: "https://foreman.example.com"
    username: "admin"
    password: "changeme"
    state: absent

返回值

常用返回值记录在此处,以下是此模块独有的字段

描述

entity

dictionary

受影响实体的最终状态,按其类型分组。

返回: 成功

compute_profiles

list / elements=dictionary

计算配置列表。

返回: 成功

compute_attributes

list / elements=string

此计算配置的属性。

返回: 成功

id

integer

计算配置的数据库 ID。

返回: 成功

name

string

计算配置的名称。

返回: 成功

作者

  • Philipp Joos (@philippj)

  • Baptiste Agasse (@bagasse)