-
Notifications
You must be signed in to change notification settings - Fork 4.7k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge branch 'master' into feature/virtual-network-gateway
# Conflicts: # azurerm/provider.go # azurerm/resource_arm_subnet.go # azurerm/validators.go
- Loading branch information
Showing
495 changed files
with
81,850 additions
and
12,705 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,50 +1,88 @@ | ||
Terraform Provider | ||
AzureRM Terraform Provider | ||
================== | ||
|
||
- Website: https://www.terraform.io | ||
- [![Gitter chat](https://badges.gitter.im/hashicorp-terraform/Lobby.png)](https://gitter.im/hashicorp-terraform/Lobby) | ||
- Mailing list: [Google Groups](http://groups.google.com/group/terraform-tool) | ||
|
||
<img src="https://cdn.rawgit.com/hashicorp/terraform-website/master/source/assets/images/logo-text.svg" width="600px"> | ||
|
||
Requirements | ||
------------ | ||
|
||
- [Terraform](https://www.terraform.io/downloads.html) 0.10.x | ||
- [Go](https://golang.org/doc/install) 1.8 (to build the provider plugin) | ||
- [Go](https://golang.org/doc/install) 1.9 (to build the provider plugin) | ||
|
||
Building The Provider | ||
--------------------- | ||
|
||
Clone repository to: `$GOPATH/src/github.com/terraform-providers/terraform-provider-$PROVIDER_NAME` | ||
Clone repository to: `$GOPATH/src/github.com/terraform-providers/terraform-provider-azurerm` | ||
|
||
```sh | ||
$ mkdir -p $GOPATH/src/github.com/terraform-providers; cd $GOPATH/src/github.com/terraform-providers | ||
$ git clone [email protected]:hashicorp/terraform-provider-$PROVIDER_NAME | ||
$ git clone [email protected]:terraform-providers/terraform-provider-azurerm | ||
``` | ||
|
||
Enter the provider directory and build the provider | ||
|
||
```sh | ||
$ cd $GOPATH/src/github.com/terraform-providers/terraform-provider-$PROVIDER_NAME | ||
$ cd $GOPATH/src/github.com/terraform-providers/terraform-provider-azurerm | ||
$ make build | ||
``` | ||
|
||
Using the provider | ||
---------------------- | ||
## Fill in for each provider | ||
|
||
``` | ||
# Configure the Microsoft Azure Provider | ||
provider "azurerm" { | ||
subscription_id = "..." | ||
client_id = "..." | ||
client_secret = "..." | ||
tenant_id = "..." | ||
} | ||
# Create a resource group | ||
resource "azurerm_resource_group" "production" { | ||
name = "production" | ||
location = "West US" | ||
} | ||
# Create a virtual network in the web_servers resource group | ||
resource "azurerm_virtual_network" "network" { | ||
name = "productionNetwork" | ||
address_space = ["10.0.0.0/16"] | ||
location = "West US" | ||
resource_group_name = "${azurerm_resource_group.production.name}" | ||
subnet { | ||
name = "subnet1" | ||
address_prefix = "10.0.1.0/24" | ||
} | ||
subnet { | ||
name = "subnet2" | ||
address_prefix = "10.0.2.0/24" | ||
} | ||
subnet { | ||
name = "subnet3" | ||
address_prefix = "10.0.3.0/24" | ||
} | ||
} | ||
``` | ||
|
||
Further [usage documentation is available on the Terraform website](https://www.terraform.io/docs/providers/azurerm/index.html). | ||
|
||
Developing the Provider | ||
--------------------------- | ||
|
||
If you wish to work on the provider, you'll first need [Go](http://www.golang.org) installed on your machine (version 1.8+ is *required*). You'll also need to correctly setup a [GOPATH](http://golang.org/doc/code.html#GOPATH), as well as adding `$GOPATH/bin` to your `$PATH`. | ||
If you wish to work on the provider, you'll first need [Go](http://www.golang.org) installed on your machine (version 1.9+ is *required*). You'll also need to correctly setup a [GOPATH](http://golang.org/doc/code.html#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. | ||
|
||
```sh | ||
$ make build | ||
... | ||
$ $GOPATH/bin/terraform-provider-$PROVIDER_NAME | ||
$ $GOPATH/bin/terraform-provider-azurerm | ||
... | ||
``` | ||
|
||
|
Oops, something went wrong.