Use the built-in alert helpers
This commit is contained in:
parent
073a0f76c5
commit
9ac9ab6706
|
@ -15,13 +15,11 @@ generate plans, refresh state, and more. This page documents
|
||||||
the details of what are contained in this graph, what types
|
the details of what are contained in this graph, what types
|
||||||
of nodes there are, and how the edges of the graph are determined.
|
of nodes there are, and how the edges of the graph are determined.
|
||||||
|
|
||||||
<div class="alert alert-block alert-warning">
|
~> **Advanced Topic!** This page covers technical details
|
||||||
<strong>Advanced Topic!</strong> This page covers technical details
|
|
||||||
of Terraform. You don't need to understand these details to
|
of Terraform. You don't need to understand these details to
|
||||||
effectively use Terraform. The details are documented here for
|
effectively use Terraform. The details are documented here for
|
||||||
those who wish to learn about them without having to go
|
those who wish to learn about them without having to go
|
||||||
spelunking through the source code.
|
spelunking through the source code.
|
||||||
</div>
|
|
||||||
|
|
||||||
## Graph Nodes
|
## Graph Nodes
|
||||||
|
|
||||||
|
|
|
@ -14,8 +14,6 @@ of this section is to remove any notion of "magic" from Terraform.
|
||||||
We want you to be able to trust and understand what Terraform is
|
We want you to be able to trust and understand what Terraform is
|
||||||
doing to function.
|
doing to function.
|
||||||
|
|
||||||
<div class="alert alert-block alert-info">
|
-> **Note:** Knowledge of Terraform internals is not
|
||||||
<strong>Note:</strong> Knowledge of Terraform internals is not
|
|
||||||
required to use Terraform. If you aren't interested in the internals
|
required to use Terraform. If you aren't interested in the internals
|
||||||
of Terraform, you may safely skip this section.
|
of Terraform, you may safely skip this section.
|
||||||
</div>
|
|
||||||
|
|
|
@ -13,13 +13,11 @@ state machines. Understanding this lifecycle can help better understand
|
||||||
how Terraform generates an execution plan, how it safely executes that
|
how Terraform generates an execution plan, how it safely executes that
|
||||||
plan, and what the resource provider is doing throughout all of this.
|
plan, and what the resource provider is doing throughout all of this.
|
||||||
|
|
||||||
<div class="alert alert-block alert-warning">
|
~> **Advanced Topic!** This page covers technical details
|
||||||
<strong>Advanced Topic!</strong> This page covers technical details
|
|
||||||
of Terraform. You don't need to understand these details to
|
of Terraform. You don't need to understand these details to
|
||||||
effectively use Terraform. The details are documented here for
|
effectively use Terraform. The details are documented here for
|
||||||
those who wish to learn about them without having to go
|
those who wish to learn about them without having to go
|
||||||
spelunking through the source code.
|
spelunking through the source code.
|
||||||
</div>
|
|
||||||
|
|
||||||
## Lifecycle
|
## Lifecycle
|
||||||
|
|
||||||
|
|
|
@ -12,12 +12,10 @@ This page documents the basics of how the plugin system in Terraform
|
||||||
works, and how to setup a basic development environment for plugin development
|
works, and how to setup a basic development environment for plugin development
|
||||||
if you're writing a Terraform plugin.
|
if you're writing a Terraform plugin.
|
||||||
|
|
||||||
<div class="alert alert-block alert-warning">
|
~> **Advanced topic!** Plugin development is a highly advanced
|
||||||
<strong>Advanced topic!</strong> Plugin development is a highly advanced
|
|
||||||
topic in Terraform, and is not required knowledge for day-to-day usage.
|
topic in Terraform, and is not required knowledge for day-to-day usage.
|
||||||
If you don't plan on writing any plugins, we recommend not reading
|
If you don't plan on writing any plugins, we recommend not reading
|
||||||
this section of the documentation.
|
this section of the documentation.
|
||||||
</div>
|
|
||||||
|
|
||||||
## How it Works
|
## How it Works
|
||||||
|
|
||||||
|
@ -70,12 +68,10 @@ Developing a plugin is simple. The only knowledge necessary to write
|
||||||
a plugin is basic command-line skills and basic knowledge of the
|
a plugin is basic command-line skills and basic knowledge of the
|
||||||
[Go programming language](http://golang.org).
|
[Go programming language](http://golang.org).
|
||||||
|
|
||||||
<div class="alert alert-block alert-info">
|
-> **Note:** A common pitfall is not properly setting up a
|
||||||
<strong>Note:</strong> A common pitfall is not properly setting up a
|
|
||||||
<code>$GOPATH</code>. This can lead to strange errors. You can read more about
|
<code>$GOPATH</code>. This can lead to strange errors. You can read more about
|
||||||
this <a href="https://golang.org/doc/code.html">here</a> to familiarize
|
this [here](https://golang.org/doc/code.html) to familiarize
|
||||||
yourself.
|
yourself.
|
||||||
</div>
|
|
||||||
|
|
||||||
Create a new Go project somewhere in your `$GOPATH`. If you're a
|
Create a new Go project somewhere in your `$GOPATH`. If you're a
|
||||||
GitHub user, we recommend creating the project in the directory
|
GitHub user, we recommend creating the project in the directory
|
||||||
|
|
|
@ -18,9 +18,7 @@ to write plugins for Terraform. It does not hold your hand through the
|
||||||
process, however, and expects a relatively high level of understanding
|
process, however, and expects a relatively high level of understanding
|
||||||
of Go, provider semantics, Unix, etc.
|
of Go, provider semantics, Unix, etc.
|
||||||
|
|
||||||
<div class="alert alert-block alert-warning">
|
~> **Advanced topic!** Plugin development is a highly advanced
|
||||||
<strong>Advanced topic!</strong> Plugin development is a highly advanced
|
|
||||||
topic in Terraform, and is not required knowledge for day-to-day usage.
|
topic in Terraform, and is not required knowledge for day-to-day usage.
|
||||||
If you don't plan on writing any plugins, we recommend not reading
|
If you don't plan on writing any plugins, we recommend not reading
|
||||||
this section of the documentation.
|
this section of the documentation.
|
||||||
</div>
|
|
||||||
|
|
|
@ -22,12 +22,10 @@ The primary reasons to care about provider plugins are:
|
||||||
* You want to write a completely new provider for custom, internal
|
* You want to write a completely new provider for custom, internal
|
||||||
systems such as a private inventory management system.
|
systems such as a private inventory management system.
|
||||||
|
|
||||||
<div class="alert alert-block alert-warning">
|
~> **Advanced topic!** Plugin development is a highly advanced
|
||||||
<strong>Advanced topic!</strong> Plugin development is a highly advanced
|
|
||||||
topic in Terraform, and is not required knowledge for day-to-day usage.
|
topic in Terraform, and is not required knowledge for day-to-day usage.
|
||||||
If you don't plan on writing any plugins, we recommend not reading
|
If you don't plan on writing any plugins, we recommend not reading
|
||||||
this section of the documentation.
|
this section of the documentation.
|
||||||
</div>
|
|
||||||
|
|
||||||
If you're interested in provider development, then read on. The remainder
|
If you're interested in provider development, then read on. The remainder
|
||||||
of this page will assume you're familiar with
|
of this page will assume you're familiar with
|
||||||
|
|
|
@ -16,14 +16,10 @@ ask for input of things such as variables and API keys. If you want to
|
||||||
conitnue using the example, you should save those parameters in a
|
conitnue using the example, you should save those parameters in a
|
||||||
"terraform.tfvars" file or in a `provider` config bock.
|
"terraform.tfvars" file or in a `provider` config bock.
|
||||||
|
|
||||||
<div class="alert alert-block alert-warning">
|
~> **Warning!** The examples use real providers that launch _real_ resources.
|
||||||
<div>
|
That means they can cost money to experiment with. To avoid unexpected charges,
|
||||||
<strong>Note:</strong> The examples use real providers that launch
|
be sure to understand the price of resources before launching them, and verify
|
||||||
<em>real</em> resources. That means they can cost money to
|
any unneeded resources are cleaned up afterwards.
|
||||||
experiment with. To avoid unexpected charges, be sure to understand the price
|
|
||||||
of resources before launching them, and verify any unneeded resources
|
|
||||||
are cleaned up afterwards.</div>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
Experimenting in this way can help you learn how the Terraform lifecycle
|
Experimenting in this way can help you learn how the Terraform lifecycle
|
||||||
works, as well as how to repeatedly create and destroy infrastructure.
|
works, as well as how to repeatedly create and destroy infrastructure.
|
||||||
|
|
|
@ -29,16 +29,10 @@ If you already have an AWS account, you may be charged some
|
||||||
amount of money, but it shouldn't be more than a few dollars
|
amount of money, but it shouldn't be more than a few dollars
|
||||||
at most.
|
at most.
|
||||||
|
|
||||||
<div class="alert alert-block alert-warning">
|
~> **Warning!** If you're not using an account that qualifies under the AWS
|
||||||
<p>
|
[free-tier](http://aws.amazon.com/free/), you may be charged to run these
|
||||||
<strong>Note:</strong> If you're not using an account that qualifies
|
examples. The most you should be charged should only be a few dollars, but
|
||||||
under the AWS
|
we're not responsible for any charges that may incur.
|
||||||
<a href="http://aws.amazon.com/free/">free-tier</a>,
|
|
||||||
you may be charged to run these examples. The most you should
|
|
||||||
be charged should only be a few dollars, but we're not responsible
|
|
||||||
for any charges that may incur.
|
|
||||||
</p>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
## Configuration
|
## Configuration
|
||||||
|
|
||||||
|
|
|
@ -21,16 +21,9 @@ This section of the getting started will cover the basics of using modules.
|
||||||
Writing modules is covered in more detail in the
|
Writing modules is covered in more detail in the
|
||||||
[modules documentation](/docs/modules/index.html).
|
[modules documentation](/docs/modules/index.html).
|
||||||
|
|
||||||
<div class="alert alert-block alert-warning">
|
~> **Warning!** The examples on this page are _**not** eligible_ for the AWS
|
||||||
<p>
|
[free-tier](http://aws.amazon.com/free/). Do not execute the examples on this
|
||||||
<strong>Warning:</strong> The examples on this page are
|
page unless you're willing to spend a small amount of money.
|
||||||
<em>not eligible</em> for the
|
|
||||||
AWS
|
|
||||||
<a href="http://aws.amazon.com/free/">free-tier</a>. Do not execute
|
|
||||||
the examples on this page unless you're willing to spend a small
|
|
||||||
amount of money.
|
|
||||||
</p>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
## Using Modules
|
## Using Modules
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue