Skip to content

Name Server Group for authoritative zones

ppwarwick edited this page Aug 29, 2017 · 6 revisions

The infoblox_ns_group_auth resource may be used to manage Name Server Groups for authoritative zones.

NOTE: resource is pending a fix and hasn't been merged into master yet

Example template

This is an example of one possible configuration. It would be useful when creating a secondary zone.

resource "infoblox_ns_group_auth" “example” {
    name = “example-ns-group”
    comment = “Example Name Server Group“
    grid_default_group = false
    use_external_primary = true
    external_primaries = [
        {
            address = “10.0.0.2”
            name = “ns1.example.com”
            stealth = false
            tsig_key = "dFghJkcXb5tyUio3eWo021=="
            tsig_key_alg = "HMAC-SHA256"
            tsig_key_name = “example-key“
            use_tsig_key_name = true
        },
    ]
    grid_secondaries = [
        {
            lead = false
            name = “ns2.example.com”
            enablepreferredprimaries = false
            stealth = false
        },
        {
            lead = false
            name = “ns3.example.com”
            enablepreferredprimaries = false
            stealth = false
        },
    ]
}

Argument Reference

The following arguments are supported:

  • name - (Required, Default: none) - (String) - The name of the name server group.
  • comment - (Optional, Default: empty) - (String) - Comment field.
  • grid_default_group - (Optional, Default: false) - (Boolean) - Determines whether or not this group is the grid default name server group. When this attribute is set, the existing default group will cease to be the default. Prior to deleting the default name server group another name server group must be set to the default name server group.
  • use_external_primary - (Optional, Default: false) - (Boolean) - This flag controls whether the group is using an external primary.
  • external_primaries - (Optional, Default: empty) - (External Server array) - A list of external primary servers. See 'External server array' below for attributes which can be set.
  • external_secondaries - (Optional, Default: empty) - (External Server array) - A list of external secondary servers. See 'External server array' below for attributes which can be set.
  • grid_primary - (Optional, Default: empty) - (Grid Member array) - The grid primary servers for this group. See 'Grid Member array' below for attributes which can be set.
  • grid_secondaries - (Optional, Default: empty) - (Grid Member array) - The list with Grid members which are secondary servers for this group. See 'Grid Member array' below for attributes which can be set.

External Server Array attributes

  • address - (Required, Default: none) - (String) - The IP address of the external server.
  • name - (Required, Default: none) - (String) - A resolvable domain name for the external DNS server.
  • stealth - (Optional, Default: false) - (Boolean) - Set this flag to hide the NS record for the primary name server from DNS queries.
  • tsig_key - (Optional, Default: empty) - (String) - A generated TSIG key.
  • tsig_key_alg - (Optional, Default: none) - (String) - The TSIG key algorithm. Either HMAC-MD5 or HMAC-SHA256.
  • tsig_key_name - (Optional, Default: empty) - (String) - The name of the TSIG key.
  • use_tsig_key_name - (Optional, Default: false) - (Boolean) - Use flag for the tsig_key_name.

Grid Member attributes

  • enable_preferred_primaries - (Optional, Default: false) - (Boolean) - This flag represents whether the preferred_primaries field attribute of this member is used.
  • grid_replicate - (Optional, Default: false) - (Boolean) - The flag represents DNS zone transfers if set to True, and ID Grid Replication if set to False. This flag is ignored if the struct is specified as part of a stub zone or if it is set as grid_member in an authoritative zone.
  • lead - (Optional, Default: false) - (Boolean) - This flag controls whether the Grid lead secondary server performs zone transfers to non lead secondaries. This flag is ignored if the struct is specified as grid_member in an authoritative zone.
  • name - (Required, Default: none) - (String) - The grid member name.
  • stealth - (Optional, Default: false) - (Boolean) - This flag governs whether the specified Grid member is in stealth mode or not. If set to True, the member is in stealth mode.
  • preferred_primaries - (Optional, Default: none) - (External Server Array) - The primary preference list with Grid member names and/or External Server structs for this member. See 'External server array' above for attributes which can be set.