diff --git a/docs/index.md b/docs/index.md index 9c768c9..2a1505d 100644 --- a/docs/index.md +++ b/docs/index.md @@ -40,11 +40,11 @@ provider "cobbler" { ### Required -- **password** (String) The password to the Cobbler service. This can also be specified with the `COBBLER_PASSWORD` shell environment variable. -- **url** (String) The url to the Cobbler service. This can also be specified with the `COBBLER_URL` shell environment variable. -- **username** (String) The username to the Cobbler service. This can also be specified with the `COBBLER_USERNAME` shell environment variable. +- `password` (String) The password to the Cobbler service. This can also be specified with the `COBBLER_PASSWORD` shell environment variable. +- `url` (String) The url to the Cobbler service. This can also be specified with the `COBBLER_URL` shell environment variable. +- `username` (String) The username to the Cobbler service. This can also be specified with the `COBBLER_USERNAME` shell environment variable. ### Optional -- **cacert_file** (String) The path or contents of an SSL CA certificate. This can also be specified with the `COBBLER_CACERT_FILE`shell environment variable. -- **insecure** (Boolean) The url to the Cobbler service. This can also be specified with the `COBBLER_URL` shell environment variable. \ No newline at end of file +- `cacert_file` (String) The path or contents of an SSL CA certificate. This can also be specified with the `COBBLER_CACERT_FILE`shell environment variable. +- `insecure` (Boolean) The url to the Cobbler service. This can also be specified with the `COBBLER_URL` shell environment variable. \ No newline at end of file diff --git a/docs/resources/distro.md b/docs/resources/distro.md index a0530ac..5f112c0 100644 --- a/docs/resources/distro.md +++ b/docs/resources/distro.md @@ -28,23 +28,25 @@ resource "cobbler_distro" "Ubuntu-2004-x86_64" { ### Required -- **breed** (String) The "breed" of distribution. Valid options are: redhat, fedora, centos, scientific linux, suse, debian, and ubuntu. These choices may vary depending on the version of Cobbler in use. -- **initrd** (String) Absolute path to initrd on filesystem. This must already exist prior to creating the distro. -- **kernel** (String) Absolute path to kernel on filesystem. This must already exist prior to creating the distro. -- **name** (String) A name for the distro. -- **os_version** (String) The version of the distro you are creating. This varies with the version of Cobbler you are using. An updated signature list may need to be obtained in order to support a newer version. Example: `focal`. +- `breed` (String) The "breed" of distribution. Valid options are: redhat, fedora, centos, scientific linux, suse, debian, and ubuntu. These choices may vary depending on the version of Cobbler in use. +- `initrd` (String) Absolute path to initrd on filesystem. This must already exist prior to creating the distro. +- `kernel` (String) Absolute path to kernel on filesystem. This must already exist prior to creating the distro. +- `name` (String) A name for the distro. +- `os_version` (String) The version of the distro you are creating. This varies with the version of Cobbler you are using. An updated signature list may need to be obtained in order to support a newer version. Example: `focal`. ### Optional -- **arch** (String) The architecture of the distro. Valid options are: i386, x86_64, ia64, ppc, ppc64, s390, arm. -- **boot_files** (String) Files copied into tftpboot beyond the kernel/initrd. -- **comment** (String) Free form text description. -- **fetchable_files** (String) Templates for tftp or wget. -- **id** (String) The ID of this resource. -- **kernel_options** (String) Kernel options to use with the kernel. -- **kernel_options_post** (String) Post install Kernel options to use with the kernel after installation. -- **mgmt_classes** (List of String) Management classes for external config management. -- **owners** (List of String) Owners list for authz_ownership. -- **template_files** (String) File mappings for built-in config management. +- `arch` (String) The architecture of the distro. Valid options are: i386, x86_64, ia64, ppc, ppc64, s390, arm. +- `boot_files` (List of String) Files copied into tftpboot beyond the kernel/initrd. +- `boot_loaders` (List of String) Must be either 'grub', 'pxe', or 'ipxe'. +- `comment` (String) Free form text description. +- `fetchable_files` (List of String) Templates for tftp or wget. +- `kernel_options` (List of String) Kernel options to use with the kernel. +- `kernel_options_post` (List of String) Post install Kernel options to use with the kernel after installation. +- `mgmt_classes` (List of String) Management classes for external config management. +- `owners` (List of String) Owners list for authz_ownership. +- `template_files` (List of String) File mappings for built-in config management. +### Read-Only +- `id` (String) The ID of this resource. diff --git a/docs/resources/profile.md b/docs/resources/profile.md index 1ce2fb1..c0a10ee 100644 --- a/docs/resources/profile.md +++ b/docs/resources/profile.md @@ -25,41 +25,42 @@ resource "cobbler_profile" "my_profile" { ### Required -- **distro** (String) Parent distribution. -- **name** (String) The name of the profile. +- `distro` (String) Parent distribution. +- `name` (String) The name of the profile. ### Optional -- **autoinstall** (String) Template remote kickstarts or preseeds. -- **autoinstall_meta** (String) Automatic installation template metadata, formerly Kickstart metadata. -- **boot_files** (String) Files copied into tftpboot beyond the kernel/initrd. -- **comment** (String) Free form text description. -- **dhcp_tag** (String) DHCP tag. -- **enable_gpxe** (Boolean) Use gPXE instead of PXELINUX for advanced booting options. -- **enable_menu** (Boolean) Enable a boot menu. -- **fetchable_files** (String) Templates for tftp or wget. -- **id** (String) The ID of this resource. -- **kernel_options** (String) Kernel options for the profile. -- **kernel_options_post** (String) Post install kernel options. -- **mgmt_classes** (List of String) For external configuration management. -- **mgmt_parameters** (String) Parameters which will be handed to your management application (Must be a valid YAML dictionary). -- **name_servers** (List of String) Name servers. -- **name_servers_search** (List of String) Name server search settings. -- **next_server_v4** (String) The next_server_v4 option is used for DHCP/PXE as the IP of the TFTP server from which network boot files are downloaded. Usually, this will be the same IP as the server setting. -- **next_server_v6** (String) The next_server_v4 option is used for DHCP/PXE as the IP of the TFTP server from which network boot files are downloaded. Usually, this will be the same IP as the server setting. -- **owners** (List of String) Owners list for authz_ownership. -- **parent** (String) The parent this profile inherits settings from. -- **proxy** (String) Proxy URL. -- **repos** (List of String) Repos to auto-assign to this profile. -- **server** (String) The server-override for the profile. -- **template_files** (String) File mappings for built-in config management. -- **virt_auto_boot** (String) Auto boot virtual machines. -- **virt_bridge** (String) The bridge for virtual machines. -- **virt_cpus** (String) The number of virtual CPUs -- **virt_disk_driver** (String) The virtual machine disk driver. -- **virt_file_size** (String) The virtual machine file size. -- **virt_path** (String) The virtual machine path. -- **virt_ram** (String) The amount of RAM for the virtual machine. -- **virt_type** (String) The type of virtual machine. Valid options are: xenpv, xenfv, qemu, kvm, vmware, openvz. +- `autoinstall` (String) Template remote kickstarts or preseeds. +- `autoinstall_meta` (List of String) Automatic installation template metadata, formerly Kickstart metadata. +- `boot_files` (List of String) Files copied into tftpboot beyond the kernel/initrd. +- `comment` (String) Free form text description. +- `dhcp_tag` (String) DHCP tag. +- `enable_gpxe` (Boolean) Use gPXE instead of PXELINUX for advanced booting options. +- `enable_menu` (Boolean) Enable a boot menu. +- `fetchable_files` (List of String) Templates for tftp or wget. +- `kernel_options` (List of String) Kernel options for the profile. +- `kernel_options_post` (List of String) Post install kernel options. +- `mgmt_classes` (List of String) For external configuration management. +- `mgmt_parameters` (String) Parameters which will be handed to your management application (Must be a valid YAML dictionary). +- `name_servers` (List of String) Name servers. +- `name_servers_search` (List of String) Name server search settings. +- `next_server_v4` (String) The next_server_v4 option is used for DHCP/PXE as the IP of the TFTP server from which network boot files are downloaded. Usually, this will be the same IP as the server setting. +- `next_server_v6` (String) The next_server_v6 option is used for DHCP/PXE as the IP of the TFTP server from which network boot files are downloaded. Usually, this will be the same IP as the server setting. +- `owners` (List of String) Owners list for authz_ownership. +- `parent` (String) The parent this profile inherits settings from. +- `proxy` (String) Proxy URL. +- `repos` (List of String) Repos to auto-assign to this profile. +- `server` (String) The server-override for the profile. +- `template_files` (List of String) File mappings for built-in config management. +- `virt_auto_boot` (String) Auto boot virtual machines. +- `virt_bridge` (String) The bridge for virtual machines. +- `virt_cpus` (String) The number of virtual CPUs +- `virt_disk_driver` (String) The virtual machine disk driver. +- `virt_file_size` (String) The virtual machine file size. +- `virt_path` (String) The virtual machine path. +- `virt_ram` (String) The amount of RAM for the virtual machine. +- `virt_type` (String) The type of virtual machine. Valid options are: xenpv, xenfv, qemu, kvm, vmware, openvz. +### Read-Only +- `id` (String) The ID of this resource. diff --git a/docs/resources/repo.md b/docs/resources/repo.md index 1e57e70..5bfb50a 100644 --- a/docs/resources/repo.md +++ b/docs/resources/repo.md @@ -28,23 +28,24 @@ resource "cobbler_repo" "my_repo" { ### Required -- **breed** (String) The "breed" of distribution. Valid options are: rsync, rhn, yum, apt, and wget. These choices may vary depending on the version of Cobbler in use. -- **mirror** (String) Address of the repo to mirror. -- **name** (String) A name for the repo. +- `breed` (String) The "breed" of distribution. Valid options are: rsync, rhn, yum, apt, and wget. These choices may vary depending on the version of Cobbler in use. +- `mirror` (String) Address of the repo to mirror. +- `name` (String) A name for the repo. ### Optional -- **apt_components** (List of String) List of Apt components such as main, restricted, universe. Applicable to apt breeds only. -- **apt_dists** (List of String) List of Apt distribution names such as focal, focal-updates. Applicable to apt breeds only. -- **arch** (String) The architecture of the repo. Valid options are: i386, x86_64, ia64, ppc, ppc64, s390, arm. -- **comment** (String) Free form text description. -- **createrepo_flags** (String) Flags to use with `createrepo`. -- **environment** (String) Environment variables to use during repo command execution. -- **id** (String) The ID of this resource. -- **keep_updated** (Boolean) Update the repo upon Cobbler sync. Valid values are true or false. -- **mirror_locally** (Boolean) Whether to copy the files locally or just references to the external files. Valid values are true or false. -- **owners** (List of String) List of Owners for authz_ownership. -- **proxy** (String) Proxy to use for downloading the repo. This argument does not work on older versions of Cobbler. -- **rpm_list** (List of String) List of specific RPMs to mirror. - - +- `apt_components` (List of String) List of Apt components such as main, restricted, universe. Applicable to apt breeds only. +- `apt_dists` (List of String) List of Apt distribution names such as focal, focal-updates. Applicable to apt breeds only. +- `arch` (String) The architecture of the repo. Valid options are: i386, x86_64, ia64, ppc, ppc64, s390, arm. +- `comment` (String) Free form text description. +- `createrepo_flags` (String) Flags to use with `createrepo`. +- `environment` (String) Environment variables to use during repo command execution. +- `keep_updated` (Boolean) Update the repo upon Cobbler sync. Valid values are true or false. +- `mirror_locally` (Boolean) Whether to copy the files locally or just references to the external files. Valid values are true or false. +- `owners` (List of String) List of Owners for authz_ownership. +- `proxy` (String) Proxy to use for downloading the repo. This argument does not work on older versions of Cobbler. +- `rpm_list` (List of String) List of specific RPMs to mirror. + +### Read-Only + +- `id` (String) The ID of this resource. diff --git a/docs/resources/snippet.md b/docs/resources/snippet.md index f5a337c..db9b888 100644 --- a/docs/resources/snippet.md +++ b/docs/resources/snippet.md @@ -24,11 +24,9 @@ resource "cobbler_snippet" "my_snippet" { ### Required -- **body** (String) The body of the snippet. May also point to a file: `body = file("my_snippet")`. -- **name** (String) The name of the snippet. This must be the name only, so without `/var/lib/cobbler/snippets`. - -### Optional - -- **id** (String) The ID of this resource. +- `body` (String) The body of the snippet. May also point to a file: `body = file("my_snippet")`. +- `name` (String) The name of the snippet. This must be the name only, so without `/var/lib/cobbler/snippets`. +### Read-Only +- `id` (String) The ID of this resource. diff --git a/docs/resources/system.md b/docs/resources/system.md index d7c8231..091d24e 100644 --- a/docs/resources/system.md +++ b/docs/resources/system.md @@ -42,78 +42,80 @@ resource "cobbler_system" "my_system" { ### Required -- **name** (String) The name of the system. -- **profile** (String) Parent profile. +- `name` (String) The name of the system. +- `profile` (String) Parent profile. ### Optional -- **autoinstall** (String) Template remote kickstarts or preseeds. -- **autoinstall_meta** (String) Automatic installation template metadata, formerly Kickstart metadata. -- **boot_files** (String) Files copied into tftpboot beyond the kernel/initrd. -- **comment** (String) Free form text description. -- **enable_gpxe** (Boolean) Use gPXE instead of PXELINUX for advanced booting options. -- **fetchable_files** (String) Templates for tftp or wget. -- **gateway** (String) Network gateway. -- **hostname** (String) Hostname of the system. -- **id** (String) The ID of this resource. -- **image** (String) Parent image (if no profile is used). -- **interface** (Block Set) The `interface` Block Set. (see [below for nested schema](#nestedblock--interface)) -- **ipv6_default_device** (String) IPv6 default device. -- **kernel_options** (String) Kernel options. ex: `selinux=permissive`. -- **kernel_options_post** (String) Kernel options (post install). -- **mgmt_classes** (List of String) For external configuration management. -- **mgmt_parameters** (String) Parameters which will be handed to your management application (Must be a valid YAML dictionary). -- **name_servers** (List of String) Name servers. -- **name_servers_search** (List of String) Name server search settings. -- **netboot_enabled** (Boolean) (Re)install this machine at next boot. -- **next_server_v4** (String) The next_server_v4 option is used for DHCP/PXE as the IP of the TFTP server from which network boot files are downloaded. Usually, this will be the same IP as the server setting. -- **next_server_v6** (String) The next_server_v6 option is used for DHCP/PXE as the IP of the TFTP server from which network boot files are downloaded. Usually, this will be the same IP as the server setting. -- **owners** (List of String) Owners list for authz_ownership. -- **power_address** (String) Power management address. -- **power_id** (String) Usually a plug number or blade name if power type requires it. -- **power_pass** (String) Power management password. -- **power_type** (String) Power management type. -- **power_user** (String) Power management user. -- **proxy** (String) Proxy URL. -- **status** (String) System status (development, testing, acceptance, production). -- **template_files** (String) File mappings for built-in config management. -- **virt_auto_boot** (String) Auto boot virtual machines. -- **virt_cpus** (String) The number of virtual CPUs -- **virt_disk_driver** (String) The virtual machine disk driver. -- **virt_file_size** (String) The virtual machine file size. -- **virt_path** (String) The virtual machine path. -- **virt_pxe_boot** (Number) Use PXE to build this virtual machine. -- **virt_ram** (String) The amount of RAM for the virtual machine. -- **virt_type** (String) The type of virtual machine. Valid options are: xenpv, xenfv, qemu, kvm, vmware, openvz. +- `autoinstall` (String) Template remote kickstarts or preseeds. +- `autoinstall_meta` (List of String) Automatic installation template metadata, formerly Kickstart metadata. +- `boot_files` (String) Files copied into tftpboot beyond the kernel/initrd. +- `boot_loaders` (List of String) Must be either `grub`, `pxe`, or `ipxe`. +- `comment` (String) Free form text description. +- `enable_gpxe` (Boolean) Use gPXE instead of PXELINUX for advanced booting options. +- `fetchable_files` (List of String) Templates for tftp or wget. +- `gateway` (String) Network gateway. +- `hostname` (String) Hostname of the system. +- `image` (String) Parent image (if no profile is used). +- `interface` (Block Set) The `interface` Block Set. (see [below for nested schema](#nestedblock--interface)) +- `ipv6_default_device` (String) IPv6 default device. +- `kernel_options` (List of String) Kernel options. ex: `selinux=permissive`. +- `kernel_options_post` (List of String) Kernel options (post install). +- `mgmt_classes` (List of String) For external configuration management. +- `mgmt_parameters` (String) Parameters which will be handed to your management application (Must be a valid YAML dictionary). +- `name_servers` (List of String) Name servers. +- `name_servers_search` (List of String) Name server search settings. +- `netboot_enabled` (Boolean) (Re)install this machine at next boot. +- `next_server_v4` (String) The next_server_v4 option is used for DHCP/PXE as the IP of the TFTP server from which network boot files are downloaded. Usually, this will be the same IP as the server setting. +- `next_server_v6` (String) The next_server_v6 option is used for DHCP/PXE as the IP of the TFTP server from which network boot files are downloaded. Usually, this will be the same IP as the server setting. +- `owners` (List of String) Owners list for authz_ownership. +- `power_address` (String) Power management address. +- `power_id` (String) Usually a plug number or blade name if power type requires it. +- `power_pass` (String) Power management password. +- `power_type` (String) Power management type. +- `power_user` (String) Power management user. +- `proxy` (String) Proxy URL. +- `status` (String) System status (development, testing, acceptance, production). +- `template_files` (List of String) File mappings for built-in config management. +- `virt_auto_boot` (String) Auto boot virtual machines. +- `virt_cpus` (String) The number of virtual CPUs +- `virt_disk_driver` (String) The virtual machine disk driver. +- `virt_file_size` (String) The virtual machine file size. +- `virt_path` (String) The virtual machine path. +- `virt_pxe_boot` (Number) Use PXE to build this virtual machine. +- `virt_ram` (String) The amount of RAM for the virtual machine. +- `virt_type` (String) The type of virtual machine. Valid options are: xenpv, xenfv, qemu, kvm, vmware, openvz. + +### Read-Only + +- `id` (String) The ID of this resource. ### Nested Schema for `interface` Required: -- **name** (String) The device name of the interface. ex: `eth0`. +- `name` (String) The device name of the interface. ex: `eth0`. Optional: -- **bonding_opts** (String) Options for bonded interfaces. -- **bridge_opts** (String) Options for bridge interfaces. -- **cnames** (List of String) Canonical name records. -- **dhcp_tag** (String) DHCP tag. -- **dns_name** (String) DNS name. -- **gateway** (String) Per-interface gateway. -- **interface_master** (String) The master interface when slave. -- **interface_type** (String) The type of interface: na, master, slave, bond, bond_slave, bridge, bridge_slave, bonded_bridge_slave, infiniband, bmc. Defaults to na. -- **ip_address** (String) The IP address of the interface. -- **ipv6_address** (String) The IPv6 address of the interface. -- **ipv6_default_gateway** (String) The default gateawy for the IPv6 address / interface. -- **ipv6_mtu** (String) The MTU of the IPv6 address. -- **ipv6_secondaries** (List of String) IPv6 secondaries. -- **ipv6_static_routes** (List of String) Static routes for the IPv6 interface. -- **mac_address** (String) The MAC address of the interface. -- **management** (Boolean) Whether this interface is a management interface. -- **netmask** (String) The IPv4 netmask of the interface. -- **static** (Boolean) Whether the interface should be static or DHCP. -- **static_routes** (List of String) Static routes for the interface. -- **virt_bridge** (String) The virtual bridge to attach to. - - +- `bonding_opts` (String) Options for bonded interfaces. +- `bridge_opts` (String) Options for bridge interfaces. +- `cnames` (List of String) Canonical name records. +- `dhcp_tag` (String) DHCP tag. +- `dns_name` (String) DNS name. +- `gateway` (String) Per-interface gateway. +- `interface_master` (String) The master interface when slave. +- `interface_type` (String) The type of interface: NA, master, slave, bond, bond_slave, bridge, bridge_slave, bonded_bridge_slave, infiniband, bmc +- `ip_address` (String) The IP address of the interface. +- `ipv6_address` (String) The IPv6 address of the interface. +- `ipv6_default_gateway` (String) The default gateawy for the IPv6 address / interface. +- `ipv6_mtu` (String) The MTU of the IPv6 address. +- `ipv6_secondaries` (List of String) IPv6 secondaries. +- `ipv6_static_routes` (List of String) Static routes for the IPv6 interface. +- `mac_address` (String) The MAC address of the interface. +- `management` (Boolean) Whether this interface is a management interface. +- `netmask` (String) The IPv4 netmask of the interface. +- `static` (Boolean) Whether the interface should be static or DHCP. +- `static_routes` (List of String) Static routes for the interface. +- `virt_bridge` (String) The virtual bridge to attach to. diff --git a/docs/resources/template_file.md b/docs/resources/template_file.md index 46f300d..1de56c0 100644 --- a/docs/resources/template_file.md +++ b/docs/resources/template_file.md @@ -24,11 +24,9 @@ resource "cobbler_template_file" "my_template" { ### Required -- **body** (String) The body of the template file. May also point to a file: `body = file("my_template.ks")`. -- **name** (String) The name of the template file. This must be the name only, so without `/var/lib/cobbler/templates`. - -### Optional - -- **id** (String) The ID of this resource. +- `body` (String) The body of the template file. May also point to a file: `body = file("my_template.ks")`. +- `name` (String) The name of the template file. This must be the name only, so without `/var/lib/cobbler/templates`. +### Read-Only +- `id` (String) The ID of this resource.