terraform/website/source/docs/providers/cobbler/r/system.html.markdown

190 lines
4.8 KiB
Markdown
Raw Normal View History

---
layout: "cobbler"
page_title: "Cobbler: cobbler_system"
sidebar_current: "docs-cobbler-resource-system"
description: |-
Manages a System within Cobbler.
---
# cobbler\_system
Manages a System within Cobbler.
## Example Usage
```
resource "cobbler_system" "my_system" {
name = "my_system"
profile = "${cobbler_profile.my_profile.name}"
name_servers = ["8.8.8.8", "8.8.4.4"]
comment = "I'm a system"
interface {
name = "eth0"
mac_address = "aa:bb:cc:dd:ee:ff"
static = true
ip_address = "1.2.3.4"
netmask = "255.255.255.0"
}
interface {
name = "eth1"
mac_address = "aa:bb:cc:dd:ee:fa"
static = true
ip_address = "1.2.3.5"
netmask = "255.255.255.0"
}
}
```
## Argument Reference
The following arguments are supported:
* `boot_files` - (Optional) TFTP boot files copied into tftpboot.
* `comment` - (Optional) Free form text description
* `enable_gpxe` - (Optional) Use gPXE instead of PXELINUX.
* `fetchable_files` - (Optional) Templates for tftp or wget.
* `gateway` - (Optional) Network gateway.
* `hostname` - (Optional) Hostname of the system.
* `image` - (Optional) Parent image (if no profile is used).
* `interface` - (Optional)
* `ipv6_default_device` - (Optional) IPv6 default device.
* `kernel_options` - (Optional) Kernel options.
ex: selinux=permissive.
* `kernel_options_post` - (Optional) Kernel options (post install).
* `kickstart` - (Optional) Path to kickstart template.
* `ks_meta` - (Optional) Kickstart metadata.
* `ldap_enabled` - (Optional) Configure LDAP at next config update.
* `ldap_type` - (Optional) LDAP management type.
* `mgmt_classes` - (Optional) Management classes for external config
management.
* `mgmt_parameters` - (Optional) Parameters which will be handed to
your management application. Must be a valid YAML dictionary.
* `monit_enabled` - (Optional) Configure monit on this machine at
next config update.
* `name_servers_search` - (Optional) Name servers search path.
* `name_servers` - (Optional) Name servers.
* `name` - (Required) The name of the system.
* `netboot_enabled` - (Optional) (re)Install this machine at next
boot.
* `owners` - (Optional) Owners list for authz_ownership.
* `power_address` - (Optional) Power management address.
* `power_id` - (Optional) Usually a plug number or blade name if
power type requires it.
* `power_pass` - (Optional) Power management password.
* `power_type` - (Optional) Power management type.
* `power_user` - (Optional) Power management user.
* `profile` - (Required) Parent profile.
* `proxy` - (Optional) Proxy URL.
* `redhat_management_key` - (Optional) Red Hat management key.
* `redhat_management_server` - (Optional) Red Hat management server.
* `status` - (Optional) System status (development, testing,
acceptance, production).
* `template_files` - (Optional) File mappings for built-in
configuration management.
* `template_remote_kickstarts` - (Optional) template remote
kickstarts.
* `virt_auto_boot` - (Optional) Auto boot the VM.
* `virt_cpus` - (Optional) Number of virtual CPUs in the VM.
* `virt_disk_driver` - (Optional) The on-disk format for the
virtualization disk.
* `virt_file_size` - (Optional) Virt file size.
* `virt_path` - (Optional) Path to the VM.
* `virt_pxe_boot` - (Optional) Use PXE to build this VM?
* `virt_ram` - (Optional) The amount of RAM for the VM.
* `virt_type` - (Optional) Virtualization technology to use: xenpv,
xenfv, qemu, kvm, vmware, openvz.
The `interface` block supports:
* `name` - (Required) The device name of the interface. ex: eth0.
* `cnames` - (Optional) Canonical name records.
* `dhcp_tag` - (Optional) DHCP tag.
* `dns_name` - (Optional) DNS name.
* `bonding_opts` - (Optional) Options for bonded interfaces.
* `bridge_opts` - (Optional) Options for bridge interfaces.
* `gateway` - (Optional) Per-interface gateway.
* `interface_type` - (Optional) The type of interface: na, master,
slave, bond, bond_slave, bridge, bridge_slave, bonded_bridge_slave.
* `interface_master` - (Optional) The master interface when slave.
* `ip_address` - (Optional) The IP address of the interface.
* `ipv6_address` - (Optional) The IPv6 address of the interface.
* `ipv6_mtu` - (Optional) The MTU of the IPv6 adress.
* `ipv6_static_routes` - (Optional) Static routes for the IPv6
interface.
* `ipv6_default_gateway` - (Optional) The default gateawy for the
IPv6 address / interface.
* `mac_address` - (Optional) The MAC address of the interface.
* `management` - (Optional) Whether this interface is a management
interface.
* `netmask` - (Optional) The IPv4 netmask of the interface.
* `static` - (Optional) Whether the interface should be static or
DHCP.
* `static_routes` - (Optional) Static routes for the interface.
* `virt_bridge` - (Optional) The virtual bridge to attach to.
## Attribute Reference
All optional attributes listed above are also exported.