Giter Club home page Giter Club logo

terraform-provider-infoblox's Introduction

Terraform Infoblox Provider

Build status

The Infoblox provider is used to interact with the resources supported by Infoblox. The provider needs to be configured with the proper credentials before it can be used.

Download

Download builds for Darwin, Linux and Windows from the releases page.

Example Usage

# Configure the Infoblox provider
provider "infoblox" {
    username = "${var.infoblox_username}"
    password = "${var.infoblox_password}"
    host  = "${var.infoblox_host}"
    sslverify = "${var.infoblox_sslverify}"
    usecookies = "${var.infoblox_usecookies}"
}

# Create a record
resource "infoblox_record_a" "www" {
    ...
}

Argument Reference

The following arguments are supported:

  • username - (Required) The Infoblox username. It must be provided, but it can also be sourced from the INFOBLOX_USERNAME environment variable.
  • password - (Required) The password associated with the username. It must be provided, but it can also be sourced from the INFOBLOX_PASSWORD environment variable.
  • host - (Required) The base url for the Infoblox REST API, but it can also be sourced from the INFOBLOX_HOST environment variable.
  • sslverify - (Required) Enable ssl for the REST api, but it can also be sourced from the INFOBLOX_SSLVERIFY environment variable.
  • usecookies - (Optional) Use cookies to connect to the REST API, but it can also be sourced from the INFOBLOX_USECOOKIES environment variable

infoblox_record_host

Provides an Infoblox Host record resource.

Example Usage

resource "infoblox_record_host" "host" {
  name              = "terraformhost.platform.test-aib.pri"
  configure_for_dns = false

  ipv4addr {
    address = "10.89.130.30"
  }

  ipv4addr {
    address            = "10.89.130.31"
    configure_for_dhcp = true
    mac                = "01-23-45-67-89-10"
  }
}

Argument Reference

  • name - (Required) The name of the record
  • ipv4addr - (Required) An IPv4 address object. At least one iv4addr or ipv6addr must be specified. See ipv4addr options below.
  • ipv6addr - (Required) An IPv6 address object. At least one iv4addr or ipv6addr must be specified. See ipv6addr options below.
  • configure_for_dns - (Boolean, Optional) Specify whether DNS should be configured for the record; defaults to false
  • comment - (Optional) The comment for the record
  • ttl - (Integer, Optional) The TTL of the record
  • view - (Optional) The view of the record

Ipv4 options

  • address - (Required) The IPv4 address of the object
  • configure_for_dhcp - (Boolean, Optional) Specifies whether the IPv4 address object should be configured for DHCP
  • mac - (Optional) The MAC address of the resource

Ipv6 options

  • address - (Required) The IPv6 address of the object
  • configure_for_dhcp - (Boolean, Optional) Specifies whether the IPv4 address object should be configured for DHCP
  • mac - (Optional) The MAC address of the resource

infoblox_record_a

Provides an Infoblox A record resource.

Example Usage

resource "infoblox_record_a" "web" {
  address = "10.1.2.3"
  name    = "some.fqdn.lan"

  comment = "ipv4 address for Acme web server"
  ttl     = 3600
  view    = "default"
}

Argument Reference

The following arguments are supported:

  • address - (Required) The IPv4 address of the record
  • name - (Required) The FQDN of the record
  • comment - (Optional) The comment for the record
  • ttl - (Integer, Optional) The TTL of the record
  • view - (Optional) The view of the record

infoblox_record_aaaa

Provides an Infoblox AAAA record resource.

Example Usage

resource "infoblox_record_aaaa" "web" {
  address = "2001:db8:85a3::8a2e:370:7334"
  name    = "some.fqdn.lan"

  comment = "ipv6 address for Acme web server"
  ttl     = 3600
  view    = "default"
}

Argument Reference

The following arguments are supported:

  • address - (Required) The IPv6 address of the record
  • name - (Required) The FQDN of the record
  • comment - (Optional) The comment for the record
  • ttl - (Integer, Optional) The TTL of the record
  • view - (Optional) The view of the record

infoblox_record_cname

Provides an Infoblox CNAME record resource.

Example Usage

resource "infoblox_record_cname" "www" {
  canonical = "fqdn.lan"
  name      = "www.fqdn.lan"

  comment = "ipv6 address for Acme web server"
  ttl     = 3600
  view    = "www.fqdn.lan is an alias for fqdn.lan"
}

Argument Reference

The following arguments are supported:

  • canonical - (Required) The canonical address to point to
  • name - (Required) The FQDN of the alias
  • comment - (Optional) The comment for the record
  • ttl - (Integer, Optional) The TTL of the record
  • view - (Optional) The view of the record

infoblox_record_ptr

Provides an Infoblox PTR record resource.

Example Usage

resource "infoblox_record_ptr" "ptr" {
  ptrdname = "some.fqdn.lan"
  address  = "10.0.0.10.in-addr.arpa"

  comment = "Reverse lookup for some.fqdn.lan"
  ttl     = 3600
  view    = "default"
}

Argument Reference

The following arguments are supported:

  • ptrdname - (Required) The
  • address - (Required, conflicts with name) This field is required if you do not use the name field. Either the IP address or name is required. Example: 10.0.0.11. If the PTR record belongs to a forward-mapping zone, this field is empty. Accepts both IPv4 and IPv6 addresses.
  • name - (Required, conflicts with address) This field is required if you do not use the address field. Either the IP address or name is required. Example: 10.0.0.10.in.addr.arpa
  • comment - (Optional) The comment for the record
  • ttl - (Integer, Optional) The TTL of the record
  • view - (Optional) The view of the record

infoblox_record_txt

Provides an Infoblox TXT record resource.

Example Usage

resource "infoblox_record_txt" "txt" {
  name = "some.fqdn.lan"
  text = "Welcome to the Jungle"
}

Argument Reference

The following arguments are supported:

  • name - (Required) The name of the TXT record
  • text - (Required) The text of the TXT record
  • comment - (Optional) The comment for the record
  • ttl - (Integer, Optional) The TTL of the record
  • view - (Optional) The view of the record

infoblox_record_srv

Provides an Infoblox SRV record resource.

Example Usage

resource "infoblox_record_srv" "srv" {
  name = "bind_srv.domain.com"
  port = 1234
  priority = 1
  weight = 1
  target = "old.target.test.org"
}

Argument Reference

The following arguments are supported:

  • name - (Required) The name of the record
  • port - (Integer, Required) The port of the SRV record
  • priority - (Integer, Required) The priority of the SRV record
  • weight - (Integer, Required) The weight of the SRV record
  • target - (Required) The target of the SRV record
  • comment - (Optional) The comment for the record
  • ttl - (Integer, Optional) The TTL of the record
  • view - (Optional) The view of the record

infoblox_ip

Queries the next available IP address from a network and returns it in a computed variable that can be used by the infoblox_record resource.

Example Usage

# Acquire the next available IP from a network CIDR
# it will create a variable called "ipaddress"
resource "infoblox_ip" "ip" {
  cidr = "10.0.0.0/24"
}

resource "infoblox_record_a" "web" {
  address = "${infoblox_ip.ip.ipaddress}"
  name    = "some.fqdn.lan"

  comment = "ipv4 address for Acme web server"
  ttl     = 3600
  view    = "default"
}

# Exclude specific IP addresses when acquiring next
# avaiable IP from a network CIDR
resource "infoblox_ip" "excludedIPAddress" {
  cidr = "10.0.0.0/24"

  exclude = [
    "10.0.0.1",
    "10.0.0.2"
    # etc.
  ]
}

# Acquire free IP address from within a specific
# range of addresses
resource "infoblox_ip" "ipAddressFromRange" {
  ip_range = "10.0.0.20-10.0.0.60"
}

Argument Reference

The following arguments are supported:

  • cidr - (Required) The network to search for - example 10.0.0.0/24. Cannot be specified with ip_range
  • exclude - (Optional) A list of IP addresses to exclude
  • ip_range - (Required) The IP range to search within - example 10.0.0.20-10.0.0.40. Cannot be specified with cidr

Deprecated Resources

The following resources are deprecated and will no longer see active development. It is recommended you use the dedicated infoblox_record_* resources instead.

infoblox_record

Provides a Infoblox record resource.

Example Usage

# Add a record to the domain
resource "infoblox_record" "foobar" {
  value = "192.168.0.10"
  name = "terraform"
  domain = "mydomain.com"
  type = "A"
  ttl = 3600
}

Argument Reference

See related part of Infoblox Docs for details about valid values.

The following arguments are supported:

  • domain - (Required) The domain to add the record to
  • value - (Required) The value of the record; its usage will depend on the type (see below)
  • name - (Required) The name of the record
  • ttl - (Integer, Optional) The TTL of the record
  • type - (Required) The type of the record
  • comment - (Optional) The comment of the record

DNS Record Types

The type of record being created affects the interpretation of the value argument.

A Record

  • value is the IPv4 address

CNAME Record

  • value is the alias name

AAAA Record

  • value is the IPv6 address

Attributes Reference

The following attributes are exported:

  • domain - The domain of the record
  • value - The value of the record
  • name - The name of the record
  • type - The type of the record
  • ttl - The TTL of the record

terraform-provider-infoblox's People

Contributors

prudhvitella avatar jackbracken avatar jrandall avatar mifrost avatar robcannon avatar fmosti-aib avatar dn1s avatar golint-fixer avatar

Watchers

Can Hanhan avatar James Cloos avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.