aboutsummaryrefslogtreecommitdiffhomepage
path: root/website/docs/index.html.markdown
diff options
context:
space:
mode:
authoralexandreFre <51956137+alexandreFre@users.noreply.github.com>2019-07-04 14:32:15 +0200
committerGitHub <noreply@github.com>2019-07-04 14:32:15 +0200
commit80e82d1365343acdd54bca9e1c94dfe03b913600 (patch)
treea87cc028eda54bd95b248296e331c71a4ad74241 /website/docs/index.html.markdown
parent4509938b5f377136215645157376bf75e3980418 (diff)
parenta1f9b9a1c1a80ee4db8de66fe1b771fe8e28cd05 (diff)
downloadterraform-provider-mailgun-80e82d1365343acdd54bca9e1c94dfe03b913600.tar.gz
terraform-provider-mailgun-80e82d1365343acdd54bca9e1c94dfe03b913600.tar.zst
terraform-provider-mailgun-80e82d1365343acdd54bca9e1c94dfe03b913600.zip
Merge pull request #6 from alexandreFre/add_doc
Add doc
Diffstat (limited to 'website/docs/index.html.markdown')
-rw-r--r--website/docs/index.html.markdown63
1 files changed, 63 insertions, 0 deletions
diff --git a/website/docs/index.html.markdown b/website/docs/index.html.markdown
new file mode 100644
index 0000000..fbdd1ba
--- /dev/null
+++ b/website/docs/index.html.markdown
@@ -0,0 +1,63 @@
1---
2layout: "mailgun"
3page_title: "Provider: Mailgun"
4sidebar_current: "docs-mailgun-index"
5description: |-
6 The Mailgun provider configures domains and routes in Mailgun.
7---
8
9# Mailgun Provider
10
11The Mailgun provider allows Terraform to create and configure domains and routes in [Mailgun](https://www.mailgun.com/).
12
13The provider configuration block accepts the following arguments:
14
15* ``domain`` - (Required) The domain name for the ressources created with the provider. May alternatively be set via the
16 ``MAILGUN_DOMAIN`` environment variable.
17
18* ``apikey`` - (Required) The API auth token to use when making requests. May alternatively
19 be set via the ``MAILGUN_APIKEY`` environment variable.
20
21Use the navigation to the left to read about the available resources.
22
23## Example Usage
24
25```hcl
26provider "mailgun" {
27 domain = "domain.com"
28 apikey = "15ee99178cc7q6325df7ff8a15211228-2f778ta3-e04c2946"
29}
30
31resource "mailgun_domain" "example" {
32 name="domain.com"
33 spam_action="block"
34 smtp_password="password"
35 wildcard=true
36 force_dkim_authority=true
37 dkim_key_size=1024
38 ips=["192.161.0.1", "192.168.0.2"]
39 credentials{
40 login="login"
41 password="password"
42 }
43 open_tracking_settings_active=true
44 click_tracking_settings_active=true
45 unsubscribe_tracking_settings_active=true
46 unsubscribe_tracking_settings_html_footer="<p>footer</p>"
47 unsubscribe_tracking_settings_text_footer="footer"
48 require_tls=true
49 skip_verification=true
50}
51
52resource "mailgun_route" "example" {
53 depends_on = [mailgun_domain.example]
54 priority=5
55 description="description"
56 expression="match_recipient(\".*@samples.mailgun.org\")"
57 actions=[
58 "forward(\"http://myhost.com/messages/\")",
59 "stop()"
60 ]
61}
62
63```