https://github.com/F5Networks/tf-bigip-version0.12
Terraform resources that can configure F5 BIGIP products
https://github.com/F5Networks/tf-bigip-version0.12
Last synced: 5 months ago
JSON representation
Terraform resources that can configure F5 BIGIP products
- Host: GitHub
- URL: https://github.com/F5Networks/tf-bigip-version0.12
- Owner: F5Networks
- License: mpl-2.0
- Created: 2019-08-08T09:19:56.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2020-08-25T15:25:57.000Z (almost 6 years ago)
- Last Synced: 2025-03-27T08:11:26.935Z (about 1 year ago)
- Language: Go
- Size: 77.2 MB
- Stars: 18
- Watchers: 11
- Forks: 11
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# This Repo is deprecated repo: Updated BIGIP Provider Link: https://github.com/F5Networks/terraform-provider-bigip
[//]: # (Original work from https://github.com/DealerDotCom/terraform-provider-bigip)
[//]: # (Modifications Copyright 2019 F5 Networks Inc.)
[//]: # (This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0.)
[//]: # (If a copy of the MPL was not distributed with this file,You can obtain one at https://mozilla.org/MPL/2.0/.)
# Overview
A [Terraform](terraform.io) provider for F5 BigIP LTM.
[](https://travis-ci.org/f5devcentral/terraform-provider-bigip)
[](https://goreportcard.com/report/github.com/f5devcentral/terraform-provider-bigip)
[](https://github.com/f5devcentral/terraform-provider-bigip/blob/master/LICENSE)
[](https://gitter.im/hashicorp-terraform/Lobby)
# Requirements
- [Terraform](https://www.terraform.io/downloads.html) 0.11.x / 0.12.x
- [Go](https://golang.org/doc/install) 1.11 (to build the provider plugin)
# F5 BigIP LTM requirements
- This provider uses the iControlREST API, make sure that it is installed and enabled on your F5 device before proceeding.
These BIG-IP versions are supported in these Terraform versions.
| BIG-IP version |Terraform 0.12 | Terraform 0.11 |
|-----------------|---------------|-----------------|
| BIG-IP 14.x | X | X |
| BIG-IP 12.x | X | X |
| BIG-IP 13.x | X | X |
# Documentation
Documentation for the F5 BIG-IP terraform integration is available at https://clouddocs.f5.com/products/orchestration/terraform/latest/
Terraform provider documentation is available at https://www.terraform.io/docs/providers/bigip/index.html
# Building the Provider
Clone repository to: $GOPATH/src/github.com/terraform-providers/terraform-provider-bigip
```
$ mkdir -p $GOPATH/src/github.com/terraform-providers; cd $GOPATH/src/github.com/terraform-providers
$ git clone https://github.com/terraform-providers/terraform-provider-bigip.git
```
Enter the provider directory and build the provider
```
$ cd $GOPATH/src/github.com/terraform-providers/terraform-provider-bigip
$ make build
```
# Using the Provider
If you're building the provider, follow the instructions to install it as a plugin. After placing it into your plugins directory, run terraform init to initialize it.
# Developing the Provider
If you wish to work on the provider, you'll first need Go installed on your machine (version 1.11+ is required). You'll also need to correctly setup a GOPATH, as well as adding $GOPATH/bin to your $PATH.
To compile the provider, run make build. This will build the provider and put the provider binary in the $GOPATH/bin directory.
```
$ make build
...
$ $GOPATH/bin/terraform-provider-bigip
...
```
# Testing
Running the acceptance test suite requires an F5 to test against. Set `BIGIP_HOST`, `BIGIP_USER`
and `BIGIP_PASSWORD` to a device to run the tests against. By default tests will use the `Common`
partition for creating objects. You can change the partition by setting `BIGIP_TEST_PARTITION`.
```
BIGIP_HOST=f5.mycompany.com BIGIP_USER=foo BIGIP_PASSWORD=secret make testacc
```
Read [here](https://github.com/hashicorp/terraform/blob/master/.github/CONTRIBUTING.md#running-an-acceptance-test) for
more information about acceptance testing in Terraform.
# Community Help
We encourage you to use our [Slack channel](https://f5cloudsolutions.herokuapp.com) for discussion and assistance on Terraform Resources (click the **terraform** channel). There are F5 employees who are members of this community who typically monitor the channel Monday-Friday 9-5 PST and will offer best-effort assistance. This slack channel community support should **not** be considered a substitute for F5 Technical Support. See the [Slack Channel Statement](slack-channel-statement.md) for guidelines on using this channel.